pi-cc-extensions

Personal extensions for the Pi coding agent

Packages

Package details

extension

Install pi-cc-extensions from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-cc-extensions
Package
pi-cc-extensions
Version
0.7.4
Published
Jul 22, 2026
Downloads
686/mo · 686/wk
Author
minuque
License
unknown
Types
extension
Size
589.3 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/claude-code-style.ts",
    "./extensions/context.ts",
    "./extensions/session-reference/index.ts",
    "./extensions/agent-autocomplete.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

界面预览

功能

Claude Code 风格界面

extensions/claude-code-style.ts 提供：

  • Claude Code 风格的工具调用行与结果摘要
  • Pi 默认输入栏
  • Edit / Write 的 Diff 预览
  • 工具结果的折叠与展开
  • /ccstyle 配置命令和 Ctrl+Shift+O 快捷键

常用命令：

/ccstyle             # 打开交互式配置面板
/ccstyle on          # 开启
/ccstyle off         # 关闭
/ccstyle status      # 查看状态

上下文窗口查看

extensions/context.ts 注册 /context，展示当前上下文窗口的使用分布，并可进一步预览：

  • System prompt
  • Tools
  • Context files
  • Skills
  • User / assistant messages
  • Tool results
  • Compaction summaries

历史 Session 引用

extensions/session-reference/index.ts 将历史 Session 接入 @ 补全：

  1. 在提示词中输入 @。
  2. 从 [Session] ... 或 [SubAgent] ... 补全项中选择要引用的上下文。
  3. 提交时以 @session:<session-id> 引用其当前有效上下文。

Session 模糊查询默认显示 3 个候选，并与文件候选按 1:2 交错排列；路径型查询优先显示文件。若已加载 pi-subagents，也可直接引用现有 SubAgent。一次提示词可以引用多个 Session；扩展会自动去重，并限制注入规模以避免上下文无限膨胀。更多细节见 extensions/session-reference/README.md。

SubAgent @ 补全

extensions/agent-autocomplete.ts 将 ~/.pi/agent/agents/*.md 中定义的 SubAgent 接入 @ 补全：

  1. 在提示词中输入 @agent-name。
  2. 从补全列表中选择 SubAgent。
  3. 提交后自动注入委托指令；提示词中提到的每个 SubAgent 都会分别交由 Agent 工具处理。

该补全不会占用 @session: 的历史 Session 引用语法；与 @bacnh85/pi-fff 同时启用时，SubAgent、Session 和 FFF 文件候选会合并显示。修改 SubAgent 定义后执行 /reload 即可重新加载。

安装

从 npm 安装（推荐）：

pi install npm:pi-cc-extensions

或从 Git 安装：

pi install git:github.com/minuque/pi-cc-extensions

安装后可以先运行：

/context
/ccstyle on

本地开发

npm test
pi -e .

也可以把当前仓库作为本地 Pi 包安装：

pi install /absolute/path/to/pi-cc-extensions

修改扩展后，在 Pi 中执行：

/reload

兼容性

  • Node.js >=22.19.0
  • 作为 Pi package 加载，入口由根目录 package.json 的 pi.extensions 显式声明