atcher

herdr 안에서 Claude Code · Codex 에이전트를 세우고, 프롬프트 · 키를 전달하고, 상태 변화를 돌려주는 CLI. 판단은 호출한 에이전트 (Claude) 가 한다. atcher 는 생성 · 전달 · 보고 · 정리만.

설치

npm i -g atcher-cli      # 또는 bun add -g atcher-cli. 실행 파일은 atcher
npx atcher-cli --help    # 또는 bunx atcher-cli --help

필요: Node ≥ 20 또는 bun, herdr (atcher 는 herdr pane 안에서 실행한다)

명령

atcher up <layout.json>            구성 생성
atcher send <name> [text]          프롬프트 전달. text 생략 = stdin
atcher next [name...] [--timeout <초>]  자식의 다음 상태 변화
atcher status                      하위 트리 구조 · 상태
atcher read <name> [--lines <N>] [--screen]  출력 읽기
atcher down [name]                 정리
atcher keys <name> <key>...        키 입력

{ "agents": [
  { "name": "r1", "kind": "claude", "cwd": ".worktrees/r1", "group": "runners" },
  { "name": "r2", "kind": "codex", "cwd": ".worktrees/r2", "slot": "right" }
]}

출력: stdout JSON 1개. 실패 = { "error": "<코드>", "message": "…" } + exit 1. 인자 오류 = exit 2 + stderr usage. 상태는 .atcher/ (git 저장소면 main repo 루트, 아니면 cwd) 에 둔다.