Sử dụng Pi

Trang này thu thập các chi tiết sử dụng hàng ngày không phù hợp trên trang bắt đầu nhanh.

Giao diện có 4 khu vực chính:

• Tiêu đề khởi động - phím tắt, đã tải context files, prompt templates, kỹ năng và tiện ích mở rộng
• Tin nhắn - tin nhắn của người dùng, phản hồi của trợ lý, cuộc gọi công cụ, kết quả công cụ, thông báo, lỗi và giao diện người dùng tiện ích mở rộng
• Trình chỉnh sửa - nơi bạn nhập; màu đường viền cho biết mức độ suy nghĩ hiện tại
• Chân trang - thư mục làm việc, tên phiên, mức sử dụng mã thông báo/bộ đệm, chi phí, mức sử dụng ngữ cảnh và mô hình hiện tại. Tổng số bao gồm các phản hồi của trợ lý, mức sử dụng được báo cáo bởi các công cụ và tạo bản tóm tắt.

Trình chỉnh sửa có thể được thay thế tạm thời bằng giao diện người dùng tích hợp như /settings hoặc bằng giao diện người dùng tiện ích mở rộng tùy chỉnh.

Tính năng	Làm sao
Tham chiếu tập tin	Nhập @ để tìm kiếm mờ các tệp dự án
Hoàn thành đường dẫn	Nhấn Tab để hoàn thành đường dẫn
Đầu vào nhiều dòng	Shift+Enter hoặc Ctrl+Enter trên Windows Terminal
Sao chép phản hồi	Ctrl+X sao chép tin nhắn trợ lý cuối cùng; trong /tree, nó sao chép tin nhắn đã chọn
Hình ảnh	Dán bằng Ctrl+V, Alt+V trên Windows hoặc kéo vào terminal
Lệnh vỏ	!command chạy và gửi đầu ra cho mô hình
Lệnh shell ẩn	!!command chạy mà không gửi đầu ra tới mô hình
Trình chỉnh sửa bên ngoài	Ctrl+G mở externalEditor, $VISUAL, $EDITOR, Notepad trên Windows hoặc nano ở nơi khác

Xem Keybindings để biết tất cả các phím tắt và tùy chỉnh.

Nhập / vào trình chỉnh sửa để mở lệnh hoàn thành. Extensions có thể đăng ký các lệnh tùy chỉnh, các kỹ năng có sẵn dưới dạng /skill:name và prompt templates mở rộng thông qua /templatename.

Yêu cầu	Sự miêu tả
/login, /logout	Quản lý thông tin xác thực khóa OAuth hoặc API
/llama	Tải xuống, tải và dỡ bỏ các mô hình bộ định tuyến llama.cpp
/model	Chuyển đổi mô hình
/scoped-models	Bật/tắt các mô hình cho chu trình Ctrl+P
/settings	Mức độ tư duy, chủ đề, truyền tải thông điệp, vận chuyển
/resume	Pick từ các phiên trước
/new	Bắt đầu một phiên mới
/name <name>	Đặt tên hiển thị phiên
/session	Hiển thị tệp phiên, ID, tin nhắn, mã thông báo và chi phí
/tree	Chuyển đến bất kỳ điểm nào trong phiên và tiếp tục từ đó
/trust	Lưu quyết định tin cậy của dự án cho các phiên trong tương lai
/fork	Tạo phiên mới từ tin nhắn của người dùng trước đó
/clone	Sao chép nhánh hoạt động hiện tại vào một phiên mới
/compact [prompt]	Ngữ cảnh thu gọn thủ công, tùy chọn với hướng dẫn tùy chỉnh
/copy	Sao chép tin nhắn trợ lý cuối cùng vào clipboard
/export [file]	Xuất phiên sang HTML hoặc JSONL
/import <file>	Nhập và tiếp tục phiên từ tệp JSONL
/share	Tải lên dưới dạng riêng tư GitHub ý chính với liên kết HTML có thể chia sẻ
/reload	Tải lại các tổ hợp phím, tiện ích mở rộng, kỹ năng, lời nhắc, chủ đề và context files
/hotkeys	Hiển thị tất cả các phím tắt
/changelog	Hiển thị lịch sử phiên bản
/quit	Thoát khỏi pi

Bạn có thể gửi tin nhắn trong khi đại lý vẫn đang làm việc:

• Enter xếp hàng đợi một thông báo chỉ đạo, được gửi sau khi lượt trợ lý hiện tại hoàn tất việc thực hiện các lệnh gọi công cụ của nó.
• Alt+Enter xếp hàng tin nhắn tiếp theo, được gửi sau khi tổng đài viên hoàn thành mọi công việc.
• Escape hủy bỏ và khôi phục các tin nhắn đã xếp hàng đợi cho trình chỉnh sửa.
• Alt+Up truy xuất các thư đã xếp hàng đợi trở lại trình chỉnh sửa.

Trên Windows Terminal, Alt+Enter ở chế độ toàn màn hình theo mặc định. Ánh xạ lại nó như được mô tả trong Terminal setup nếu bạn muốn pi nhận phím tắt.

Định cấu hình phân phối trong Settings với steeringMode và followUpMode.

Các phiên được lưu tự động vào ~/.pi/agent/sessions/, được sắp xếp theo thư mục làm việc.

pi -c                  # Continue most recent session
pi -r                  # Browse and select a session
pi --no-session        # Ephemeral mode; do not save
pi --name "my task"    # Set session display name at startup
pi --session <path|id> # Use a specific session file or session ID
pi --fork <path|id>    # Fork a session into a new session file

Các lệnh phiên hữu ích:

• /session hiển thị tệp và ID phiên hiện tại.
• /tree điều hướng session tree trong tệp và có thể tóm tắt các nhánh bị bỏ rơi.
• /fork tạo phiên mới từ tin nhắn của người dùng trước đó.
• /clone sao chép nhánh đang hoạt động hiện tại vào một tệp phiên mới.
• /compact tóm tắt các tin nhắn cũ hơn theo ngữ cảnh miễn phí.

Xem Sessions và Compaction để biết chi tiết.

Pi tải AGENTS.md hoặc CLAUDE.md khi khởi động từ:

• ~/.pi/agent/AGENTS.md để được hướng dẫn chung
• thư mục mẹ, đi lên từ thư mục làm việc hiện tại
• thư mục hiện tại

Nếu thư mục chứa AGENTS.override.md, Pi sẽ tải thư mục đó thay vì AGENTS.md hoặc CLAUDE.md từ thư mục đó. Các tập tin ngữ cảnh từ các thư mục khác vẫn xếp lớp bình thường.

Sử dụng context files cho các quy ước, lệnh, quy tắc an toàn và tùy chọn của dự án. Vô hiệu hóa tải bằng --no-context-files hoặc -nc.

Thay thế lời nhắc hệ thống mặc định bằng:

• .pi/SYSTEM.md cho một dự án
• ~/.pi/agent/SYSTEM.md trên toàn cầu

Thêm vào lời nhắc mặc định mà không thay thế nó bằng APPEND_SYSTEM.md ở một trong hai vị trí.

Khi khởi động tương tác, pi hỏi trước khi tin cậy một thư mục dự án có chứa các cài đặt, tài nguyên hoặc dự án cục bộ của dự án .agents/skills và không có quyết định nào được lưu cho thư mục hoặc thư mục mẹ trong ~/.pi/agent/trust.json. Tin tưởng vào một dự án cho phép pi tải tài nguyên .pi/settings.json và .pi, cài đặt các gói dự án bị thiếu và thực hiện các phần mở rộng dự án.

Trước khi có quyết định tin cậy, pi chỉ tải context files, tiện ích mở rộng người dùng/toàn cầu và tiện ích mở rộng CLI -e để chúng có thể xử lý sự kiện project_trust. Tiện ích mở rộng dự án cục bộ, tiện ích mở rộng được quản lý gói dự án và cài đặt dự án chỉ được tải sau khi dự án được tin cậy. Sự phân chia này cũng áp dụng khi chuyển sang một phiên từ một cwd khác mà sự tin cậy chưa được giải quyết trong quy trình hiện tại.

Các chế độ không tương tác (-p, --mode json và --mode rpc) không hiển thị lời nhắc tin cậy. Nếu không có quyết định tin cậy đã lưu hiện hành, họ sẽ sử dụng defaultProjectTrust từ cài đặt chung: ask (mặc định) và never bỏ qua các tài nguyên dự án đó, trong khi always tin cậy chúng. Vượt qua --approve/-a hoặc --no-approve/-na để ghi đè độ tin cậy của dự án trong một lần chạy.

Nếu không áp dụng tiện ích mở rộng hoặc quyết định đã lưu, defaultProjectTrust sẽ kiểm soát hành vi dự phòng. Đặt thành "ask", "always" hoặc "never" trong ~/.pi/agent/settings.json hoặc thay đổi bằng /settings.

pi config và các lệnh gói sử dụng cùng một luồng tin cậy của dự án, ngoại trừ pi update không bao giờ nhắc. Chuyển --approve để tin cậy cài đặt dự án cục bộ cho một lệnh hoặc --no-approve để bỏ qua chúng.

Sử dụng /trust trong chế độ tương tác để lưu quyết định tin cậy dự án cho các phiên trong tương lai, bao gồm cả tin cậy cho thư mục mẹ trực tiếp. Nó chỉ viết ~/.pi/agent/trust.json; phiên hiện tại không được tải lại, vì vậy hãy khởi động lại pi để các thay đổi có hiệu lực.

Sử dụng /export [file] để viết phiên sang HTML.

Sử dụng /share để tải lên ý chính GitHub riêng tư kèm theo liên kết HTML có thể chia sẻ.

Nếu bạn sử dụng pi cho công việc nguồn mở và muốn xuất bản các phiên dành cho nghiên cứu mô hình, lời nhắc, công cụ và đánh giá, hãy xem badlogic/pi-share-hf. Nó xuất bản các phiên tới tập dữ liệu Hugging Face.

pi [options] [@files...] [messages...]

pi install <source> [-l]     # Install package, -l for project-local
pi remove <source> [-l]      # Remove package
pi uninstall <source> [-l]   # Alias for remove
pi update [source|self|pi]   # Update pi only, or one package source
pi update --all              # Update pi and packages; reconcile pinned git refs
pi update --extensions       # Update packages only; reconcile pinned git refs
pi update --models           # Refresh model catalogs only
pi update --self             # Update pi only
pi update --extension <src>  # Update one package
pi list                      # List installed packages
pi config                    # Enable/disable package resources

Các lệnh này quản lý các gói pi và pi update có thể cập nhật cài đặt pi CLI. Để gỡ cài đặt pi, hãy xem Quickstart. pi config và các lệnh gói dự án chấp nhận --approve/--no-approve để tin cậy hoặc bỏ qua cài đặt dự án cục bộ cho một lệnh. pi update không bao giờ nhắc nhở về sự tin tưởng vào dự án.

Xem Pi Packages để biết nguồn gói và ghi chú bảo mật.

Lá cờ	Sự miêu tả
mặc định	Chế độ tương tác
-p, --print	In phản hồi và thoát
--mode json	Xuất tất cả các sự kiện dưới dạng dòng JSON; xem JSON mode
--mode rpc	chế độ RPC trên stdin/stdout; xem RPC mode
--export <in> [out]	Xuất phiên sang HTML

Ở chế độ in, pi cũng đọc piped stdin và hợp nhất nó vào dấu nhắc ban đầu:

cat README.md | pi -p "Summarize this text"

Lựa chọn	Sự miêu tả
--provider <name>	Nhà cung cấp, chẳng hạn như anthropic, openai hoặc google
--model <pattern>	Mẫu hoặc ID mẫu; hỗ trợ provider/id và tùy chọn :<thinking>
--api-key <key>	API key, ghi đè các biến môi trường
--thinking <level>	off, minimal, low, medium, high, xhigh, max
--models <patterns>	Các mẫu được phân tách bằng dấu phẩy để đạp xe Ctrl+P
--list-models [search]	Liệt kê các mẫu có sẵn

Lựa chọn	Sự miêu tả
-c, --continue	Tiếp tục phiên gần đây nhất
-r, --resume	Duyệt và chọn một phiên
`--phiên <đường dẫn\	id>`
`--fork <đường dẫn\	id>`
--session-dir <dir>	Thư mục lưu trữ phiên tùy chỉnh
--no-session	Chế độ phù du; không lưu
--name <name>, -n <name>	Đặt tên hiển thị phiên khi khởi động

Lựa chọn	Sự miêu tả
--tools <list>, -t <list>	Các công cụ tùy chỉnh, tiện ích mở rộng và tích hợp cụ thể trong danh sách cho phép
--exclude-tools <list>, -xt <list>	Vô hiệu hóa các công cụ tích hợp, tiện ích mở rộng và tùy chỉnh cụ thể
--no-builtin-tools, -nbt	Tắt các công cụ tích hợp nhưng vẫn bật công cụ mở rộng/tùy chỉnh
--no-tools, -nt	Vô hiệu hóa tất cả các công cụ

Các công cụ tích hợp: read, bash, edit, write, grep, find, ls.

Lựa chọn	Sự miêu tả
-e, --extension <source>	Tải tiện ích mở rộng từ đường dẫn, npm hoặc git; có thể lặp lại
--no-extensions	Tắt tính năng khám phá tiện ích mở rộng
--skill <path>	Tải một kỹ năng; có thể lặp lại
--no-skills	Vô hiệu hóa khám phá kỹ năng
--prompt-template <path>	Tải mẫu lời nhắc; có thể lặp lại
--no-prompt-templates	Tắt tính năng khám phá mẫu lời nhắc
--theme <path>	Tải một chủ đề; có thể lặp lại
--no-themes	Tắt tính năng khám phá chủ đề
--no-context-files, -nc	Tắt tính năng khám phá AGENTS.md và CLAUDE.md

Kết hợp --no-* với các cờ rõ ràng để tải chính xác những gì bạn cần, bỏ qua cài đặt. Ví dụ:

pi --no-extensions -e ./my-extension.ts

Lựa chọn	Sự miêu tả
--system-prompt <text>	Thay thế lời nhắc mặc định; context files và các kỹ năng vẫn được bổ sung
--append-system-prompt <text>	Nối vào lời nhắc hệ thống
--tui-mode <mode>	Chế độ TUI: regular (mặc định) hoặc thử nghiệm fullscreen
--verbose	Buộc khởi động dài dòng
-a, --approve	Tin cậy các tệp dự án cục bộ cho lần chạy này
-na, --no-approve	Bỏ qua các tệp dự án cục bộ cho lần chạy này
-h, --help	Hiển thị trợ giúp
-v, --version	Hiển thị phiên bản

Ở chế độ fullscreen, bản ghi cuộn bên trong khung nhìn thiết bị đầu cuối trong khi các tin nhắn được xếp hàng đợi, trạng thái làm việc, tiện ích mở rộng, trình chỉnh sửa và chân trang vẫn cố định ở dưới cùng. Đầu vào chuột/bàn di chuột sẽ cuộn vùng bên dưới con trỏ; các thao tác trên khung nhìn bàn phím luôn có sẵn. Hình ảnh nội tuyến hoạt động trong các thiết bị đầu cuối hỗ trợ giao thức đồ họa Kitty, bao gồm Kitty và Ghostty. Trong iTerm2, chúng hiển thị dưới dạng phần giữ chỗ văn bản vì giao thức hình ảnh nội tuyến của nó không thể xóa hoặc cắt bớt các vị trí trong quá trình cuộn do ứng dụng sở hữu. Ở chế độ regular, pi sử dụng màn hình chính và cuộn ngược do thiết bị đầu cuối sở hữu, đồng thời hình ảnh nội tuyến iTerm2 tiếp tục hiển thị bình thường.

Đặt TUI chế độ trong /settings để chuyển đổi ngay lập tức giữa regular và fullscreen và chọn chế độ mặc định cho các phiên trong tương lai. Đầu ra thoát toàn màn hình kiểm soát việc thoát toàn màn hình sẽ in bản ghi cuối cùng hay khôi phục màn hình trước đó và chỉ in gợi ý tiếp tục phiên.

Các tệp tiền tố có @ để đưa chúng vào tin nhắn:

pi @prompt.md "Answer this"
pi -p @screenshot.png "What's in this image?"
pi @code.ts @test.ts "Review these files"

# Interactive with initial prompt
pi "List all .ts files in src/"

# Non-interactive
pi -p "Summarize this codebase"

# Non-interactive with piped stdin
cat README.md | pi -p "Summarize this text"

# Named one-shot session
pi --name "release audit" -p "Audit this repository"

# Different model
pi --provider openai --model gpt-4o "Help me refactor"

# Model with provider prefix
pi --model openai/gpt-4o "Help me refactor"

# Model with thinking level shorthand
pi --model sonnet:high "Solve this complex problem"

# Limit model cycling
pi --models "claude-*,gpt-4o"

# Read-only mode
pi --tools read,grep,find,ls -p "Review the code"

# Disable one extension or built-in tool while keeping the rest available
pi --exclude-tools ask_question

Pi giữ cốt lõi ở mức nhỏ và đẩy hành vi dành riêng cho quy trình công việc thành các phần mở rộng, kỹ năng, prompt templates và gói.

Nó cố ý không bao gồm MCP tích hợp, tác nhân phụ, cửa sổ bật lên cấp phép, chế độ kế hoạch, việc cần làm hoặc nền bash. Bạn có thể xây dựng hoặc cài đặt các quy trình công việc đó dưới dạng tiện ích mở rộng hoặc gói hoặc sử dụng các công cụ bên ngoài như vùng chứa và tmux.

Để biết lý do đầy đủ, hãy đọc blog post.