Pi는 프로바이더 비의존 모델 접근을 위해 만들어진 유연한 AI 코딩 인터페이스입니다. 설정 가능한 사고 모드, 세션 영속 제어, 명시적 도구 게이팅으로 AI 코딩 어시스턴트의 행동을 세밀하게 제어할 수 있습니다. 다만 Pi는 여전히 본질적으로 터미널 진입점이고, HagiCode는 완전한 AI 프로그래밍 워크벤치입니다. 둘이 함께하면 Pi를 설정 가능한 CLI에서 완전한 일상 개발 환경으로 바꿀 수 있습니다. 또한 공통 도구 호출 뷰와, 상태 표시줄에 표시되는 선택형 TokenMonitor 사용량도 다룹니다. Pi는 실행 중에 구조화된 질문을 보낼 수 있으며, 사용자가 답하면 실행이 이어집니다.
Pi의 능력은 고정된 단일 프로바이더 경험이 아니라 제어 가능한 AI 실행에 집중합니다：
프로바이더 퍼스트 모델 접근：Pi는 하나의 고정된 벤더 경로를 강제하는 대신 다른 모델 백엔드를 가리킬 수 있습니다. 그래서 시간이 지나며 기반이 되는 프로바이더나 모델 전략을 바꾸면서도 하나의 CLI 워크플로를 보존하고 싶은 팀에게 매력적입니다.
설정 가능한 사고와 세션 동작：Pi는 사고 모드, 세션 디렉터리, 세션 없는 실행 같은 스위치를 노출합니다. 작업에 따라 실행을 가로지르며 대화 상태를 보존할지, 각 턴을 완전히 무상태로 유지할지 선택할 수 있습니다.
명시적 도구 거버넌스：Pi는 AI 턴이 얼마나 많은 도구 접근을 받을지 결정할 수 있습니다. 더 엄격한 안전 경계나 더 예측 가능한 실행 동작을 원할 때 내장 도구와 더 넓은 도구 사용을 비활성화할 수 있습니다.
Pi에는 몇 가지 주목할 만한 아키텍처 특성이 있습니다：
구조화된 CLI 런타임：HagiCode Core에서 Pi는 공유 libs 런타임 위의 얇은 어댑터로 통합되어, 안정적인 제품용 계약을 보존하면서 기반이 되는 CLI 프로세스 처리를 공통 프로바이더 계층에 위임합니다.
세션 인식 실행：Pi는 영속화된 세션 상태를 재사용할 수도 있고, 완전히 무상태 모드로 실행할 수도 있습니다. 그래서 장기 실행 개발 스레드와, 넘겨받은 상태가 바람직하지 않은 깨끗한 원샷 작업 모두에 적합합니다.
스트리밍과 도구 지원 응답：Pi는 출력을 도착하는 대로 스트리밍하며(Pi 0.84 이상에서는 증분 조각, 0.78.x에서는 전체 스냅샷), 도구 호출과 시스템 메시지를 지원합니다. 단순한 발사 후 망각 프롬프트 래퍼가 아니라, 상호작용적 실행이 필요한 더 풍부한 AI 프로그래밍 워크플로에 참여할 수 있습니다.
Pi의 생태계 가치는 유연성과 조합성에서 나옵니다：
프로바이더 라우팅 친화 설계：Pi는 모델 라우팅이 독립된 계층으로 다뤄지는 환경에 자연스럽게 들어맞습니다. 하나의 상호작용 면을 유지하면서 서로 다른 상류 모델 프로바이더를 실험하려는 팀에 특히 유용합니다.
보조 모델 선택 지원：HagiCode Core에서 Pi는 주 직업에서 프로바이더 런타임을 유지하면서 모델 선택은 모델 슬롯에서 구성 가능한 상태로 둡니다. 이 분리는 CLI 동작과 모델 선택을 의도적으로 분리하는 워크플로를 반영합니다.
통합된 모니터링과 발견：Pi는 자체 실행 파일 발견 경로와 헬스 체크를 가진 일급 모니터링 대상 CLI로 다뤄져, 고립된 터미널 명령이 아니라 더 넓은 다중 에이전트 워크스테이션의 일부로 운용하기 쉽습니다.
Pi는 프로바이더 라우팅, 사고 모드, 세션 재사용, 도구 노출에 대해 비정상적으로 세밀한 제어를 제공하지만, 순수 터미널 워크플로는 여전히 프로젝트 관리, 오케스트레이션, 장기 지식 영속화를 사용자에게 맡깁니다.
실제 납품 작업에서 이런 빠진 계층은 하나의 똑똑한 명령보다 더 중요합니다. HagiCode는 Pi 자신이 소유하려 하지 않는 워크플로 구조를 제공합니다.
Pi는 한 세션 안에서 많은 일을 할 수 있지만, 실제 납품은 한 번에 하나의 작업씩 이루어지는 일은 거의 없습니다.
HagiCode는 여러 Pi 세션을 병렬로 실행할 수 있으며, 각각 격리된 컨텍스트, 명확한 책임 경계, 독립적인 진행을 갖습니다.
이는 Pi를 설정 가능한 싱글스레드 CLI에서 팀이 실제로 소프트웨어를 구축하는 방식에 맞는 병렬 엔지니어링 워크벤치로 바꿉니다.
일상 개발에서 가장 흔한 혼란은 코드를 못 쓰는 것이 아니라, 이런저런 변경을 해놓고 왜 했는지, 무엇을 바꿨는지, 변경들이 서로 어떻게 연관되는지 잊어버리는 것입니다.
HagiCode에 내장된 OpenSpec 제안 워크플로는 이 문제를 근본적으로 해결합니다. 모든 개발 작업은 제안으로 시작됩니다：
이 '먼저 생각하고 행동하는' 접근은 Pi의 유연한 라우팅 모델을 문서화할 자리를 줍니다. 몇 달이 지나도 무엇이 바뀌었는지뿐 아니라, 왜 특정 프로바이더, 모델 루트, 도구 경계를 선택했는지도 볼 수 있습니다.
코드를 다 쓴 뒤 커밋 메시지를 작성하는 것은 많은 개발자에게 정신적 마찰입니다. 대충 쓰면 나중에 핵심 커밋을 찾을 수 없고, 너무 격식을 차리면 시간 낭비처럼 느껴집니다.
HagiCode의 AI 커밋 기능은 이것을 완전히 Pi에 맡깁니다. 코드 변경을 분석하고 의도와 영향 범위를 이해한 뒤 구조가 명확하고 의미적으로 정확한 커밋 메시지를 자동 생성합니다. 더 중요한 것은, AI 커밋 중에 HagiCode가 리포지터리를 자동으로 잠가 병행 작업으로 인한 상태 충돌을 막고 안전하고 신뢰할 수 있는 커밋을 보장합니다.
주의력은 창작을 위해 아껴두고, 커밋의 사무 작업은 Pi에 맡기세요.
Pi가 코드를 분석하고 문제 파일을 식별하고 정확한 줄 번호까지 짚어준 뒤, 익숙한 어색한 순간이 찾아옵니다. AI 대화 창을 떠나 IDE로 돌아가 파일을 다시 찾고 수동으로 올바른 위치로 점프해야 합니다. 이 분석에서 편집으로의 문맥 단절은 흐름을 끊을 뿐 아니라 AI의 가치를 '문제의 위치를 알려주는' 수준에 머물게 하고 '직접 편집 모드로 들어가도록 돕는' 곳까지 닿지 못하게 합니다.
HagiCode에 내장된 Code Server 기반 브라우저 에디터는 바로 이 단절을 해소하기 위해 설계되었습니다：
Code Server 통합은 HagiCode를 코드를 분석할 수 있는 프론트엔드 페이지에 머물지 않고, Pi의 분석이 직접 편집 액션으로 착지하는 완전한 워크스테이션으로 만듭니다. AI 분석과 직접 수정 사이의 도구 전환 비용을 최소화합니다.
Pi의 유연성은 강력하지만, 매번 같은 프로바이더 선택, 도구 경계, 작업 틀을 손으로 되뇌는 건 낭비입니다.
HagiCode의 HagiTask 메커니즘은 이런 반복 패턴을 재사용 가능한 템플릿으로 바꿉니다. 단순한 단축 명령이 아니라 확장 가능한 Skills 통합 플랫폼입니다：
HagiTask는 Pi와의 협업을 '매번 워크플로를 다시 짓기'에서 '준비된 워크플로를 골라 실행하기'로 업그레이드합니다. 이것이 설정 가능성이 진정한 운용 레버지가 되는 곳입니다.
프로그래밍 자체는 지루할 수도 있지만, 즐거울 수도 있습니다. HagiCode의 게임화된 인터페이스 설계는 명령줄 도구의 차가운 경험에서 벗어납니다：
Pi는 제어를, HagiCode는 경험을 제공합니다. 둘이 함께하면 고도로 설정 가능한 CLI를 사람들이 매일 실제로 즐겨操作할 수 있는 워크스페이스로 바꿉니다.
병렬 세션은 유용하지만, 여러 개가 동시에 돌기 시작하면 다음 병목은 조율이 됩니다.
HagiCode의 Agents 관리 계층은 각 Pi 워커를 보이는 상태, 할당된 범위, 독립적인 설정을 가진 이름 붙은 스케줄 가능한 Agent로 바꿉니다.
'터미널이 많이 열려 있다'에서 '작은 AI 팀이 한곳에서 조율되고 있다'로 옮겨갑니다.
실제 프로젝트에서 코드가 단일 리포지터리에 머무는 일은 드뭅니다. 프론트엔드, 백엔드, 문서, 공유 라이브러리가 서로 다른 리포에 흩어져 있고, 하나의 기능 변경이 여러 리포를 동시에 건드려야 할 수 있습니다. Pi에게 단일 리포 모드는 작동하지만, 리포 간 관계를 본래 이해하지 못해 매 대화마다 '이 변경은 다른 두 리포에도 동기화돼야 해'라고 수동으로 알려야 하며, 이는 분명히 비효율적입니다.
HagiCode의 Monospecs 메커니즘은 다중 리포 시나리오를 위해 설계된 구조화된 해법입니다. .hagicode/monospecs.yaml 설정 파일을 통해 프로젝트 그룹의 모든 하위 리포 주소, 이름, 관계를 선언해, 제안을 시작할 때 Pi에게 자동으로 리포 간 지도를 제공합니다：
Monospecs는 본질적으로 리포 간 협업에서 Pi의 인지적 사각지대를 없앱니다. Pi의 라우팅 유연성은 변경 면 전체도 볼 수 있게 되면 더욱 중요해집니다.
Pi의 세션 제어는 유용하지만, 영속적 세션조차 영속적인 크로스 프로젝트 기억 계층과는 같지 않습니다. 그것이 없다면 중요한 컨텍스트를 여전히 너무 자주 다시 도입해야 합니다.
Vault는 HagiCode의 크로스 프로젝트 영속 지식 저장 계층입니다. 핵심 설계 철학은 '한 번 등록하면, 어디서든 재사용'입니다：
Monospecs가 Pi에게 프로젝트가 어디에 있는지 이해시킨다면, Vault는 Pi에게 당신이 이미 축적한 것을 기억하게 합니다. 이것이 설정 가능한 CLI를 더 장기적인 엔지니어링 파트너로 바꾸는 것입니다.
Pi는 이미 워크플로와 프로바이더 선택 사이의 더 분리된 관계를 장려하지만, 더 큰 팀은 여전히 그 라우팅을 깔끔하게 관리할 중앙 자리가 필요합니다.
OmniRoute는 상호작용 계층과 모델 라우팅 계층을 분리해, HagiCode는 워크플로에 Pi를 남긴 채 아래에서 모델 소스를 전환할 수 있습니다.
이는 더 나은 비용 통제, 더 나은 작업-모델 적합, 그리고 모델 가격이나 가용성이 변할 때 워크플로 동요 감소를 가져다줍니다.
HagiCode는 모든 도구 호출 메시지와 도구 결과 메시지에 타입이 지정된 하나의 도구 호출 구조를 붙입니다. 도구 종류, 입력 필드, 상태, 결과 텍스트나 이미지, 오류, 소요 시간이 여기에 담깁니다. 이 구조는 저장된 데이터에서 계산되므로 세션 기록과 실시간 업데이트가 똑같은 모습으로 표시됩니다.
모든 프로바이더에 같은 구조가 적용되므로 Pi의 도구 호출도 워크스페이스의 다른 에이전트와 같은 형태로 보입니다. CLI마다 다른 원본 출력을 따로 익힐 필요 없이 하나의 형식만 읽으면 됩니다.
HagiCode는 TokenMonitor 데스크톱 앱이 집계한 오늘의 토큰 사용량과 비용을 상태 표시줄에 보여 줄 수 있습니다. 이 연동은 선택 사항이며 기본값은 꺼짐입니다.
TokenMonitor의 로컬 데이터 파일이나 TokenMonitor HostHub를 주기적으로 읽고, 오늘의 총 토큰 수와 비용만 보관합니다. 상태 표시줄은 전체 사용량 보고서가 아니라 빠르게 훑어보는 용도로 유지됩니다.
Pi에 결정이 필요하면 실행 도중 구조화된 질문을 보낼 수 있습니다. HagiCode는 대화 안에 질문을 표시하고, 세션 상태는 실행 중에서 답변 대기로 바뀌며, 사용자가 답하면 같은 실행이 이어집니다.
재시작이나 시간 초과 등으로 실행이 이미 끝났다면, 답변은 같은 세션의 일반 메시지로 전달되어 작업이 계속될 수 있습니다.
Pi는 유연하고 프로바이더 인식적인 AI 코딩 인터페이스이고, HagiCode는 완전한 AI 프로그래밍 워크벤치입니다. 둘의 관계는 보완적입니다：
이미 Pi를 쓰고 있다면, HagiCode에 연결해 보세요. Pi가 더 이상 단지 설정 가능한 터미널 명령이 아니라, 구조화된 엔지니어링 환경 안에서 작동하는 전 워크플로 AI 파트너가 된 것을 알게 될 것입니다.
HagiCode는 에이전트 코딩 작업 공간입니다. 풍부하고 편리한 UI 상호작용으로 계획 수립, 에이전트 실행, 프로젝트 작업을 쉽게 시작하고 따라가며 개발을 더 흥미로운 경험으로 만듭니다.
풍부하고 편리한 UI 상호작용으로 계획부터 프로젝트 작업까지 쉽게 따라갈 수 있습니다.
HagiCode는 에이전트 코딩 작업 공간입니다. OpenSpec 워크플로로 변경을 계획하고, 다중 에이전트 실행으로 진행하며, Hero Scenario로 긴 작업의 진행 상황을 한눈에 보여 아이디어를 실제로 배포되는 소프트웨어로 만듭니다.
© 2026 HagiCode | Powered By hagilight-starlight@0.21.0 | Branch: main | Commit: 951128b | Built:
