pi-claude-code

A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references

Packages

Package details

extensiontheme

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

npm repohome report
$ pi install npm:pi-claude-code
Package
pi-claude-code
Version
0.10.0
Published
Sep 17, 2026
Downloads
249/mo · 8/wk
Author
huantong
License
MIT
Types
extension, theme
Size
13.6 MB
Dependencies
4 dependencies · 3 peers
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/111222333huantong/pi-claude-code/main/assets/readme/preview.png",
  "video": "https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498",
  "themes": [
    "./themes/cc-dark.json",
    "./themes/cc-light.json"
  ],
  "extensions": [
    "./extensions/index.ts"
  ]
}

Security note

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

README

界面预览

https://github.com/user-attachments/assets/6c858000-fdad-43f9-957f-4d0278648498

快速开始

pi install npm:pi-claude-code

# GitHub
pi install git:github.com/111222333huantong/pi-claude-code

安装后执行 /reload

功能

功能 说明 入口
Claude Code UI 工具摘要、折叠展开、rich edit/write diff，以及on / compact / off 三种模式 /ccstyle
Markdown 增强 Mermaid 图、提示框、URL 链接化等 自动生效
Fullscreen mode 工具卡/group 单击展开、双击收起、预览、hover 高亮、回到底部按钮 TUIMODE=fullscreen 或 --tui-mode fullscreen
配置面板 Style / Diff / Thinking / UI / Feature 五页签 /ccstyle
上下文检查 查看上下文占用，并预览 System prompt、Memory、Skills、Tools definition 和消息内容 /context
Session/Subagent 引用 搜索并注入历史 Session 或现有 SubAgent 的有效上下文 @
资源盘点 动画 mascot 启动头 + Loaded 资源面板，常驻查看命令 /loaded
图片粘贴 剪贴板/拖拽图片路径变为第一等附件，历史折叠预览 自动生效
剪贴板粘贴 Ctrl+V 直粘剪贴板图片或文字（仅 Windows），图片自动转附件 自动生效（Windows）
状态栏 两行 footer：model/ctx/cost/mcp/ext + cwd/git，无图标纯文字，主题跟随 /statusline
主题 随包提供内置 CC Dark、CC Light 主题 /theme

本包 fork 自 minuque/pi-cc-extensions（MIT），状态栏及后续改动由本 fork 维护。

配置

/ccstyle 的行为由 ~/.pi/agent/claude-code-style.json 配置：

{
  "mode": "on",                            // on / compact / off
  "excludeRenderers": [],                  // 走原生渲染的工具名；Agent 始终保留专用渲染器

  // diff
  "diffViewMode": "auto",                  // 布局：auto / split / unified
  "diffIndicatorMode": "bars",             // 变更指示：bars / classic / none
  "diffSplitMinWidth": 120,                // 左右分栏的最小终端宽度
  "editDiffCollapsedLines": 24,            // Edit 折叠行数，超出显示展开提示
  "writeDiffCollapsedLines": 0,            // write 折叠行数，0 仅显示创建摘要
  "diffWordWrap": true,                    // 长 diff 行换行

  // thinking
  "useSummaryTitlesAsThinkingTitle": true, // 用最新摘要作思考标题
  "previewLines": 3,                       // 预览内容行数（空行不占窗口），0 隐藏
  "animationIntervalMs": 90,               // 标题动画间隔（毫秒）
  "thinkingExpandedMaxLines": 200,         // 展开先给尾部行数，再推进一次看全文
  "dimThinkingText": false,                // thinking 正文用 dim 色

  // ui
  "expandedInputMaxLines": 5,              // 展开工具卡 Input 可见行数，超出在末行显示展开提示
  "expandedOutputMaxLines": 10,            // 展开工具卡 Output 可见行数，超出在末行显示展开提示
  "expandedPreviewMaxLines": 40,           // 展开 diff/TaskList 正文最大行数
  "inputClip": 100,                        // 工具摘要 path/command 折叠列宽（CJK 计 2 列）
  "showStartupHeader": true,               // 启动头（mascot + tips + Loaded）开关
  "startupAnimation": true,                // 每进程播放一次 mascot 成长动画
  "quietStartup": true,                    // 隐藏原生启动资源列表，下会话生效
  "scrollStepLines": 3,                    // fullscreen 滚轮步进
  "completionBellAfterSec": 0,             // 回合超过 N 秒完成时响铃，0 关闭

  // features
  "enableSessionReference": true,          // @ session 引用
  "enableSubagentAutocomplete": true,      // @ subagent 补全与委派提示
  "enableContextCommand": true,            // /context 上下文检查
  "enableAgentSummary": true,              // 每回合工具摘要
  "enableWorkingMessage": true,            // Working... 底部 token/耗时
  "enableAliases": true,                   // /clear、/exit 别名
  "enableImagePaster": true,               // 图片粘贴：剪贴板/拖拽图片转附件
  "enableClipboardPaste": true             // Ctrl+V 剪贴板粘贴（仅 Windows）
}

状态栏走独立文件 ~/.pi/agent/statusline.json（/statusline 开关，/ccstyle Feature 页亦可切）：

{
  "enabled": true,       // 总闸；false 恢复 Pi 原生 footer
  "showWorktree": true   // L2 是否显示 wt <name>
}

Fullscreen：单击 click to show more 展开工具卡、思考、Skill 和 compact 摘要；展开后 Input/Output 超行时，末行 … +N more lines • click to show more 打开全量预览。双击展开面板收起。

建议：markdown.mermaid 设为 final（~/.pi/agent/settings.json 或 /settings 面板的 Mermaid diagrams 选项）。默认 streaming 逐帧重绘，final 渲染最终版更稳定。

本地开发

npm test
npm run typecheck
./test.bat # or pi -e .

兼容性

  • Node.js >=22.19.0，Pi ^0.84.0

推荐搭配

扩展 用途
npm:@arhen/pi-core-subagent 并行 SubAgent、依赖图调度与工作树隔离（无底部常驻面板）
npm:@tintinweb/pi-tasks Claude Code 风格任务跟踪与协调
npm:pi-mcp-adapter 按需发现 MCP 工具，减少上下文占用
npm:@ff-labs/pi-fff 模糊文件与内容检索（fffind / ffgrep）
npm:pi-web-access 网页搜索、URL 抓取、GitHub 克隆、PDF/视频解析
npm:@narumitw/pi-usage 查看当前账号用量（Codex / Copilot / OpenRouter）
git:github.com/DietrichGebert/ponytail 极简编码：强制最懒但有效的方案

与 @arhen/pi-core-subagent 同屏：subagent 派生调用保留对方自带的计划图渲染（人名标题，无 UUID）；subagent_status/result/await/reply/steer/cancel 走本包工具卡（runId 短 ID + 人名 taskId）。对方的 live widget 在编辑器上方、/subagents peek 按需查看，无底部常驻面板。注意：@tintinweb/pi-tasks 的 TaskExecute 只认 tintinweb 私有 RPC，换 arhen 后降级（任务跟踪照常，派发改口头指令）。用户中断（esc）的工具等待会收敛为 dim 色 Operation aborted，不再复读原文。

致谢