pi coding agent · cskwork

Your pi agent, ready in one command

한 줄이면 pi 에이전트 세팅 완료

15 curated skills, 6 subagent model profiles — four model tiers plus lean two-pack and four-pack gate sets — a friendly-by-default permission policy, and every extension I actually use — versioned in one repo, restorable on any machine.

엄선한 스킬 15종, 서브에이전트 모델 프로필 6종 — 모델 티어 4종과 간결한 two-pack·four-pack 게이트 세트 — 기본은 편하게·위험만 막는 권한 정책, 실제로 쓰는 익스텐션 전부를 하나의 레포에 담아 어떤 머신에서든 복원합니다.

# fresh machine git clone https://github.com/cskwork/pi-setup.git ~/pi-setup ~/pi-setup/install.sh && pi auth

01Curated skills엄선 스킬

Only skills that earn their context. Everything else was cut.

컨텍스트를 값하는 스킬만 남겼습니다. 나머지는 잘라냈습니다.

agent-browser

Browser automation CLI — navigate, fill, screenshot, scrape.

브라우저 자동화 CLI — 탐색·입력·스크린샷·스크래핑.

vercel-labs/agent-browser

impeccable

Frontend design critique, audit, polish — the taste skill.

프론트엔드 디자인 비평·감사·폴리시 — 감각을 담당.

oddxinformatics/impeccable

gpt-image-2

Image generation through your ChatGPT plan via Codex CLI.

ChatGPT 플랜 + Codex CLI로 이미지 생성.

verify

5 verification gates. Never calls a green build "verified".

5단계 검증 게이트. 빌드 성공을 '검증됨'이라 부르지 않음.

cskwork/verify-skill

ego-browser

Agent-friendly browser that shares your logged-in state, zero config.

로그인 상태를 공유하는 에이전트 친화 브라우저, 설정 제로.

citrolabs/ego-lite

call-agent

Route a task to the best peer AI CLI — Codex, agy, Kiro, Claude.

작업에 가장 맞는 동료 AI CLI로 라우팅 — Codex, agy, Kiro, Claude.

cskwork/call-agent

pi-sixpack

Six-role gated pipeline — spec → code → clean → architect ∥ harden → QA, in packs of 2/4/6.

6역할 게이트 파이프라인 — 명세→구현→정리→설계∥강화→QA, 2/4/6 팩.

SwarmForge port

browser-qa

Browser QA on anything — YAML DAG scenarios, engine choice, real API evidence.

어떤 사이트든 브라우저 QA — YAML DAG 시나리오, 엔진 선택, 실제 API 증적.

cskwork/browser-qa

playwright-cli

Drive a browser directly; inspect or author Playwright tests.

브라우저를 직접 조작하고 Playwright 테스트를 검사·작성.

e2e-testing

Playwright E2E patterns — Page Object Model, CI/CD, artifact management.

Playwright E2E 패턴 — POM, CI/CD, 아티팩트 관리.

test-driven-development superpowers

Write the failing test first — every feature, every bugfix.

실패하는 테스트부터 — 모든 기능, 모든 버그 수정.

obra/superpowers

systematic-debugging superpowers

Root-cause discipline before any fix is proposed.

해결책을 제안하기 전 루트 코즈 규율.

obra/superpowers

verification-before-completion superpowers

Evidence before assertions — never claim unverified work done.

주장 전에 증거 — 검증 안 된 일을 끝났다고 말하지 않음.

obra/superpowers

decompose-into-slices

Break a plan into independently-grabbable vertical slices.

계획을 독립적으로 잡을 수 있는 수직 슬라이스로 분해.

find-skills

Discover and install new agent skills on demand.

새 에이전트 스킬을 필요할 때 발견·설치.

Selected agents load their domain skills by default — QA agents get browser-qa, coders get TDD, verifiers get the verify gate. No per-call wiring.

주요 에이전트는 도메인 스킬을 기본으로 로드 — QA엔 browser-qa, 코더엔 TDD, 검증엔 verify 게이트. 호출마다 연결할 필요 없음.

02Permission policy — friendly by default권한 정책 — 기본은 편하게

Feels like stock pi: reads, file tools, skills, search, and normal shell all flow. Rails only where it matters. Your live config stays yours — it's gitignored.

기본 pi처럼 부드럽게 — 읽기·파일 도구·스킬·검색·일반 셸은 막힘 없이. 위험한 곳에만 레일을 둡니다. 실제 설정은 각자 로컬에(gitignore).

  • ✓ Allowreads · find/grep/ls · skills · ctx tools · web · normal bash · curl읽기 · find/grep/ls · 스킬 · ctx 도구 · 웹 · 일반 bash · curl
  • ? Askany rm · sudo · ctx_purge모든 rm · sudo · ctx_purge
  • ✕ Denyrm -rf · reading .env* and ~/.ssh/* (every tool, cross-cutting)rm -rf · .env*와 ~/.ssh/* 읽기(모든 도구에 적용)

03Extensions stack익스텐션 스택

Installed automatically from settings.json.

pi-permission-system

Pattern permissions with TUI modal, review log, fail-closed validation.

pi-goal

Give pi a goal; it keeps working from each settled boundary until done.

pi-usage

Token/cost tracking per session.

pi-subagents

Parallel, scripted, and coordinated subagent workflows.

pi-lens

Real-time code feedback while the agent edits — LSP diagnostics, linters, formatters, type-checks.

glm-vision

GLM-4.6V image understanding for text-only zai models.

pi-background-tasks

Named background shell tasks with durable notifications.

context-mode

Big tool outputs stay out of your context window (FTS5-indexed).

pi-memory (@samfp)

Learns corrections & preferences; injects them into future sessions.

pi-mcp-adapter

MCP servers on-demand, without burning context on tool defs.

pi-web-access

Web search and fetch.

locals

permission-gate · dirty-repo-guard · herdr-agent-state · superset-hooks · ai-memory-pi

04Subagent model profiles서브에이전트 모델 프로필

Swap every gate's model in one command: /subagents-load-profile <name>

명령 하나로 모든 게이트의 모델을 교체합니다: /subagents-load-profile <name>

Gatecodex-onlyclaude-onlymixglm-max
specifiersol · highsonnet-5 · highopus-5 · highglm-5.3 · max
coderluna · maxopus-5 · highcodex sol · highglm-5.3 · max
cleanerluna · xhighhaiku-4-5 · medluna · xhighglm-5.3 · max
sw-architectsol · highopus-5 · highcodex sol · highglm-5.3 · max
hardendersol · highopus-5 · highcodex sol · highglm-5.3 · max
qaluna · xhighsonnet-5 · medglm-5.3 · medglm-5.3 · max

The hardender always gets a top model — it is the only gate that invents its own checks instead of reading a given artifact, and its failure mode is a silent PASS no later gate catches.

hardender에는 항상 최상위 모델을 붙입니다 — 주어진 문서를 읽는 다른 게이트와 달리 검사 항목을 스스로 만들어야 하고, 실패 시 조용히 PASS를 내보내 이후 어느 게이트도 이를 잡지 못하기 때문입니다.

Pack profilestwo-pack and four-pack pin glm-max models to only the gates that pack runs (coder → qa; specifier → coder → refactorer → sw-architect → qa). Role orders mirror the upstream SwarmForge branches; the independent QA gate stays in every pack.

팩 프로필two-packfour-pack은 glm-max 모델을 해당 팩이 돌리는 게이트에만 고정합니다 (coder → qa; specifier → coder → refactorer → sw-architect → qa). 역할 순서는 업스트림 SwarmForge 브랜치를 따르며, 독립 QA 게이트는 모든 팩에 유지됩니다.