feat(pi-harness): standalone headless agent server#84
Merged
Conversation
- Inventory of GIFs, screenshots, and videos needed for blog posts - Tracks pending assets: audit trail screenshot, data source GIF, multi-agent delegation GIF, WhatsApp interaction GIF - Blog backlog: architecture deep dive, SDK tutorial, deployment guide - Links to existing setup demo GIF and voice AI blog content
Add @openzosma/pi-harness — a lightweight, deployable HTTP/SSE server that wraps pi-coding-agent in headless SDK mode. No TUI, no database, no auth complexity. One Node.js process serves multiple sessions. Features: - Full CLI with subcommands: start, stop, status, setup, tui, logs - First-run auto-detection with interactive setup wizard - Native daemon mode (--daemon) with PID tracking - Real-time SSE streaming of agent events - Per-session workspace isolation with configurable limits - Idle session cleanup and health monitoring - esbuild bundling for standalone npm install (-g) - Dynamic imports split heavy deps from lightweight CLI commands Also update root README with pi-harness references in 5 places: - Standalone harness callout section - Architecture table callout - Project structure listing - Roadmap entry - Documentation table Closes standalone deployment use case for pi-coding-agent.
Resolve pnpm-lock.yaml conflict by taking upstream version and regenerating with pnpm install.
Extend the release workflow to also bump version and publish @openzosma/pi-harness alongside create-openzosma when a v* tag is pushed.
- Fix biome formatting in package.json (files field) - Sort imports across cli.ts, commands.ts, server.ts, tui.ts - Fix noUnusedTemplateLiteral in cli.ts - Fix useTemplate in build-bundle.mjs - Add fsevents and *.node to esbuild externals (upstream dep change) - Add .npmignore to exclude source maps from published package - Remove stale .pi-lens cache files
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add
@openzosma/pi-harness— a lightweight, deployable HTTP/SSE server that wrapspi-coding-agentin headless SDK mode. No TUI, no database, no auth complexity. One Node.js process serves multiple sessions with inference in the cloud.What's Included
New Package:
packages/pi-harness/start,stop,status,setup,tui,logs,--help,--version~/.pi-harness/.envmissing--daemonflag spawns background process with PID trackingnpm install -gdistributioncurl | bashinstaller and interactive setup wizardRoot README Updates
Pi-harness is now discoverable in 5 places:
Design Philosophy
Pi-harness is intentionally humble — it gives full credit to Mario Zechner's
pi-coding-agentas the real hero. It's a deployment layer, not a replacement. Companies configure their own models, tools, prompts, and extensions. The harness fits into their workflow, not the other way around.Usage
Testing
pnpm checkpasses (TypeScript strict)pnpm buildproduces clean bundlesCloses: standalone deployment use case for pi-coding-agent.