pi-cc-extensions

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

Packages

Package details

extensiontheme

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

npm repohome report
$ pi install npm:pi-cc-extensions
Package
pi-cc-extensions
Version
0.8.49
Published
Aug 8, 2026
Downloads
10.6K/mo · 4,008/wk
Author
minuque
License
MIT
Types
extension, theme
Size
561.2 KB
Dependencies
3 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts"
  ],
  "themes": [
    "./themes/cc-dark.json",
    "./themes/cc-light.json"
  ],
  "image": "https://raw.githubusercontent.com/minuque/pi-cc-extensions/main/assets/readme/welcome.webp",
  "video": "https://github.com/user-attachments/assets/debf76ea-a9dc-4f34-977f-aae344a9a7f8"
}

Security note

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

README

界面预览

快速开始

pi install npm:pi-cc-extensions

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

安装后执行 /reload

功能

功能 说明 入口
Claude Code 风格输出 工具摘要、折叠展开、rich edit/write diff，以及on / off 两种模式 /ccstyle
Fullscreen 鼠标交互 工具卡/group 点击展开与收起、[show more] 预览、hover 高亮、回到底部按钮（tmux/zellij/screen 下自动补开 motion 上报） /ccstyle
配置面板 Style / Diff / Thinking / Feature 四页签，含启动头开关与滚轮步进 /ccstyle
上下文检查 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容 /context
Session 引用 搜索并注入历史 Session 或现有 SubAgent 的有效上下文 @session:
主题 随包提供内置 CC Dark、CC Light 主题 /theme

配置

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

{
  "mode": "on",                            // on：Claude Code 风格输出；off：Pi 原生渲染
  "excludeRenderers": [],                  // 走原生渲染的工具名列表（精确匹配），Agent 始终保留专用渲染器
  "diffViewMode": "auto",                  // diff 布局：auto / split / unified
  "diffIndicatorMode": "bars",             // diff 变更指示：bars / classic / none
  "diffSplitMinWidth": 120,                // 自动布局下使用左右分栏的最小终端宽度
  "diffCollapsedLines": 24,                // 折叠时展示的 diff 行数，超出显示展开提示（Ctrl+O / 点击）
  "diffWordWrap": true,                    // 长 diff 行是否换行（否则截断）
  "expandedPreviewMaxLines": 40,           // 展开后输出/diff 正文的最大行数
  "useSummaryTitlesAsThinkingTitle": true, // 用最新 provider 摘要作为思考标题
  "previewLines": 3,                       // thinking 预览行数，0 隐藏预览正文
  "animationIntervalMs": 90,               // thinking 标题动画间隔（毫秒）
  "showStartupHeader": true,               // 自定义启动头（logo + tips）开关
  "scrollStepLines": 3                     // fullscreen 滚轮滚动步进行数
}

本地开发

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

修改扩展后执行 /reload。

兼容性

  • Node.js >=22.19.0，Pi ^0.84.0（通过根目录 package.json 的 pi.extensions 和 pi.themes 加载）
  • fixed-editor相关功能已平滑迁移至官方管线：TUI mode=fullscreen 模式下 /ccstyle 全部鼠标交互功能类照常可用。
  • 需要已移除的 fixed-editor 布局或 compact 单行摘要模式？请使用 0.8.46 及更早版本
  • 已移除：固定编辑器布局与 compact 单行摘要模式（后续会有新版本 compact mode 发布）。旧配置 mode: "compact" 自动回退 on，/ccstyle 面板仅有 on / off。

推荐搭配

扩展 用途
npm:@tintinweb/pi-subagents 并行 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:pi-theme-picker 主题搜索和实时预览
npm:@narumitw/pi-usage 查看当前账号用量（Codex / Copilot / OpenRouter）
git:github.com/DietrichGebert/ponytail 极简编码：强制最懒但有效的方案

致谢