타우(Tau) 코딩 하네스 입문 — 허깅페이스가 만든 파이썬판 파이(Pi) 완전 정리

핵심 메시지

• 타우(Tau)는 허깅페이스가 내부적으로 개발 중인 코딩 하네스로, 기존 하네스 파이(Pi)를 파이썬으로 옮긴 포팅 프로젝트다.
• 내부 동작은 파이와 거의 같고, 가장 큰 차이는 Textual 프레임워크로 만든 터미널 화면과 그로 인해 추가된 몇몇 명령어다.
• 대화 기록을 목록이 아니라 각 메시지가 부모를 가리키는 트리로 저장해, 원하는 지점에서 대화를 갈라내기(포크)가 쉽다.
• 세션을 HTML이나 JSONL로 내보내 다른 에이전트에게 분석시키는 방식이 스킬·도구를 개선하는 실전 워크플로로 제시된다.
• 발표자는 신뢰할 수 있는 AI 워크플로를 만들 때 코딩 하네스 자체가 가장 중요한 요소 중 하나가 됐다고 강조한다.

쉽게 이해하기

영상은 '코딩 하네스'가 왜 중요해졌는지에서 출발한다. 발표자는 안정적인 AI 작업 흐름을 만들 때 모델만큼이나 그 모델을 감싸는 하네스의 설계가 중요해졌다고 말하며, 허깅페이스 내부에서 개발 중인 타우(Tau)를 예로 든다. 타우는 이미 존재하는 하네스 파이(Pi)를 파이썬으로 다시 구현한 것으로, 설치는 안내된 스크립트 한 줄이면 맥·리눅스·윈도우 어디서든 끝난다.

실행하면 왼쪽 사이드바에 세션 상태가 한눈에 정리돼 나온다. 세션 이름(첫 메시지를 보내면 선택한 모델이 자동으로 지어준다), 에이전트가 몇 번 턴을 돌았고 도구를 몇 번 호출했는지, 누적 토큰 사용량과 API 비용, 자동 압축(compaction)이 언제 실행될지, 그리고 현재 컨텍스트에 올라간 시스템 프롬프트와 파일, 로드된 도구·스킬·커스텀 프롬프트·익스텐션 목록이 표시된다. 기본 도구는 파이와 같은 읽기·쓰기·편집·bash 네 가지이며, 익스텐션을 붙이면 도구가 늘어난다.

로그인 명령으로 모델 제공자를 연결한 뒤 모델을 고르는 흐름도 파이와 같다. 구독형으로는 코덱스·앤트로픽·깃허브 코파일럿이, API 키 방식으로는 오픈AI·앤트로픽·제미나이 등이 지원되고, 발표자는 여러 추론 제공자를 하나의 라우터로 쓸 수 있다는 이유로 허깅페이스 연결을 권한다. 도구 호출은 실행 중에는 노란색, 끝나면 초록색으로 표시되고, 단축키로 사고 과정과 도구 결과를 펼쳐 볼 수 있다.

가장 특징적인 설계는 세션 저장 방식이다. 모든 메시지는 부모 메시지를 가리키는 속성을 갖고, 대화 전체가 리스트가 아닌 트리로 저장된다. 덕분에 중간의 어떤 메시지에서든 새 가지를 만들어 대화를 갈라낼 수 있고, 트리 명령으로 전체 구조를 보며 원하는 지점으로 이동할 수 있다. 이 기록은 한 줄이 하나의 JSON 객체인 JSONL 파일로 작업 디렉터리별로 보관되며, 파이도 같은 구조를 쓴다.

스킬과 커스텀 프롬프트의 차이도 정리된다. 스킬은 마크다운으로 적은 절차적 지시로, 설명이 시스템 프롬프트에 들어가기 때문에 에이전트가 필요하다고 판단하면 스스로 호출한다. 반면 커스텀 프롬프트는 슬래시 명령을 긴 프롬프트로 바꿔 넣는 화면 단의 기능이라, 에이전트는 그런 명령이 있다는 사실 자체를 모른다. 새 스킬이나 프롬프트를 만들면 리로드 명령으로 다시 읽혀야 한다는 점도 함께 안내된다.

주요 인사이트

• 하네스가 세션을 트리로 저장하면 '실패한 시도를 되돌리고 다른 길로 다시 가보기'가 기록 손실 없이 가능해진다. 대화를 선형 로그로만 다루는 도구와 갈리는 지점이다.
• 세션을 내보내 다른 에이전트에게 읽히는 방식은, 스킬이나 MCP 서버를 새로 만들었을 때 그 동작을 사람 대신 검증·개선하게 하는 자동화된 회고 루프가 된다.
• 스킬은 에이전트가 자율적으로 부를 수 있고 커스텀 프롬프트는 그렇지 않다는 구분은, 어떤 기능을 어느 쪽으로 만들지 결정하는 실무 기준이 된다.
• 터미널 UI를 직접 만들지 않고 Textual 같은 기존 프레임워크를 쓰면 개발은 빨라지지만, 스킬 목록 표시 방식처럼 원본과 다른 명령어를 새로 만들어야 하는 차이가 생긴다.
• 누적 토큰 사용량과 압축 시점을 상시 노출하는 화면 설계는, 에이전트 사용 비용이 실제 운영 변수로 취급되고 있음을 보여준다.

자주 묻는 질문

관련 AI 소식