agent-progress 3.4.0

진행 창이 너무 자주 뜨던 문제를 고쳤습니다.

• 진행 창은 요청할 때만 열립니다. 에이전트는 계속 계획을 기록하지만 창을 띄우지 않습니다. 보고 싶을 때 ap open을 하면 그 pane 아래에 열리고, 이후 그 pane의 기록을 계속 따라갑니다. brgr 같은 위임 작업자 pane마다 창이 뜨던 문제도 함께 사라집니다.
• 예전처럼 첫 기록 때 자동으로 열려면 AP_AUTO_OPEN=1을 설정합니다(--no-view로 한 번 건너뛰기).
• 스킬과 Claude Code 지침은 "사용자가 원할 때만 ap open"으로 바뀌었습니다. 업그레이드 후 ap skill install을 다시 실행하면 설치된 문구가 갱신됩니다.
• pane을 확인할 수 없다는 경고는 자동 열기를 켰을 때만 나오고, ap open은 다른 pane에서 보는 방법을 알려줍니다.

검증: 테스트 59개, fmt, Clippy, 재패키징 바이트 일치, 3.3.1 → 3.4.0 업그레이드·롤백 smoke, CI, Herdr에서 기본 동작(기록만, 창 없음)과 ap open 후 따라가기 확인.

agent-progress 3.3.1

버그 수정 릴리즈입니다.

• 한글 등 계획 이름 충돌 수정: ap --plan 가나와 ap --plan 다라가 같은 파일(__.json)을 쓰던 문제를 고쳤습니다. 모든 언어의 글자와 숫자는 파일 이름에 그대로 쓰고(가나.json), 다른 기호를 바꿔야 하는 이름에는 짧은 해시를 붙여 서로 겹치지 않게 했습니다. pane별 계획 파일(herdr-…, tmux-…, codex-…)은 이름이 그대로라 기존 기록이 이어집니다. 공백·기호가 들어간 --plan 이름은 새 파일 이름이 됩니다.
• README에 지원 범위를 명시했습니다(macOS, Linux 미검증, Windows 미지원).

검증: 테스트 59개, fmt, Clippy, 재패키징 바이트 일치, 3.3.0 → 3.3.1 업그레이드·롤백 smoke, CI.

agent-progress 3.3.0

진행 창을 새로 디자인했습니다. 위 영상은 실제 ap view TUI 녹화입니다.

• 역할별 줄: 막힘 ›, 지금 ›, 다음 ›, 완료 ›, 맨 아래 흐린 파일 ›. 중복되던 "현재 계획 / 계획상 진행"은 한 줄로 합쳤고, 진행 중 항목이 둘 이상이면 경고색으로 보여줍니다. 작은 창에서도 막힘이 먼저 보입니다.
• 그라데이션 채움: 진행 경계에서 넓게 퍼지며 트랙에 녹아들고, 100%는 꽉 채웁니다.
• 움직임: 단계를 끝내면 채움이 밀려가고(진행률이 내려가면 바로 바뀜), 마지막 기록 후 AP_IDLE_SECS(기본 300초) 동안 빛이 흐르다 > 모양으로 휘며 꼬리를 끌고 경계를 지나 사라집니다. 흐르던 빛은 끊기지 않고 끝까지 갑니다. 움직일 때만 초당 8프레임입니다.
• 세로 해상도 2배: 빈 칸은 ▀로 위아래 두 픽셀을 그립니다(AP_HALF_BLOCKS=0으로 끔).
• 퍼센트: 소수점 둘째 자리까지(66.67%), 다 끝나기 전 100%·시작 후 0%는 없음.
• 테마: 차가운 딥그린(채움 #1F4842, 빛 #5CD6B8). .agent-progress/ui.json의 theme으로 바꿀 수 있습니다.
• 문서: README를 녹화와 함께 다시 썼고, docs/operations.md를 3.x 기준으로 새로 썼습니다.

검증: 테스트 57개, fmt, Clippy, xhigh 코드 리뷰 15건 반영, 재패키징 바이트 일치, 3.2.0 → 3.3.0 업그레이드·롤백 smoke, CI.

agent-progress 3.2.0

• ap skill install (--dry-run, ap skill remove): 바이너리에 내장된 ap 스킬을 ~/.agents/skills/ap에 설치합니다. 있으면 Claude Code·Codex·OpenCode·Antigravity 스킬 폴더에 링크를 걸고, Claude Code가 시키지 않아도 쓰도록 ~/.claude/CLAUDE.md에 표시된 지침 블록을 추가합니다(기존 파일 백업). 제거는 ap가 설치한 것만 되돌리고, 다른 스킬·링크는 건드리지 않습니다.
• pane 하나에 진행 창 하나: 진행 창 상태를 계획 파일에서 pane별 상태(~/.local/state/agent-progress/panes/)로 옮겼습니다. 같은 pane에서 여러 프로젝트(예: 레포와 worktree)를 오가면 진행 창이 겹쳐 열리지 않고, 마지막으로 바뀐 계획으로 화면이 바뀝니다.
• .agent-progress/.gitignore 자동 생성: 어느 프로젝트에서도 계획 파일이 커밋되지 않습니다.

검증: 테스트 36개, fmt, Clippy, 재패키징 바이트 일치, 3.1.0 → 3.2.0 업그레이드·롤백 smoke. 실제 Herdr에서 두 프로젝트를 번갈아 기록할 때 진행 창 하나가 전환되는 것, 닫기·q·다시 열기, 새 Claude Code 세션이 지시 없이 ap를 쓰는 것을 확인했습니다.

agent-progress 3.1.0

에이전트 하네스 지원을 넓혔습니다.

• Cline 지원: Cline은 Herdr 정보나 세션 식별자 없이 공유 데몬에서 명령을 실행합니다. 그래서 프로젝트에서 실행 중인 Cline pane이 정확히 하나일 때 그 아래에 진행 창을 엽니다. 여러 개면 열지 않습니다.
• 실제 확인한 하네스 (Herdr, 진행 창이 에이전트 pane 바로 아래): Claude Code, Codex, OpenCode, Cursor CLI, Copilot CLI, Cline, OMP, Gemini CLI, Devin CLI, pi, Antigravity CLI, Command Code. README에 표로 정리했습니다.
• 스킬은 인식하지만 실제 동작 미확인: Amp(로그인 만료), Hermes(첫 실행 동의 화면), GJC(모델 크레딧/정책).
• ap status | head -1처럼 출력 파이프가 닫혀도 패닉 없이 종료합니다.

검증: 테스트 28개, fmt, Clippy, 재패키징 바이트 일치, 3.0.0 → 3.1.0 업그레이드·롤백 smoke.

agent-progress 3.0.0

에이전트 작업 계획을 Herdr/tmux pane 바로 아래 진행 창에 보여주는 CLI를 작게 다시 만들었습니다.

ap goal "로그인 버그 수정"
ap add "원인 재현" "수정" "회귀 테스트"   # 번호는 한 번 정해지면 바뀌지 않음
ap start 1 · ap done 1 · ap block 2 "키 필요" --needs user · ap cancel 3

• 진행 창: Signal 레이아웃, 진행 경계 그라데이션, 아래 빈 셸 pane 재사용. 키 없이 상태를 보고, 필요하면 ↑↓ 목록·Enter 상세·/ 검색·f 미완료·h 이력.
• pane 확인: HERDR_PANE_ID는 그 pane의 프로세스가 ap의 조상일 때만 신뢰합니다. Codex(공유 데몬)는 스레드 이름이 제목인 Codex pane이 정확히 하나일 때만 엽니다.
• 진행 창은 고유 ID와 heartbeat로 관리되며, ap close는 계획 파일로 종료를 요청합니다.
• ap 스킬 하나가 패키지에 포함됩니다(share/agent-progress/skills/ap).

호환성 깨짐: connect, launch, shell, setup, config, bridge, follow, product, v2 run/task 명령이 제거됐습니다. 기존 1.x·v2 .agent-progress 데이터는 삭제하지 않지만 읽지 않습니다. 진행 창 높이는 AP_PANE_SIZE(기본 10%)로 정합니다.

검증: 테스트 27개, fmt, Clippy, 재패키징 바이트 일치, 3.0.0-beta.2 → 3.0.0 업그레이드·롤백 smoke. 실제 환경: Claude Code, 데몬 모드 Codex 0.160, OpenCode 2.0.20(Herdr), tmux 3.6a.

자세한 내역: alpha.1 · alpha.2 · beta.2

agent-progress 3.0.0-beta.2

Prerelease (beta). 코드 리뷰에서 나온 문제를 고쳤습니다. Homebrew formula는 계속 1.2.8을 가리킵니다.

• 자동으로 연 진행 창마다 고유 ID와 heartbeat를 둡니다. 살아 있는지 판단할 때 pane 번호에 의존하지 않고, ap close는 계획 파일로 종료를 요청합니다(tmux kill-pane이나 q 입력 없음). 재사용된 tmux pane 번호 때문에 무관한 pane이 닫히는 문제와, 검색 입력 중 닫기가 안 되는 문제를 고쳤습니다.
• 수동으로 띄운 ap view를 q로 닫아도 자동 진행 창 기록은 그대로입니다.
• 같은 pane 번호를 새 터미널이 받으면 진행 창 상태가 새로 시작됩니다. ap new는 실행 중인 진행 창과 사용자가 닫은 상태를 유지합니다.
• 보관 파일이 서로 덮어쓰지 않고, 이력도 함께 보관됩니다.
• 완료를 취소하면 완료 시각이 지워집니다. 빈 막힘 사유는 거부합니다.
• pane 확인은 ps 한 번으로 끝나고, 키 입력이 계속 들어와도 파일 갱신이 밀리지 않습니다.

검증: 테스트 27개, fmt, Clippy, 패키지 smoke, 재패키징 바이트 일치. 실제 Herdr에서 검색 중 닫기, q 뒤 다시 열리지 않음, ap new 뒤 진행 창 유지를 확인했습니다. 실제 환경 추가 확인(게시 후): tmux 3.6a에서 열기·갱신·닫기·다시 열기·q, Herdr 안 OpenCode 2.0.20에서 pane 바로 아래 자동 열기, beta.1 → beta.2 업그레이드·롤백.

agent-progress 3.0.0-beta.1

Prerelease (beta). 3.0.0-alpha.2와 같은 기능을 베타로 올렸습니다. Homebrew formula는 계속 1.2.8을 가리킵니다.

에이전트가 직접 부르는 작은 CLI(ap goal/add/start/done/block)와, 호출한 pane 아래의 Signal 진행 창입니다. 변경 내역은 alpha.1과 alpha.2를 참고하세요.

검증: 테스트 20개, fmt, Clippy, 패키지 smoke, 재패키징 바이트 일치. 미검증: tmux, OpenCode, 진행 창이 열린 상태의 ap new.

agent-progress 3.0.0-alpha.2

Prerelease. 3.0.0-alpha.1 위에 상세 화면을 되살렸습니다. Homebrew formula는 계속 1.2.8을 가리킵니다.

• 상태를 보는 데 키는 필요 없습니다. 필요할 때 ↑↓/j k 목록, Enter 상세, / 검색, f 미완료만, h 변경 이력, ? 도움말, Esc 진행 막대로 돌아가기.
• ap 스킬은 전역 설치용으로, 여러 단계 작업이면 요청 없이 계획을 기록하도록 안내합니다.

검증: 테스트 20개, fmt, Clippy, 패키지 smoke, 재패키징 바이트 일치, 실제 Herdr pane에서 목록·상세·이력·Esc 확인.
미검증: tmux, OpenCode, 진행 창이 열린 상태의 ap new. 제거된 기능은 3.0.0-alpha.1 참고.

agent-progress 3.0.0-alpha.1

Prerelease. 1.x/2.x의 훅·런처·v2 기록 방식을 걷어내고, 에이전트가 직접 부르는 작은 CLI로 다시 만든 알파 버전입니다. Homebrew formula는 계속 1.2.8을 가리킵니다.

사용

ap goal "로그인 버그 수정"
ap add "원인 재현" "수정" "회귀 테스트"   # 번호는 한 번 정해지면 바뀌지 않음
ap start 1 · ap done 1 · ap block 2 "키 필요" --needs user · ap cancel 3

• 진행 창은 호출한 pane 바로 아래에 열립니다(아래에 빈 셸 pane이 있으면 재사용). Signal 레이아웃, 진행 경계 그라데이션.
• HERDR_PANE_ID는 그 pane의 프로세스가 ap의 조상일 때만 신뢰합니다. Codex(공유 데몬)는 스레드 이름이 제목인 Codex pane이 정확히 하나일 때만 그 아래에 엽니다.

제거됨 (호환성 깨짐)

connect, launch, shell, setup, config, bridge, follow, product, v2 run/task 기록 명령, 상세·검색·이력 화면. 스킬 4개는 ap 하나로 합쳐졌습니다. 기존 1.x·v2 .agent-progress 데이터는 삭제하지 않지만 읽지도 않습니다. 남아 있는 ap bridge 훅이 있다면 실패합니다.

검증

• 자동: 테스트 17개, fmt, Clippy, 패키지 설치·실행·제거 smoke, 재패키징 바이트 일치.
• 실제 환경: Claude Code pane, 데몬 모드 Codex 0.160(스레드 제목 매칭), 재사용 pane 닫기.
• 미검증: tmux, OpenCode, 진행 창이 열린 상태의 ap new.