박근민 Justin Avery Park

실행 가시성 계층

에이전트가 지금 무엇을 하고 있는지, 얼마를 쓰고 있는지를 상시 노출하는 계층. "멈춘 건가, 일하는 중인가"를 없앴습니다.

기간
2026.08 –
역할
설계 · 구현 단독
분류
Observability · DX
2줄
상태 트랙 (비용 · 진행)
0
작업 코드 오염
에이전트 CLI 하단 상태 트랙 — 모델·컨텍스트 사용량·세션 및 주간 한도·누적 비용, 그리고 현재 실행 중인 외부 호출과 경과 시간

실제 화면. 윗줄은 모델 · 컨텍스트 소모(21%) · 세션 한도(10%) · 주간 한도(55%) · 누적 비용($14.82), 아랫줄은 지금 돌고 있는 외부 호출과 경과 시간입니다.

왜 만들었나

에이전트가 외부 도구를 부르면 응답이 올 때까지 화면이 조용합니다. 그 몇 분 동안 사람은 계속 들여다보게 되고, 그러면 자동화한 의미가 사라집니다.

구조

  • 훅이 도구 호출의 시작 · 종료를 가로채 기록하고, 상태줄이 어떤 호출이 몇 초째 진행 중인지를 실시간으로 그립니다.
  • 비용을 사후가 아니라 지금 봅니다 — 컨텍스트 소모율, 세션 · 주간 사용 한도, 누적 요금을 한 줄에 상주시켜 예산 초과를 결제 후가 아니라 진행 중에 알게 했습니다.
  • 계측이 작업 코드를 오염시키지 않습니다 — 추적은 전부 훅 계층에서 일어나고, 실제 작업 스크립트는 자신이 관측되고 있다는 사실을 모릅니다.
  • 여러 프로필(계정) · 여러 세션이 동시에 도는 환경을 전제로 설계했습니다.

기술 스택

Python 훅 · CLI statusline 렌더러 · 도구 호출 인터셉트