Tools for building AI agents and managing LLM deployments.

npm install          # Install all dependencies
npm run build        # Build all packages
npm run check        # Lint, format, and type check

Note: npm run check requires npm run build to be run first. The web-ui package uses tsc which needs compiled .d.ts files from dependencies.

GitHub Actions runs on push to main and on pull requests. The workflow runs npm run check and npm run test for each package in parallel.

Do not add LLM API keys as secrets to this repository. Tests that require LLM access use describe.skipIf() to skip when API keys are missing. This is intentional:

• PRs from external contributors would have access to secrets in the CI environment
• Malicious PR code could exfiltrate API keys
• Tests that need LLM calls are skipped on CI and run locally by developers who have keys configured

If you need to run LLM-dependent tests, run them locally with your own API keys.

Start watch builds for all packages:

npm run dev

Then run with tsx:

cd packages/coding-agent && npx tsx src/cli.ts
cd packages/pods && npx tsx src/cli.ts

All packages MUST always have the same version number. Use these commands to bump versions:

npm run version:patch    # 0.7.5 -> 0.7.6
npm run version:minor    # 0.7.5 -> 0.8.0
npm run version:major    # 0.7.5 -> 1.0.0

These commands:

1. Update all package versions to the same number
2. Update inter-package dependency versions (e.g., pi-agent depends on pi-ai@^0.7.7)
3. Update package-lock.json

Never manually edit version numbers. The lockstep system ensures consistency across the monorepo.

Complete release process:

1. Add changes to CHANGELOG.md (if changes affect coding-agent):

   # Add your changes to the [Unreleased] section in packages/coding-agent/CHANGELOG.md
   # Always add new entries under [Unreleased], never under already-released versions

2. Bump version (all packages):

   npm run version:patch    # For bug fixes
   npm run version:minor    # For new features
   npm run version:major    # For breaking changes

3. Finalize CHANGELOG.md for release (if changes affect coding-agent):

   # Change [Unreleased] to the new version number with today's date
   # e.g., ## [0.7.16] - 2025-11-17
   # NEVER add entries to already-released version sections
   # Each version section is immutable once released

4. Commit and tag:

   git add .
   git commit -m "Release v0.7.16"
   git tag v0.7.16
   git push origin main
   git push origin v0.7.16

5. Publish to npm:

   npm run publish        # Publish all packages to npm

   NPM Token Setup: Publishing requires a granular access token with "Bypass 2FA on publish" enabled.

   • Go to https://www.npmjs.com/settings/badlogic/tokens/
   • Create a new "Granular Access Token"
   • Select "Bypass 2FA on publish"
   • Tokens expire after 90 days, so regenerate when needed
   • Set the token: npm config set //registry.npmjs.org/:_authToken=YOUR_TOKEN

6. Add new [Unreleased] section (for next development cycle):

   # Add a new [Unreleased] section at the top of CHANGELOG.md
   # Commit: git commit -am "Add [Unreleased] section"

MIT