프로젝트 소개

Token Harness는 Claude Code 및 Codex와 같은 코딩 에이전트의 효율성과 사용성을 개선하기 위해 설계된 로컬 CLI 도구입니다. 이 도구는 완전히 온디바이스로 실행되어 데이터를 외부 서비스로 전송하지 않으며, 명시적으로 승인되지 않는 한 설정을 수정하지 않습니다. 이 도구는 설치된 에이전트와 최적화 제공자(RTK 또는 HarnessTrim 등)를 감지하고 통합 상태를 확인하며, 증거 기반의 안전한 개선 사항을 권장합니다. 사용자는 `token-harness setup`으로 시작하며, 이를 통해 현재 상태를 진단하고 종종 변경이 필요 없는 단일 다음 단계를 제안받습니다. 설정 후 대시보드(`token-harness ui`)는 활성 도구, 관찰 가능한 토큰 허용량 및 실행 가능한 가이드와 같은 실시간 상태를 제공합니다. 최적화는 기존 에이전트 명령(예: `claude` 또는 `codex`)을 통해 자동으로 실행되므로 별도의 런처가 필요하지 않습니다. 고급 기능으로는 메트릭 추적, 제공자 업데이트, 롤백 및 plan/apply 워크플로우를 통한 네이티브 정책 적용이 포함됩니다. 안전이 최우선으로 고려되어 변경 사항은 트랜잭션 방식으로 처리되고 백업되며, 명시적인 `--yes` 플래그가 필요합니다. Token Harness는 사용 기록(ccusage) 및 할당량 컴패니언(cclimits)의 읽기 전용 검사를 지원하지만, 이를 자동으로 설치하지는 않습니다. 이는 AI 코딩 어시스턴트와 작업할 때 투명성, 제어력 및 최소한의 마찰을 원하는 개발자에게 이상적입니다.