Piclaw

PiClaw

PiClaw is a professional AI coding agent built on [pi-coding-agent](https://github.com/mariozechner/pi-coding-agent). It provides a powerful terminal-based interface for AI-assisted development.

Features

• Rich Extension Ecosystem: 23+ extensions including tools, commands, renderers, and widgets.
• Integrated Tools: git (full git operations), test (vitest runner), formatter (Prettier), audit (npm audit), build (npm run build), metrics (export stats), memory (persistent memories), todos (project todo management), scripts (npm scripts), secret-scanner (detect leaked keys).
• Interactive Slash Commands: /tree (session browser), /settings (config UI), /providers (LLM provider management), /copy (clipboard), /team (toggle team widget), /scan-secrets (security scan), /scripts (run npm scripts).
• Custom Renderers: Beautiful output for branch summaries, team ops, compaction summaries.
• Session Widgets: Live team status widget with toggle.
• Secure by Default: SDK factories, validated inputs, no eval; file writes use mutation queue.
• Prompt Templates: Built-in defaults (default, explain, refactor, test, review).
• Highly Configurable: ~/.piclaw/config.json or CLI flags; thinking level and model persistence.
• Modular Architecture: Easy to add new extensions; all registered via factory.ts.

Extension System

PiClaw loads extensions from `src/extensions/` automatically. Extensions can register:

• Tools: Callable by the LLM (e.g., git, test, formatter).
• Commands: Slash commands invoked by the user (e.g., /tree, /team).
• Renderers: Custom UI for tool results and session entries.
• Widgets: TUI components that display live information.

All extensions follow the SDK patterns for consistency and safety.

Security Model

• No arbitrary eval or unsanitized command execution.
• Tools that run shell commands use createBashTool with safe defaults.