Claude Code-style TUI output with some personal touches and handy utilities.
简体中文 · English
---
## Preview
## Quick start
```bash
pi install npm:@herbertgao/pi-cc-extensions
```
Run `/reload` after installation.
## Features
| Feature | Description | Entry point |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| Claude Code Output | Tool summaries, expand/collapse, rich edit/write diffs, and `on` / `compact` / `off` modes | `/ccstyle` |
| Fullscreen mode | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
| Settings panel | `Style / Diff / Thinking / UI / Feature` tabs with startup, wheel, and optional feature toggles | `/ccstyle` |
| Context inspection | Usage breakdown and previews for the system prompt, memory, tools, tool results, skills, and messages | `/context` |
| Session/Subagent references | Search and inject effective context from previous Sessions or existing SubAgents | `@` |
| Theme | Bundled CC Dark and CC Light themes | `/theme` |
## Configuration
`/ccstyle` behavior is configured through `~/.pi/agent/claude-code-style.json`:
```js
{
"mode": "on", // on: Claude Code style; compact: one-line summaries; off: Pi native rendering
"excludeRenderers": [], // exact tool names that keep their native renderer; Agent always keeps its dedicated renderer
"diffViewMode": "auto", // diff layout: auto / split / unified
"diffIndicatorMode": "bars", // diff change indicators: bars / classic / none
"diffSplitMinWidth": 120, // min terminal width before auto layout uses side-by-side columns
"editDiffCollapsedLines": 24, // diff body lines shown when collapsed; beyond that shows the expand hint (Ctrl+O / click)
"diffWordWrap": true, // whether long diff lines wrap (otherwise truncated)
"expandedPreviewMaxLines": 40, // max body lines for expanded output/diff
"useSummaryTitlesAsThinkingTitle": true, // use the latest provider summary as the active thinking title
"previewLines": 3, // thinking preview lines; 0 hides the preview body
"animationIntervalMs": 90, // thinking title animation interval in ms
"dimThinkingText": false, // dim thinking body text
"showStartupHeader": true, // custom startup header (logo + tips) toggle
"scrollStepLines": 3, // fullscreen mouse wheel scroll lines
"enableSessionReference": true, // @ session references
"enableSubagentAutocomplete": true, // @ subagent autocomplete
"enableContextCommand": true, // /context inspection
"enableAgentSummary": true, // per-turn tool summary
"enableWorkingMessage": true, // Working... token/time details
"enableAliases": true // /clear and /exit aliases
}
```
> **Tip**: set Mermaid diagrams to `final` in `/settings` to avoid redrawing streaming content frame by frame.
## Local development
```bash
bun run test
bun run typecheck
./test.bat # or pi -e .
```
## Compatibility
- Node.js `>=22.19.0`, Pi `^0.84.0 || ^0.85.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
## Recommended companions
| Extension | Purpose |
| ------------------------------------------ | -------------------------------------------------------------- |
| `npm:@tintinweb/pi-subagents` | Parallel SubAgents, background tasks, and worktree isolation |
| `npm:@tintinweb/pi-tasks` | Claude Code-style task tracking and coordination |
| `npm:pi-mcp-adapter` | On-demand MCP tool discovery with lower context usage |
| `npm:@ff-labs/pi-fff` | FFF-powered fuzzy file and content search (fffind / ffgrep) |
| `npm:pi-web-access` | Web search, URL fetching, GitHub cloning, PDF/video parsing |
| `npm:pi-theme-picker` | Theme search and live preview |
| `npm:@narumitw/pi-usage` | Current-account usage for Codex / Copilot / OpenRouter |
| `git:github.com/DietrichGebert/ponytail` | Lazy-mode coding: forces the simplest working solution |
## Credits
- Derived from [`minuque/pi-cc-extensions` v0.8.68](https://github.com/minuque/pi-cc-extensions/releases/tag/v0.8.68) (`1ca144c`) under the MIT license.
- Rich diffs are adapted from [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display) (MIT). See [`extensions/renderer/tool/diff/ATTRIBUTION.md`](./extensions/renderer/tool/diff/ATTRIBUTION.md).