pi-mono가 무엇인가요?

Pi-mono는 Mario Zechner(badlogic, libGDX 창시자)가 만든 minimalist terminal coding agent인 Pi의 monorepo 이름입니다. CLI binary는 단지 pi입니다. 네 가지 tools인 read, write, edit, bash만 제공하며, 기본적으로 full YOLO mode로 실행됩니다. 나머지 기능(subagents, plan mode, permission gates, MCP)은 사용자가 설치하는 extensions로 밀어 넣었습니다. repo는 github.com/badlogic/pi-mono에 있고, earendil-works/pi로 mirror되어 있으며 MIT licensed입니다.

pi-mono는 Claude Code나 Codex CLI와 어떻게 다른가요?

Pi의 주장에 따르면, 기존 harness는 대부분의 사용자가 쓸 일이 없는 기능의 80%를 담은 우주선이고 system prompt와 tool surface가 자주 바뀌어 개인 workflow를 깨뜨립니다. Pi는 frontier model인 GPT-5.5가 이미 그 정확한 schema로 학습되어 있다는 전제 아래 core surface를 네 가지 tools로 작게 유지하고, 나머지 기능은 extensions, skills, prompt templates로 분리합니다. trade-off는 기본 제공 기능이 줄어드는 대신, 완전히 읽고 수정할 수 있는 harness를 얻는다는 점입니다.

pi-mono는 Smart AIPI와 함께 동작하나요?

네. Pi의 기반 provider library인 pi-ai는 Anthropic, Bedrock, Vertex, Mistral, Groq, Cerebras, xAI, DeepSeek, OpenRouter, Hugging Face 등과 함께 OpenAI-compatible endpoint를 지원합니다. OPENAI_BASE_URL을 https://api.smartaipi.com/v1로, OPENAI_API_KEY를 Smart AIPI key로 설정하면 Pi가 바로 연결됩니다. 코드 수정 없이 GPT-5.5, GPT-5.4, GPT-5.4-mini와 Smart AIPI의 다른 catalog를 사용할 수 있습니다.

Smart AIPI를 통해 pi-mono에서 어떤 model을 사용할 수 있나요?

우리가 제공하는 모든 model을 사용할 수 있습니다. GPT-5.5(Terminal-Bench 2.0과 Expert-SWE에서 최상급), 더 저렴한 일상 작업용 GPT-5.4와 GPT-5.4-mini, 정교한 code edit용 GPT-5.3-codex, 그리고 Anthropic-compatible endpoint를 통한 Claude family model, OpenAI-compatible path를 통한 Gemini까지 가능합니다. Pi의 핵심 기능은 session 중간 provider switching입니다. pi-ai가 context를 다시 써 주기 때문에 작업 도중 GPT-5.5에서 Claude나 Gemini로 바꿔도 state를 잃지 않습니다.

grill-me skill은 무엇이고 pi-mono와 왜 같이 쓰나요?

grill-me는 Matt Pocock의 skill(github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md)로, model이 계획에 대해 집요하게 질문하며 모든 결정, 제약, file, acceptance criterion이 고정될 때까지 인터뷰합니다. Pi-mono는 의도적으로 자체 plan mode를 포함하지 않으므로 grill-me가 자연스러운 보완재입니다. spec phase에서는 high reasoning으로 실행하고, 그다음에는 low reasoning으로 낮춰 Pi의 bare-metal four-tool loop가 plan을 여러 turn에 걸쳐 저렴하게 실행하게 하세요.

caveman skill은 무엇이고 비용을 어떻게 줄이나요?

Caveman은 Matt Pocock의 skill로, agent를 ultra-compressed communication mode로 전환합니다. 형식적인 English를 줄이고, 관사와 군더더기를 제거하고, 전보식 bullet로 답합니다. prose-heavy turn에서 실제 token 감소는 약 75%로 보고됩니다. GPT-5.5에서는 output tokens가 cached-input rate보다 6배 비싸기 때문에($7.50 vs $1.25 per 1M), output을 75% 줄이면 chatty task에서 per-turn bill의 대부분을 줄일 수 있습니다. Pi의 minimal core와 Smart AIPI의 95–98% cache hit rate와 함께 쓰면 다축 비용이 누적해서 크게 내려갑니다.

Smart AIPI에서 pi-mono가 다른 agent보다 저렴한 이유는 무엇인가요?

세 가지가 누적해서 작용합니다. (1) Pi의 four-tool core는 feature-rich harness의 multi-thousand-token system prompt보다 훨씬 작아, 매 turn standing context 비용이 낮습니다. (2) Smart AIPI gateway는 OpenAI prompt cache를 end-to-end로 보존하므로 repo + agents.md + history가 긴 session 내내 cache에 유지되고, input은 1M당 $0.125로 내려갑니다(uncached 대비 10배 저렴). (3) Caveman은 coding-agent invoice에서 가장 비싼 output을 압축합니다. 이 세 가지를 합치면, feature-heavy harness를 uncached endpoint에 붙여 쓰는 것보다 각 turn 비용이 곱셈적으로 한 자릿수 이상 내려갑니다.

pi-mono는 skills를 기본 지원하나요?

네. Pi는 Agent Skills standard를 구현합니다. skill folder를 config에 넣고 /skill:name으로 호출하면 됩니다. 또한 github.com/badlogic/pi-skills(brave-search, browser-tools, vscode integration, youtube-transcript, gd/gc/gm CLI wrappers, transcribe)라는 자체 first-party skill collection도 있으며, Claude Code, Codex CLI, Amp, Droid와도 명시적으로 호환됩니다. mattpocock/skills와 obra/superpowers 같은 third-party skill repo도 같은 방식으로 동작합니다.

pi-mono를 어떻게 설치하고 Smart AIPI에 연결하나요?

설치는 한 줄, 설정은 env var 두 개입니다. 설치: curl -fsSL https://pi.dev/install.sh | sh (또는 npm install -g @earendil-works/pi-coding-agent). 설정: export OPENAI_BASE_URL=https://api.smartaipi.com/v1 와 export OPENAI_API_KEY=sk-your-smartaipi-key. 실행: pi. 그다음 /skill로 grill-me, superpowers, caveman을 추가하면 오늘 바로 배포 가능한 가장 저렴한 serious agentic coding setup이 됩니다.

Smart AIPI의 Pi-Mono: Grill-Me, Superpowers, Caveman과 함께 가장 저렴하게 Lean Coding Agent를 실행하는 방법

Q: superpowers skill collection은 무엇인가요?

Superpowers(github.com/obra/superpowers, Jesse Vincent 작성)는 composable skill으로 제공되는 완전한 software-development methodology입니다. TDD scaffolding, code-review playbook, debugging procedure, refactoring pattern을 포함합니다. harness-agnostic이므로 Claude Code, Cursor, Copilot CLI, Gemini, Codex, Pi에서 모두 동작합니다. pi-mono와 함께 쓰면 Pi가 core에 넣지 않은 methodology를 얻으면서도 특정 harness에 묶이지 않습니다.

TL;DR: Pi-Mono는 Mario Zechner의 minimalist coding agent입니다. 네 가지 tools(read, write, edit, bash), MIT licensed, 의도적으로 작은 core를 가집니다. OpenAI-compatible이므로 https://api.smartaipi.com/v1에 연결하고, low reasoning으로 GPT-5.5를 실행한 뒤, Pi가 의도적으로 남겨둔 빈틈을 메우는 세 가지 skills를 함께 쓰세요: grill-me는 task creation, superpowers는 engineering methodology, caveman은 output tokens를 약 75% 줄입니다. Smart AIPI의 pay-as-you-go pricing과 95–98% cache hit rate를 더하면, per-turn bill은 자신의 usage page에서 직접 확인 가능한 수준으로 누적해서 내려갑니다.

lean-agent 흐름에는 대표 주자가 있습니다. Pi-Mono는 Mario Zechner(libGDX 창시자)이 만든 터미널 coding harness인 pi의 monorepo입니다. coding agent를 핵심 기능만 남기고 정리한 뒤, 나머지는 extensions로 밀어냅니다. Zechner가 Mastra talk "I Hated Every Coding Agent, So I Built My Own"에서 말했듯, 기존 harness는 대부분의 developer가 전혀 쓰지 않는 기능의 80%를 담은 우주선이고, release마다 system prompt가 바뀌어 그 위에 정교하게 쌓아 둔 개인 workflow를 깨뜨립니다.

Pi의 답은 radical minimalism입니다. 네 가지 tools, full YOLO mode, batteries included 없음. 완성도보다 hackability. Smart AIPI의 pay-as-you-go OpenAI-compatible endpoint에 붙이면, 그 minimalism은 오늘 배포 가능한 가장 저렴한 serious agentic coding setup으로 바로 이어집니다.

Pi-Mono가 실제로 무엇인가

Pi-mono는 monorepo입니다(github.com/badlogic/pi-mono, earendil-works/pi에 mirror됨). CLI binary는 단지 pi입니다. repo는 몇 개의 집중된 package로 나뉩니다:

pi-agent-core — runtime: tool calling, state, 실제 agent loop.
pi-ai — Anthropic, OpenAI-compatible, Bedrock, Vertex, Mistral, Groq, Cerebras, xAI, DeepSeek, OpenRouter, Hugging Face, Ollama 등 대략 열여 가지 provider와 대화하는 통합 provider library. 핵심은 context를 다시 써서 state를 잃지 않고 session 중간에 provider를 전환할 수 있다는 점입니다.
pi-tui — differential-rendering terminal UI.
pi-coding-agent — 구성 요소를 묶는 사용자용 CLI.

기본 tool surface는 딱 네 개입니다:

Tool	기능	이것만으로 충분한 이유
`read`	disk에서 file 읽기	frontier model은 이미 이 정확한 schema로 학습됨
`write`	file 쓰기 또는 생성	기계적인 I/O입니다. reasoning이 필요하지 않습니다
`edit`	file에 in-place patch 적용	search/replace + diff는 보편적인 edit primitive입니다
`bash`	임의의 shell command 실행	나머지 전부(grep, tests, git, package manager)는 shell command입니다

그 이상 — subagent, plan mode, permission gate, MCP server, sandboxing — 은 pi-skills 또는 third-party extension에 opt-in으로 들어갑니다. Pi는 기본적으로 full YOLO mode로 실행됩니다. permission prompt 없음, filesystem과 shell 제한 없음. 이것은 의도된 선택입니다. 안전장치가 필요하면 직접 설치하면 됩니다.

Pi-Mono와 Smart AIPI가 완벽한 조합인 이유

Pi의 pi-ai library는 모든 provider를 동일한 interface 뒤의 OpenAI-shaped 또는 Anthropic-shaped endpoint로 취급합니다. Smart AIPI의 gateway는 OpenAI surface 전체를 — chat, responses, embeddings, images, audio, anthropic-shaped messages — 하나의 base URL과 하나의 API key로 제공합니다. 두 설계는 아주 잘 맞습니다:

하나의 key, 모든 model. 같은 Smart AIPI API key로 GPT-5.5, GPT-5.4, GPT-5.4-mini, GPT-5.3-codex, GPT-Image-2, 그리고 Anthropic-compatible Claude routing까지 사용할 수 있습니다. Pi는 session 중간에 이들을 전환할 수 있습니다.
pay-as-you-go pricing. subscription도, quota도, throttle도 없습니다. 실제로 계산한 tokens만 지불합니다. Pi의 작은 system prompt는 feature-heavy harness보다 매 turn의 standing context 비용을 낮춥니다.
end-to-end prompt cache. Smart AIPI는 OpenAI의 prompt-cache key를 gateway를 통해 그대로 보존하므로, repo + agents.md + history가 긴 session 내내 cache에 유지됩니다. 실제 cache hit rate는 95–98%이며, cached input은 1M tokens당 $0.125까지 내려가 uncached 대비 10배 저렴합니다.
WebSocket session preservation. 긴 pi-mono session도 매 turn full input price를 치르지 않고 warm cache 하나를 유지합니다.

Pi-Mono를 완성하는 세 가지 skills

Pi는 task planning, opinionated engineering methodology, output-compression layer를 의도적으로 넣지 않습니다. 버그가 아니라 핵심입니다. 커뮤니티는 /skill:name invocation pattern으로 Pi에 붙는 composable skill로 이 세 가지 빈틈을 모두 메웠습니다. 첫날 설치할 가치가 있는 세 가지는 다음과 같습니다:

1. Grill-Me — High-Reasoning Task Creation

위치: github.com/mattpocock/skills, Matt Pocock 작성.

grill-me는 이름 그대로 동작합니다. model이 task를 끝까지 질문하며 모든 제약을 명확하게 만듭니다. scope 안의 file, success criteria, edge case, "done"의 의미까지. 보통 세에서 다섯 번의 짧은 turn이면 충분합니다. 사용자가 답하면 skill이 촘촘하고 실행 가능한 spec을 돌려줍니다.

경제적으로는 spec phase에만 high reasoning을 쓰는 것이 핵심입니다. 보통 세에서 다섯 번의 짧은 turn입니다. 그다음 execution phase(싸고 기계적인 작업이 30~100 turn 이어짐)에서는 low reasoning으로 내립니다. high reasoning은 무거운 판단이 필요한 곳에 쓰고, 나머지는 low reasoning이 맡습니다. Pi-mono의 네 가지 tool loop는 이 패턴에 특히 잘 맞습니다. spec이 고정되면, model은 read/write/edit/bash를 따라 곧바로 ship할 수 있기 때문입니다.

2. Superpowers — Skills로 구현한 Engineering Methodology

위치: github.com/obra/superpowers, Jesse Vincent 작성.

Superpowers는 "a complete software development methodology for your coding agents, built on top of a set of composable skills."입니다. TDD scaffolding, code-review playbook, debugging procedure, refactoring pattern, branch-management discipline이 포함됩니다. Pi가 core에 일부러 넣지 않은 명시적 engineering process입니다.

또한 harness-agnostic입니다. 같은 skill pack을 Claude Code, Cursor, Copilot CLI, Gemini, Codex, Pi에서 쓸 수 있습니다. 한 번 설치해 두면 여러 harness 사이에서 그대로 가져갈 수 있습니다. Pi의 plug-and-play skill loader 덕분에, pi의 source를 건드리지 않고도 전체 methodology를 minimal core 위에 얹을 수 있습니다.

3. Caveman — Output-Token Killer

위치: Matt Pocock의 skills repo의 productivity 섹션.

Caveman은 agent를 ultra-compressed communication mode로 전환합니다. 관사 제거. 군더더기 제거. 전보식 bullet로 답변. 형식적인 English도, 사과도, 서두도 없습니다. prose-heavy turn에서 실제 token 감소는 대략 75%로 보고됩니다.

왜 비용 절감에 가장 큰 영향을 주는가: GPT-5.5에서 output tokens는 1M당 $7.50이고 cached input은 1M당 $0.125입니다. 60배 차이입니다. output을 압축하는 것이 coding-agent invoice에서 가장 효과적인 수단입니다. grill-me + low reasoning만으로도 output은 이미 줄어듭니다. caveman은 남은 부분까지 압축합니다. 여기에 Smart AIPI의 cache를 더하면, 추가 turn의 한계 비용은 model compute envelope의 바닥에 가까워집니다.

누적 비용 이야기

Smart AIPI의 GPT-5.5 가격:

GPT-5.5 (1M tokens당)	Smart AIPI	Pi-Mono 효과
Input (uncached)	$1.25	작은 system prompt 덕분에 첫 turn 비용이 낮음
Input (cached prefix)	$0.125	긴 session 전반에 걸쳐 95–98% hit rate
Output	$7.50	caveman이 약 75% 절감, low reasoning이 추가로 누적 효과

grill-me로 spec을 마치고 caveman을 켠 상태에서 GPT-5.5 low reasoning으로 진행하는 pi-mono turn의 구조는 다음과 같습니다:

Cached input prefix (repo + agents.md + history) — 보통 turn당 가장 큰 token bucket입니다. cache가 hit하면 매번 cached rate로 계산됩니다.
New uncached input (tool result, 최신 user message) — 보통 input의 아주 작은 부분이며 full rate가 적용됩니다.
Output — caveman으로 압축되고, reasoning effort가 낮기 때문에 reasoning token도 최소화됩니다. 이 항목이 가장 높은 per-token rate로 과금되므로 가장 줄일 가치가 큽니다.

pay-as-you-go는 실제로 계산한 것만 지불한다는 뜻이며, 이 세 가지 레버는 서로 곱해집니다. 자신의 dashboard에서는 repo와 prompt shape에 대한 실제 per-turn 수치를 확인할 수 있습니다. cap도, throttle도, 월 최소 사용액도 없습니다.

Session 중간 provider 전환: Pi의 숨은 기능

Pi-ai는 portable context representation을 유지하고, 현재 연결한 provider에 맞게 다시 쓸 수 있습니다. 실전 번역: GPT-5.5가 애매함에 막히면, 대화 상태를 잃지 않고 작업 도중 /model claude-sonnet-4.6으로 바꿔 두 번째 의견을 받을 수 있습니다. 두 endpoint 모두 단일 Smart AIPI key 뒤에 있습니다. Anthropic-compatible Claude response는 /v1/messages로, OpenAI-compatible 흐름은 /v1/responses(또는 /v1/chat/completions)로 들어오며, Pi가 변환을 투명하게 처리합니다.

길고 중요한 refactor에서는 이 패턴이 정말 유용합니다. spec은 GPT-5.5 high로 grill-me, 실행은 GPT-5.5 low, 구조 검토는 Claude Sonnet 4.6으로 한 번, 마무리는 다시 GPT-5.5 low. harness 하나, API key 하나, 청구서 하나입니다.

60초 설정

# 1. pi 설치
curl -fsSL https://pi.dev/install.sh | sh
# 또는:  npm install -g @earendil-works/pi-coding-agent

# 2. smart aipi를 가리키도록 설정
export OPENAI_BASE_URL=https://api.smartaipi.com/v1
export OPENAI_API_KEY=sk-your-smartaipi-key

# 3. repo에서 pi 실행
cd ~/code/your-project
pi

# 4. pi 안에서 skills 설치
/skill:install matt-pocock/skills/grill-me
/skill:install obra/superpowers
/skill:install matt-pocock/skills/caveman

# 5. task를 spec으로 정리
/skill grill-me

# 6. low reasoning으로 낮추고 실행
/model gpt-5.5 --reasoning-effort low
/skill caveman

정확한 skill 설치 구문은 사용하는 skill loader에 따라 다릅니다. 각 skill repo의 README에서 현재 invocation을 확인하세요. 구조는 같습니다. skill folder를 config에 넣고 호출하면 됩니다.

왜 Lean Agent + Lean API가 누적 효과를 내는가

feature-rich harness는 매 turn 큰 system prompt를 올리고, 추가 deliberation pass를 돌리고, 사용자가 원하지 않은 장황한 설명을 내보냅니다. 이 모든 것이 tax입니다. Pi-mono는 harness 쪽 tax를 줄입니다. 작은 system prompt, 네 가지 tool loop, 과도하게 설계된 planning layer 없음. caveman + low reasoning은 model 쪽 tax를 줄입니다. 압축된 output, 최소 reasoning tokens. Smart AIPI는 provider 쪽 tax를 줄입니다. 10배 저렴한 cached input, subscription floor 없음. 이 중 어느 하나만으로는 10배 개선이 아니지만, 함께 곱해지면 장기적인 agentic project 비용이 실제로 달라집니다.

Pi의 관점 — "agent를 workflow에 맞추지, workflow를 agent에 맞추지 말라" — 은 Smart AIPI의 관점 — "실제로 계산한 것만 지불하라" — 와 잘 맞습니다. subscription cap에 막히고 있거나, 전혀 쓰지 않는 harness 기능에 돈을 내고 있었다면, 이 조합은 반나절 시험해 볼 가치가 있습니다. 가입하고 key를 생성한 뒤, OPENAI_BASE_URL을 설정하고, pi를 설치하고, 세 가지 skill을 붙여서, 무언가를 ship하세요.

시작하기 — 가입 시 $5 무료 제공

새 계정마다 무료 API credits $5가 제공됩니다 — credit card 불필요.

$5면 pi를 설치하고, 세 가지 skills를 연결하고, grill-me로 실제 task를 end-to-end로 정리하고, 계속 충전할지 결정하기 전까지 꽤 긴 pi-mono session을 돌려볼 수 있습니다.

가입: smartaipi.com/signup에서 등록합니다(무료 $5, credit card 불필요)
API key 생성: dashboard에서 만듭니다
pi 설치: curl -fsSL https://pi.dev/install.sh | sh
설정: OPENAI_BASE_URL=https://api.smartaipi.com/v1와 OPENAI_API_KEY를 새 key로 지정합니다
설치: grill-me + caveman과 superpowers를 설치합니다
pi 실행: 다음 task를 high reasoning으로 grill-me에 맡기고, low + caveman으로 낮춰 ship합니다

subscription에서 쓰던 동일한 minimalist harness를, 이제는 실제 계산량에 따라 확장되는 pricing model과 긴 agentic session을 사실상 무료에 가깝게 만드는 cache hit rate 위에서 사용하게 됩니다.