decorated-pi

decorated-pi is a practical enhancement pack for Pi.

Install

pi install npm:decorated-pi
pi install git:github.com/lcwecker/decorated-pi
pi install /path/to/decorated-pi

Features

1. Patch Tool

Replaces Pi's built-in edit / write with a stronger patch tool:

• anchor mechanism — narrows the search range by specifying a unique string that appears before old_str, preventing mismatches in files with repeated patterns
• mtime tracking — records file modification time on read, rejects patch if the file changed since last read, preventing blind or stale edits
• explicit overwrite — offer atomic overwrite: true mode for overwrite files or full-file creation to prevent unintened overwrite

2. Secret redaction

Three-layer detection: high-confidence known-format patterns (AWS, GitHub, OpenAI, etc.), config-key regex matching, and adjusted Shannon entropy heuristics for unknown secret-like values.

3. Built-in MCP Client

Zero-config MCP client with two built-in servers:

Server	Tool Prefix	Source
Context7	context7_*	https://mcp.context7.com/mcp
Exa	exa_*	https://mcp.exa.ai/mcp

Project-level config — add custom MCP servers by placing an mcp.json or .mcp.json (also .pi/mcp.json, .agents/mcp.json, .claude/mcp.json and their .-prefixed variants) anywhere in your project tree. Servers found closer to cwd take precedence over ancestor directories.

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-mcp.example.com/mcp",
      "enabled": true
    }
  }
}

Global config — persist custom servers in ~/.pi/agent/decorated-pi.json:

{
  "mcpServers": {
    "my-server": { "url": "https://my-mcp.example.com/mcp" }
  }
}

Priority: project > global > builtin. A server with the same name from a higher-priority source overrides lower ones.

Use /mcp to view connection status and registered tools.

4. Auxiliary Models (Image + Compact)

Uses cheaper models for auxiliary tasks, configured via /dp-model:

• Image read fallback — when the model reads an image file, detects type via magic bytes, calls a configured vision-capable model, and replaces the read result with image analysis text (jpeg, png, gif, webp)
• Compact model — uses a configured model for context compaction (instead of the main model), auto-resumes after compaction.

5. Smart @ File Search

Replaces Pi's default file search with a faster, project-aware search strategy:

• Uses project-aware file discovery
• Prioritizes filename-based matches for more intuitive results
• Reduces clutter from hidden, cache, and build directories
• Keeps default suggestions focused on visible project files

6. LSP Tool Suite

A cleaned-up, minimal LSP toolset. The extension keeps only the two LSP tools that cover the most practical coding workflows: checking diagnostics after edits and inspecting file structure before focused changes.

• lsp_diagnostics — file diagnostics with severity filtering
• lsp_document_symbols — file symbol outline

Supported languages: c/cpp, go, java, lua, json, python, ruby, rust, svelte, typescript

7. Dynamic Subdirectory AGENTS.md / CLAUDE.md

When the agent reads or edits a file:

• discovers AGENTS.md / CLAUDE.md in the file's directory and ancestor directories
• injects newly discovered guidance into tool results

8. Extend Providers

Extend providers are registered via /login → "Use a subscription":

Provider	Base URL
Ollama Cloud	ollama.com/v1
Baidu Qianfan	qianfan.baidubce.com/v2/coding
ARK Coding	ark.cn-beijing.volces.com/api/coding/v3

Configuration

Runtime settings are stored in:

~/.pi/agent/decorated-pi.json

Module Loading

Modules can be toggled on/off. Changes take effect after /reload.

Module	Default	Effect when disabled
patch	true	Reverts to Pi's built-in edit / write tools
safety	true	No secret redaction on read / bash output
lsp	true	All lsp_* tools unregistered — no diagnostics, hover, etc.
smart-at	true	Fallback to Pi's built-in @ file completion
mcp	true	All {server}_* MCP tools unregistered

Use /dp-settings to toggle, or edit the config file directly:

{
  "modules": {
    "patch": true,
    "safety": true,
    "lsp": false,
    "smart-at": true,
    "mcp": true
  }
}

License

MIT