crow-cli, inside Glueprint.
Minimal ACP Native Coding Agent. Glueprint runs crow-cli over the Agent Client Protocol it already speaks — adding live sessions on every device, approvals from your phone, parallel worktrees, schedules, and memory.
crow-cli
Thomas Wood
- Agent
- crow-cli
- Maintainer
- Thomas Wood
- Connection
- Agent Client Protocol
- Wire format
- JSON-RPC 2.0 over stdio
- Registry version
- 0.1.24
- License
- Apache-2.0
What is crow-cli?
crow-cli is an open-source, minimal coding agent written entirely in Python and licensed under Apache 2.0. It splits into a reasoning agent (crow-cli) and an MCP toolserver (crow-mcp) built on FastMCP, with SQLAlchemy for persistent session storage. It targets OpenAI-compatible LLM APIs with runtime model switching, and includes a self-hosted SearXNG search stack that needs no API keys. Notable internals include a PTY-backed terminal tool and LLM-based context compaction past a 120k-token threshold.
- Pure Python, Apache 2.0, no heavy frameworks
- Two-layer reasoning agent plus MCP toolserver
- OpenAI-compatible APIs with runtime model switching
- Self-hosted SearXNG search, no API keys
- Context compaction past a 120k-token threshold
Best for Developers wanting a small, self-hostable, Python-based agent with OpenAI-compatible model support.
Sourced from crow-cli's official site and repository.
How Glueprint runs crow-cli
crow-cli connects over the open Agent Client Protocol — one generic adapter implements the protocol's client side, so crow-cli gets the same surfaces as every other harness:
Glueprint spawns crow-cli, not a fork
Glueprint finds the crow-cli binary you installed and spawns it, then speaks the Agent Client Protocol — JSON-RPC 2.0 over stdio — to drive it. Same CLI, same authentication; Glueprint just wraps the session.
Output streams as structure
Message chunks, tool calls, and tool-call updates from crow-cli arrive as protocol notifications and render as the same live, typed timeline every Glueprint session gets — watchable from desktop, browser, or phone.
Permission requests become approval cards
When crow-cli asks to write a file or run a command, the protocol's permission request surfaces as an inline approval card on whatever device you're holding. Approve, deny, or auto-allow per tool.
One adapter, the whole fleet
Because crow-cli speaks ACP, adding it is a catalog entry, not an engineering project — the same adapter runs every other agent in the registry, so you can tile them side by side.
What crow-cli gains inside Glueprint
Everything below works with the crow-cli CLI you have today — no migration, no new account for the model, no lock-in. Uninstall Glueprint and your terminal workflow is exactly as it was.
Live sessions on every surface
Watch every crow-cli prompt, tool call, and diff stream in real time — desktop, web portal, iOS and Android. The session runs on your machine; the view follows you.
Approve from your phone
Permission prompts arrive as approval cards wherever you are. Kick off a refactor at your desk, approve the file writes from the couch.
Parallel sessions across worktrees
Run several crow-cli sessions side by side, each in its own git worktree, with diffs, history, and a three-pane conflict resolver alongside.
Mix harnesses in one mosaic
Tile crow-cli next to Claude Code, Codex, and the rest of the ACP fleet in the Command Center. The protocol differs; the surface doesn't.
crow-cli as a persistent assistant
Promote it to an assistant: persona, constitution, long-term memory, and a daily journal on disk, loaded into every wake.
Routines on a schedule
Wake it on cron: triage the inbox every 30 minutes, sweep PRs at 9am, run the nightly cleanup. Quiet hours and watermarks prevent re-fires.
Analytics per harness
Messages, sessions, and output tokens computed from session logs — compare crow-cli against Claude Code, Codex, and your other ACP agents.
Encrypted to the relay
Remote viewing rides AES-256-GCM envelope encryption. The relay routes; it cannot read.
crow-cli + Glueprint, asked plainly
Can I run crow-cli with Glueprint?
Yes. crow-cli is registered in the official Agent Client Protocol registry, and Glueprint implements the protocol's client side. It spawns the crow-cli CLI you already installed and drives it over JSON-RPC 2.0 — adding live sessions, inline approvals, worktrees, and remote control.
Do I need a separate crow-cli subscription or API key?
No. Glueprint doesn't resell model access. crow-cli authenticates exactly the way its vendor designed — its own login, subscription, or API key. Glueprint spawns the binary and speaks the protocol; it doesn't sit between you and the model provider.
Can I run crow-cli from my phone?
Sessions always run on your machines — a laptop, a desktop, or a server with the headless daemon. The iOS and Android app streams crow-cli sessions live, lets you send follow-ups, and handles permission approvals from anywhere.
Can I run crow-cli next to Claude Code and Codex?
Yes — that's the point. Each harness is an adapter; sessions from all of them tile into the same Command Center, share the same task boards, and roll up in the same per-harness analytics.
Is my session content private?
Yes. Remote viewing routes AES-256-GCM-encrypted envelopes through the relay, which stores a wrapped key it cannot open — decryption happens on your devices. On the free local tier, session content never leaves your machine at all. See security.
Bring Glueprint to your workflow.
Download once, run on your hardware, scale up to teams when you're ready. No credit card.