agent-harness

agent-harness는 어떤 호스트를 고르든 같은 생애주기를 돌린다. 발견, 추천, 복제, 준비, 활성화, 그리고 연결. 이 일관성이 중요한 이유는 밑에 깔린 도구들이 무엇 하나 합의하지 않기 때문이다. Claude Code에서 되는 스킬은 Cursor용과 같은 방식으로 묶이지 않는다. 이 도구는 그런 차이를 하나의 명령 표면 뒤에서 매끄럽게 만든다. 하나의 표면, 하나의 생애주기.

workspace <host> 명령은 새 사용자를 위한 기본 경로다. 폭넓게 발견하고 후보의 순위를 매기고 고른 자산을 준비하고 활성화하며 마지막에 호스트 연결까지 끝낸다. 모두 agent-harness workspace cursor --intent frontend 같은 한 줄에서 이뤄진다. devops, design, research 같은 의도가 선택을 자신의 작업 종류로 이끌고, 여러 개를 넘길 수도 있다. 설정은 한 줄이다. 그게 매력이다.

호스트 연결은 요청하지 않으면 아무것도 바꾸지 않는다. 기본적으로 wire <host>는 검토 가능한 계획을 쓰고 아무것도 건드리지 않는다. 정확한 대상 경로와 예정된 쓰기를 읽고, 준비되면 적용하거나 초기화한다. 도구가 편집기 설정을 조용히 다시 쓴 경험이 있는 사람에게는 반가운 선이다.

인터넷에서 자산을 작업 공간으로 바로 끌어오는 대신, 범위를 좁힌 자산 묶음을 재현 가능한 로컬 산출물로 복제하고 세대마다 고정한다. 위험해 보이는 후보는 활성화되지 않고 격리 폴더로 보낸다. 그 결과 발밑에서 계속 움직이는 설정이 아니라 검사하고 되돌릴 수 있는 설정이 된다.

agent-harness는 Agentic Resource Discovery 1.0 규격을 구현한다. Google, Microsoft, Hugging Face, GitHub, NVIDIA가 지원하는 표준이다. .well-known/ai-catalog.json을 발행해 레지스트리가 선별한 자산을 색인하게 하고, 다른 ARD 레지스트리를 발견 소스로 소비할 수도 있다. 슬로건이 의도를 요약한다. 어디서나 발견하고 어디에나 설치한다.

이 프로젝트는 VS Code(Copilot 연동), OpenCode, Cursor, Zed, Claude Code, Pi, OpenAI Codex용 어댑터를 등록한다. 각 어댑터가 자기 호스트의 파일, 설정, 적용과 초기화 동작, 안전 경계를 담당한다. 일부는 다른 호스트의 패키지 배치를 재사용하면서 자체 정책으로 순위를 매긴다. 덕분에 예컨대 Cursor는 Copilot 방식 자산과 호환된다.

추천은 인기만이 아니라 정책, 수요 신호, 신뢰, 비용, 다양성을 함께 따진다. 공식 및 검증된 출처를 우선하고, 소유자 근거가 맞지 않으면 자사 출처를 낮춘다. 그 결과 수상한 패키지가 작업 공간에 도착하는 일이 줄고, 지금 만드는 것에 실제로 맞는 것의 비중이 늘어난다.