mirror of
https://github.com/harivansh-afk/clanker-agent.git
synced 2026-04-15 08:03:42 +00:00
- Copy all pi-mono source into apps/companion-os/ - Update Dockerfile to COPY pre-built binary instead of downloading from GitHub Releases - Update deploy-staging.yml to build pi from source (bun compile) before Docker build - Add apps/companion-os/** to path triggers - No more cross-repo dispatch needed Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1.3 KiB
1.3 KiB
Development
See AGENTS.md for additional guidelines.
Setup
git clone https://github.com/badlogic/pi-mono
cd pi-mono
npm install
npm run build
Run from source:
./pi-test.sh
Forking / Rebranding
Configure via package.json:
{
"piConfig": {
"name": "pi",
"configDir": ".pi"
}
}
Change name, configDir, and bin field for your fork. Affects CLI banner, config paths, and environment variable names.
Path Resolution
Three execution modes: npm install, standalone binary, tsx from source.
Always use src/config.ts for package assets:
import { getPackageDir, getThemeDir } from "./config.js";
Never use __dirname directly for package assets.
Debug Command
/debug (hidden) writes to ~/.pi/agent/pi-debug.log:
- Rendered TUI lines with ANSI codes
- Last messages sent to the LLM
Testing
./test.sh # Run non-LLM tests (no API keys needed)
npm test # Run all tests
npm test -- test/specific.test.ts # Run specific test
Project Structure
packages/
ai/ # LLM provider abstraction
agent/ # Agent loop and message types
tui/ # Terminal UI components
coding-agent/ # CLI and interactive mode