unblock

당신의 에이전트가 당신에게서 필요로 하는 모든 것을 위한 하나의 큐.

인간만이 해결할 수 있는 벽에 부딪힌 에이전트 — API 키, 콘솔 클릭, OAuth 권한 부여, 승인 — 는 구조화된 요청을 등록하고 계속 작업하거나 대기합니다. 한 페이지에서 비밀을 포함한 요청들을 일괄 답변하면, 대기 중이던 요청들이 깨어납니다.

에이전트가 무엇을 원했는지 알아내려고 대화 기록을 읽을 일은 없습니다.

존재 이유

에이전트를 위한 모든 human-in-the-loop 도구는 이 문제의 3분의 1만 해결합니다. LangGraph의 interrupt()는 올바른 대기 의미를 갖고 있지만 큐나 UI는 제공하지 않습니다. HumanLayer와 gotoHuman은 구조화된 요청을 갖추고 SaaS를 통해 라우팅합니다. 로컬 MCP 질문 서버는 단일 에이전트, 동기식이며, 답변을 도구 결과로 바로 돌려줍니다 — API 키가 절대 들어가서는 안 되는 바로 그곳입니다.

unblock은 이 세 가지를 함께 결합한 것입니다: 로컬 우선, 모델의 컨텍스트 밖에 남는 비밀, 그리고 머신의 모든 에이전트를 아우르는 하나의 큐.

Related MCP server: Clarify MCP Server

작동 방식

두 가지 호출이 있으며, 그중 하나만 에이전트를 멈춥니다.

바로 그 하나의 제약이 부분 답변을 안전하게 만듭니다. 등록된 요청에 답변하는 것은 어떤 것도 중단시키지 않으므로 어떤 순서로든 답변할 수 있습니다. 대기 중인 요청에 답변하면 에이전트가 깨어나고, 에이전트는 자리를 비운 동안 도착한 등록된 요청에 대한 모든 답변을 수집합니다.

세 가지가 필요한 에이전트는 필드가 세 개인 대기 요청 하나를 선언합니다. 에이전트는 한 곳에서만 멈출 수 있으므로 세 번 대기하지 않습니다.

비밀

폼에 입력된 비밀은 모델의 컨텍스트로 이어지는 채널을 통해 다시 되돌아가지 않습니다. 데몬은 비밀을 저장하고 에이전트에게 참조를 건네줍니다:

op://Private/abc123/credential        # 1Password — masks the value if printed
ub_9cjp4t-stripe_key                  # macOS keychain
$UNBLOCK_STRIPE_KEY                   # env file, 0600

에이전트는 필요한 시점에 참조를 해석하고 절대 출력하지 않습니다. op가 로그인되어 있으면 1Password가 선호됩니다. op run은 하위 프로세스가 값을 출력하더라도 값을 마스킹하기 때문입니다 — 그런 보호 기능을 가진 유일한 백엔드입니다.

설치

npm install -g unblockd         # daemon, MCP server, CLI (binary: unblock)
unblock daemon start

그런 다음 에이전트를 여기에 연결하세요. Claude Code의 경우:

claude mcp add unblock -- npx unblockd mcp

그리고 에이전트가 언제 대기해야 하는지 알 수 있도록 스킬을 설치하세요:

npx skills add aneym/unblock --skill unblock -g

herdr

herdr plugin install aneym/unblock --yes

alt+p u는 unblock 모드를 엽니다: 활성 프로필로 범위가 지정된 전체 큐가 있는 확대된 창으로, 그 자리에서 답변할 수 있습니다. 답변은 해당 창에서 에이전트를 깨웁니다.

플러그인은 또한 herdr가 차단된 것으로 감지했지만 요청을 선언하지 않은 에이전트를 선언된 에이전트들 아래에 나열합니다 — 조용한 멈춤도 여전히 보이도록.

휴대폰에서 답변하기

unblock link는 임시 URL을 생성합니다. 제출하면 소멸하고 타이머에 따라 만료되므로, 주머니 속 오래된 탭이 내일까지 살아 있지 않습니다. 자체 tailnet으로 제공하거나, tailnet이 없으면 빠른 터널을 사용하세요:

tailscale serve --https=8799 127.0.0.1:4488     # tailnet only
cloudflared tunnel --url http://127.0.0.1:4488  # no account

구조

src/schema.js    ask + field validation, the profile rule
src/store.js     SQLite queue, one-park-per-agent, drafts, links
src/secrets.js   1Password -> keychain -> env file
src/daemon.js    HTTP API, the answer page, SSE
src/mcp.js       MCP server: file / park / check / cancel
web/             the answer page
plugin/          herdr plugin
skills/unblock/  the discipline agents follow before parking

npm 의존성이 하나도 없습니다. 큐는 ~/.local/state/unblock/queue.db에 있는 단일 SQLite 파일입니다.

라이선스

MIT