되돌릴 수 없는 승인 앞에서, 무엇이 바뀌는지 먼저 보여 드립니다.

허락 창은 그대로 두고, 판단할 재료만 더합니다.

설치 한 줄 보기 0.1.2 · 첫 공개 버전은 0.1.0(11월 8일)

OLP(Outcome Lookahead Protocol)는 에이전트의 행동이 낳을 결과를 내다보는 방법을 정한 공개 규격입니다.

0.1.2: Claude Code 훅 — 지우기 직전엔 어떤 파일이 몇 개인지, 덮어쓰기 직전엔 몇 개인지 카드로 보여 줍니다.

사람들은 허락 창의 93%를 그냥 허용합니다

OLP는 판단을 대신하지 않고, 실행 전에 무슨 일이 생기는지와 할 수 있는 다른 방법을 함께 보여 줍니다. (Anthropic, 2026)

지울 파일과 개수를 먼저 봅니다

AI 에이전트가 파일을 지우기 전엔 어떤 파일이 몇 개인지, 덮어쓰기 전엔 몇 개인지 먼저 확인하세요. OLP가 먼저 보여 줍니다. 무료 오픈소스, 초기 버전(0.1.2). 확인 화면(카드)이 뜰 때만, 그 기록이 사용자 PC에 JSONL 한 줄로 남습니다.

선택하는 건 당신입니다

MCP 도구와 셸 명령이 파일·git·데이터베이스를 건드리기 전에, 확인 창에 카드가 먼저 뜹니다.

에이전트가 build 폴더를 지우려 하자, 지울 파일 3개의 이름과 개수를 먼저 알려 줍니다. 할지 말지는 Yes 와 No 중에서 당신이 고릅니다. 연습 폴더에서 실제로 뜬 카드 글자 그대로입니다.

GitHub 저장소 보기

공개된 신고 글 104건을 읽었습니다

AI 에이전트가 직접 한 쓰기 사고 중 87건이 되돌릴 수 없는 삭제·파괴였습니다.

  • 50파일·폴더 지우기
  • 27git 작업 파괴(reset --hard 등)
  • 10데이터베이스 지우기

공개 이슈 표본이고 신고자 주장입니다. 전체 사고 수가 아닙니다.

카드는 이렇게 읽습니다

3 files
지워질 파일이 3개입니다. 이 기기에서 읽기만 해서 센 숫자입니다.
Undo: not confirmed
되돌릴 곳이 확인되지 않았습니다. 선언된 복구 위치가 없다는 뜻입니다.
before engine check · no receipt
엔진 확인 전이고 영수증이 없습니다. 이 버전의 카드는 영수증을 만들지 않습니다.

npx @feedpia/olp install

설치는 이 한 줄입니다.

Windows x64, macOS(Apple 칩, Intel), Linux x64, Linux arm64 에서 됩니다. install 이 Claude Code 설정 파일에 훅 줄을 넣어 줍니다.

업데이트할 때도 같은 설치 명령을 다시 실행하면 됩니다.

  • 설치한 줄이 훅과 설정 줄을 넣습니다
  • 에이전트가 지우려 함Bash, PowerShell, MCP 도구
  • 훅이 먼저 셈무엇을, 몇 개, 되돌릴 곳이 있는지
  • 말로 고침카드를 보고 ‘2개만 지워 줘’처럼 말하면 됩니다
다른 설치 방법: 묶음 파일 직접 받기와 손 설정

받은 파일의 지문값부터 봅니다

E7548450AC1779113F6076C6572CD45DE8F3C0BE8F4A2666A6863231F1A4B92F

운영체제별 묶음 파일과 지문 목록(SHA256SUMS)은 저장소의 최신 Releases에서 받습니다. 받은 묶음의 지문값은 지문 목록에서 같은 이름 줄의 값과 같아야 합니다. 아래 값은 Windows 묶음(olp-hook-windows-x64.zip)의 지문값입니다. PowerShell 에서 아래 한 줄을 실행하고, 나온 값을 칸에 붙여 넣으세요.

(Get-FileHash .\olp-hook-windows-x64.zip -Algorithm SHA256).Hash

위 값과 한 글자라도 다르면 실행하지 말고 알려 주세요.

지문값이 같으면 묶음을 내려받기 폴더에 풀고, 프로젝트 폴더에서 install 을 실행합니다

~\Downloads\olp-hook.exe install

설정 줄은 install 이 받은 파일의 전체 경로로 적어 줍니다. 묶음을 프로젝트 안에 풀면 저장소에 섞이니 밖에 풉니다. macOS·Linux 에서는 ~/Downloads/olp-hook install 입니다. macOS 에서 브라우저로 받았다면 먼저 xattr -d com.apple.quarantine ~/Downloads/olp-hook 를 실행합니다(아직 서명이 없는 버전이라 막힙니다. curl 로 받았으면 필요 없습니다).

olp-hook 을 PATH 에 넣었거나 소스로 만들었다면 설정에 이 한 줄을 직접 넣어도 됩니다

"hooks": { "PreToolUse": [ { "matcher": "Bash|PowerShell|mcp__.*", "hooks": [ { "type": "command", "command": "olp-hook", "timeout": 10 } ] } ], "PostToolUse": [ { "matcher": "Bash|PowerShell|mcp__.*", "hooks": [ { "type": "command", "command": "olp-hook", "timeout": 10 } ] } ] }

끌 때는 설정에서 olp-hook 줄을 지웁니다.

다음 허락 창부터는 보고 고르세요.

설치는 한 줄입니다.

  • 막 공개한 버전이라 앞으로 기능과 화면이 바뀔 수 있습니다. 명령 한 줄 설치와 직접 받는 실행 파일 모두 Windows x64, macOS(Apple 칩, Intel), Linux x64, Linux arm64 버전이 있습니다.
  • 디지털 서명이 아직 없어서 Windows 가 경고 창을 띄울 수 있습니다. 실행하기 전에 지문값이 같은지 확인하세요.
  • 훅은 기본으로 꺼져 있는 하루 신호 말고는 인터넷에 연결하지 않고, 당신의 파일 내용과 명령 원문을 밖으로 보내지 않습니다.

알아 둘 것

  • 카드는 세기만 합니다. 원래 명령은 절대 실행하지 않습니다.
  • 허락하면 에이전트가 실행하고, No를 선택하면 파일은 그대로 남습니다. 선택하는 건 당신입니다.
  • 당신 기기에서만 돌고, 훅 스스로는 기본으로 꺼져 있는 하루 신호 말고는 네트워크에 연결하지 않습니다.
  • 엔진 확인 전입니다. 이 쪽의 어떤 글도 그 작업을 해도 괜찮다고 보증하지 않습니다.

알려진 한계

  • OLP가 모르는 명령은 읽기만 하는 명령이어도 실행 전에 확인을 묻습니다.
  • 느린 PC에서는 OLP가 PowerShell 명령에 대해 확인을 묻는 일이 더 잦을 수 있습니다. 지우기·덮어쓰기 확인 카드는 평소처럼 나옵니다.
  • OLP가 권한 확인 창에 붙이는 카드는 영어로만 나옵니다.
  • 첫 설치 때 npm이 패키지를 내려받는 동안 터미널에 몇 초 동안 아무것도 나타나지 않을 수 있습니다. 내려받기가 끝나면 OLP가 시작됩니다.