Pi Coding Agent: Minimalist Terminal Workflows Training Course

Introduction to Pi

• Understanding what Pi is and its core philosophy of minimalism and control.
• Comparison with Claude Code, Codex CLI, and Cursor.
• Overview of the four built-in tools: read, write, edit, and bash.
• When to choose Pi over more complex agent solutions.

Installation and Setup

• Installing Pi via npm and other package managers.
• Configuring API keys for over 15 supported providers.
• Setting up the working directory and context files.
• Running Pi in local environments as well as within Docker.

Core Terminal Workflows

• Generating code from straightforward prompts.
• Precisely reading and editing files.
• Safely executing bash commands within the agent.
• Managing session state and performing context resets.

Building Custom Skills

• Understanding the TypeScript skill API.
• Writing custom operations for read, write, and edit functions.
• Integrating with bash execution for specialized workflows.
• Testing and debugging skills in isolation.

Prompt Templates and Themes

• Adapting system prompts for various languages and frameworks.
• Creating reusable prompt templates to ensure team consistency.
• Packaging themes as shareable modules.

Extending Pi with npm Packages

• Bundling skills as pi packages.
• Publishing to npm and Git repositories.
• Installing community-contributed packages.
• Managing dependency versions and compatibility.

Provider Flexibility

• Switching between Anthropic, OpenAI, Google, and other backends.
• Optimizing for cost, speed, and quality per task.
• Running entirely local models for handling sensitive code.

Practical Use Cases

• Automated testing and test generation workflows.
• Refactoring legacy code using custom skill chains.
• Documentation generation and maintenance.
• Integrating with CI pipelines while maintaining minimal agent overhead.

Security and Control

• Understanding the 300-word system prompt boundary.
• Requiring manual approval for write operations.
• Sandboxing bash execution for untrusted environments.
• Audit logging of all agent actions.

Summary and Next Steps

• Recap of the principles of minimalism, control, and extensibility.
• Community resources and contribution guidelines.
• Advanced topics for experienced Pi users.