AI Agent Harness · Earendil

Pi Coding Agent
Cheat Sheet

“There are many agent harnesses but this one is yours.” Pi là minimal agent harness — chỉnh sửa harness cho hợp workflow của bạn, không phải ngược lại. 15+ providers, tree-structured sessions, tự sửa chính nó bằng /reload.

Open source · MIT
Tổng quan

Pi là gì?

Một terminal coding harness tối giản, mở rộng bằng TypeScript modules. Pi cố tình bỏ MCP, sub-agents, permission popup, plan mode, to-dos hay background bash — thay vào đó bạn tự lắp qua extensions, skills, prompt templates, themes. Chạy 4 chế độ: interactive TUI, print, JSON stream, RPC — hoặc nhúng thẳng bằng SDK.

1

Harness của bạn

Extensions, skills, prompt templates & themes. “Change the harness, not your workflow.” Tự sửa chính nó tại chỗ với /reload.

2

15+ providers

Anthropic, OpenAI, Google, Azure, Bedrock, Mistral, Groq, Cerebras, xAI, Hugging Face… Đổi model giữa session bằng Ctrl+L. Local model qua llama.cpp.

3

Tree-structured sessions

Lịch sử dạng cây, quay về bất kỳ điểm nào với /tree, fork/clone nhánh, export HTML/JSONL, share qua GitHub gist.

4

4 chế độ vận hành

Interactive TUI, print (-p), JSON event stream, RPC over stdin/stdout — và SDK để nhúng vào app.

Getting Started

Quick Start

1

Install (Linux/macOS/WSL2)

curl -fsSL https://pi.dev/install.sh | sh

Hoặc qua npm/pnpm/bun: npm install -g --ignore-scripts @earendil-works/pi-coding-agent

2

Authenticate

pi
# trong TUI:
/login

/login cho provider dạng subscription/OAuth, hoặc set API key: export ANTHROPIC_API_KEY=sk-ant-...

3

Launch

pi "List all .ts files in src/"

Không tham số → interactive TUI. Kèm prompt → chạy ngay. pi -p để print & exit.

Reference

CLI Flags & Options

Modes

pi "prompt"Interactive TUI (hoặc chạy ngay nếu có prompt)
-p, --printPrint response rồi thoát
--mode jsonXuất mọi event dạng JSON lines
--mode rpcRPC over stdin/stdout
--tui-mode <m>regular · fullscreen

Model selection

--provider <name>anthropic · openai · google…
--model <pattern>provider/id, hỗ trợ :thinking
--models <list>Patterns cho Ctrl+P cycling
--thinking <lvl>off·minimal·low·medium·high·xhigh·max
--api-key <key>Ghi đè biến môi trường
--list-models [q]Liệt kê model khả dụng

Sessions

-c, --continueTiếp session gần nhất
-r, --resumeChọn session để mở lại
--session <id>Mở session theo file/UUID
--fork <id>Fork session sang session mới
--no-sessionEphemeral, không lưu
-n, --name <s>Đặt tên hiển thị

Tools & resources

-t, --tools <l>Allowlist tool cụ thể
-xt, --exclude-toolsTắt tool cụ thể
-nt, --no-toolsTắt toàn bộ tool
-e, --extension <s>Load extension: path·npm·git
--skill <path>Load skill file
-nc, --no-context-filesBỏ qua AGENTS.md / CLAUDE.md

System prompt

--system-prompt <t>Thay system prompt mặc định
--append-system-promptNối thêm vào system prompt
-a, --approveTrust file project-local cho lần chạy
-v, --versionHiện phiên bản

Package commands

pi install <src>Cài package (extension/skill/theme)
pi remove <src>Gỡ package
pi update [src|self]Cập nhật package hoặc chính pi
pi configBật/tắt resource
pi listLiệt kê package đã cài
In-session

Slash Commands

Model & auth

/login Quản lý OAuth / API-key
/logoutĐăng xuất credential
/modelĐổi model
/scoped-modelsBật/tắt model cho Ctrl+P
/llamaTải/load/unload model llama.cpp
/settingsThinking, theme, transport…

Sessions & history

/newSession mới
/resumeChọn session cũ
/treeNhảy tới điểm bất kỳ & tiếp tục
/forkTạo session từ 1 user message
/cloneNhân bản nhánh đang active
/name <name>Đặt tên session
/sessionFile, ID, tokens, cost

Context & export

/compact [prompt]Nén context, kèm chỉ dẫn tùy chọn
/copyCopy message cuối của assistant
/export [file]Xuất session ra HTML/JSONL
/import <file>Import & resume từ JSONL
/shareUpload private gist + link HTML

Utilities

/reloadNạp lại keybindings·ext·skills·prompt·theme·context
/trustLưu quyết định trust cho project
/hotkeysXem mọi phím tắt
/changelogLịch sử phiên bản
/quitThoát
Reference

Keybindings

Tùy chỉnh tại ~/.pi/agent/keybindings.json, rồi /reload để áp dụng không cần khởi động lại. Xem nhanh với /hotkeys.

Models & thinking

Ctrl+LMở model selector
Ctrl+PModel kế tiếp
Shift+Ctrl+PModel trước đó
Shift+TabĐổi mức thinking
Ctrl+TẨn/hiện thinking blocks

Input & submit

EnterGửi
Shift+Enter / Ctrl+JXuống dòng
TabAutocomplete
Alt+EnterXếp hàng follow-up
Ctrl+GMở external editor
Ctrl+VDán ảnh

Display & tree

Ctrl+OMở/gấp tool output
Ctrl+XCopy message cuối
Ctrl+←/→Fold/unfold, nhảy node cây
Shift+LSửa nhãn node
Shift+TBật/tắt timestamps
EscHủy / abort
Config

Cấu hình & mở rộng

ProvidersAuth

/login cho OAuth/subscription, hoặc set env như ANTHROPIC_API_KEY, OPENAI_API_KEY. Custom provider & custom model đều hỗ trợ.

Context filesProject

Pi tự đọc AGENTS.md / CLAUDE.md trong project làm chỉ dẫn. Auto-compaction giữ context gọn. Tắt bằng -nc.

ExtensionsTS module

Nạp dynamic context, tool, hành vi mới từ path · npm · git. -e khi chạy, hoặc pi install để cài cố định.

SkillsReusable

Đóng gói know-how thành skill file, load bằng --skill. Discovery tự động, tắt bằng --no-skills.

Prompt templatesReuse

Prompt tái dùng qua --prompt-template hoặc pi @prompt.md. Đính kèm file/ảnh: pi @code.ts @img.png.

Themes & packagesCustomize

Đổi giao diện với --theme / --use-theme. Quản lý mọi thứ bằng pi install/remove/update/config/list.

Bảo mật: mặc định Pi chạy với quyền của user. Cần cô lập mạnh hơn thì dùng containerization — Gondolin (micro-VM), Docker, hoặc OpenShell sandbox.

Examples

Dùng thực tế

pi — coding agent
# Print mode — pipe & thoát
$cat README.md | pi -p "Summarize this text"
# Chọn provider/model + mức thinking
$pi --model sonnet:high "Solve this complex problem"
# Đính kèm ảnh cho vision
$pi -p @screenshot.png "What's in this image?"
# Allowlist tool, audit không side-effect
$pi --tools read,grep,find,ls -p "Review the code"
# Trong TUI: đổi model & quay lại điểm cũ
/model
/tree
Resources

Tài liệu & cộng đồng

WebsiteHome

Landing + installer + tổng quan tính năng.

pi.dev
Official DocsRead

Quickstart, providers, extensions, SDK, RPC, session format.

pi.dev/docs/latest
GitHubSource

Mã nguồn, issues, RFCs. Packages: pi-ai · pi-agent-core · pi-coding-agent · pi-tui.

github.com/earendil-works/pi
Install one-linerQuick

Cài nhanh trên Linux/macOS/WSL2.

curl -fsSL https://pi.dev/install.sh | sh