Wormhole CLI

A reference command-line coding agent built on wormhole-sdk. Mostly exists to claim the wormhole-cli namespace on PyPI alongside wormhole-core and wormhole-sdk, but it's also a working terminal agent you can use as the starting point for your own CLI.

Install

pip install wormhole-cli

This pulls in wormhole-sdk (which pulls in wormhole-core and anthropic).

Run

export ANTHROPIC_API_KEY="sk-ant-..."
wormhole

You'll get a prompt; type natural-language instructions and the agent will read/write/edit files in the current directory and run shell commands, asking for approval before each tool call.

You: Read README.md and tell me what this project does
You: Create hello.py that prints hello world, then run it
You: quit

Flags

wormhole --help

  --api-key STR        Anthropic API key (or set ANTHROPIC_API_KEY)
  --base-url STR       Custom API endpoint (e.g. https://your-proxy.com)
  --model STR          Model name (default: claude-sonnet-4-20250514)
  --context-limit INT  Auto-compaction context limit (default: 200000)

What this is and isn't

It is: a small, working agent loop with terminal-based approval prompts and streaming output rendering. About 200 lines, no fancy UI.

It is not: a polished product. There's no fancy TUI, no config file, no persistence between runs. If you want any of those, fork agent.py — that's why it's a reference.

For a more involved example with task delegation, see packages/sdk/examples/coding_agent.py in the source repo, which this CLI is derived from.

License

wormhole-cli is distributed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later). See LICENSE for the full text.

Version History