Pi

@astralyn/pi is a standalone terminal coding agent for work in your projects. It runs locally and supports TypeScript extensions, skills, prompt templates, themes, and pi packages.

Install

Pi requires Node.js >=22.19.

npm install -g --ignore-scripts @astralyn/pi

Run pi in a project directory. For authentication, uninstalling, and a first session, see the quickstart.

Overview

Pi provides interactive and one-shot coding workflows, persistent sessions and context compaction, native tool presentation, and customization through its public extension API. Built-in execution uses Bash by default, with an optional native PowerShell tool on Windows. The installed package also includes bundled workflows, themes, and local-model support.

See the bundled features overview for the complete shipped-feature and extension catalog.

Use and customize

• Using Pi covers interactive commands, context files, CLI usage, and the -- end-of-options delimiter.
• Windows setup covers Git Bash and the optional PowerShell tool.
• Sessions and Compaction cover saved work and context management.
• Extensions, Skills, Prompt templates, Themes, and Pi packages cover customization.
• SDK, JSON mode, and RPC mode cover programmatic use.

Documentation

• Documentation index
• Quickstart
• Providers
• Settings
• Security

License

MIT