Repolode
Submit
xiaomoBoy

xiaomoBoy/pi-bluebook

A non-official Chinese learning handbook for the Pi Coding Agent terminal harness, covering setup through Skills, Extensions, Subagents and long-running workflows.

View on GitHubWebsite
Stars
321
Forks
20
Open issues
0
Last commit
9 days ago

What is it?

Pi Bluebook is a community-written Chinese tutorial for Pi, a minimal terminal coding agent harness. It starts with installation, login and model setup, then walks through a first task that the reader checks by hand, rather than starting from a feature list.

The course is organized in modules covering sessions and file context, context windows and compaction, the difference between Skills, Extensions and Packages, delegating work to subagents, and running long tasks with permissions, isolation and recovery. It provides macOS instructions and a separate Windows path using Git Bash, and includes reference pages, practice cases and a version archive of Pi's official changelog.

The site is built with VitePress and bilingual content is generated for Traditional Chinese. It is unofficial and not affiliated with the Pi project.

Key features

  • 01Step-by-step course from installation to a first verifiable task
  • 02Covers Sessions, context compaction, Skills, Extensions and Packages
  • 03Separate macOS and Windows Git Bash setup paths
  • 04Reference index and practice cases for each module
  • 05Searchable archive of Pi's official changelog

Use cases

  • Chinese-speaking developers who are new to terminal coding agents and want a guided start
  • Teams onboarding members to Pi with a shared, verifiable exercise path
  • Users who want to learn how to extend Pi with Skills and Extensions

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/xiaomoBoy/pi-bluebook.git
  2. 2

    Enter the project folder

    cd pi-bluebook
  3. 3

    Install dependencies

    npm ci
  4. 4

    Start the local preview and open the address shown in the terminal

    npm run docs:dev

Things to know

  • This is an unofficial community handbook and is not affiliated with the Pi project.
  • The site preview needs Node.js 22, and the Windows real-interface screenshots are not yet verified.
  • Some dynamic details such as versions and commands may change, so check the official Pi docs.

Topics

#ai-agent#coding-agent#tutorial#chinese#learning-path#agent-skills#context-engineering#agent-harness#pi#pi-agent

FAQ

What is pi-bluebook?
A non-official Chinese learning handbook for the Pi Coding Agent terminal harness, covering setup through Skills, Extensions, Subagents and long-running workflows. Pi Bluebook is a community-written Chinese tutorial for Pi, a minimal terminal coding agent harness. It starts with installation, login and model setup, then walks through a first task that the reader checks by hand, rather than starting from a feature list.
Is pi-bluebook free to use? What license does it have?
pi-bluebook is open source under the MIT license. Check the license terms before using it in commercial products.
Is pi-bluebook still maintained?
Actively maintained. The last commit to pi-bluebook was on Oct 11, 2026.
What can I use pi-bluebook for?
Chinese-speaking developers who are new to terminal coding agents and want a guided start Teams onboarding members to Pi with a shared, verifiable exercise path Users who want to learn how to extend Pi with Skills and Extensions
How do I install pi-bluebook?
Clone the repository: git clone https://github.com/xiaomoBoy/pi-bluebook.git Enter the project folder: cd pi-bluebook Install dependencies: npm ci Start the local preview and open the address shown in the terminal: npm run docs:dev
Where can I get pi-bluebook?
The source code and installation instructions are on GitHub: https://github.com/xiaomoBoy/pi-bluebook

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects