Metadata-Version: 2.4
Name: wormhole-cli
Version: 0.1.0
Summary: Reference command-line agent built on wormhole-sdk.
Author: Wormhole Team
License-Expression: AGPL-3.0-or-later
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: wormhole-sdk<0.14.0,>=0.13.0
Provides-Extra: test
Requires-Dist: pytest>=7.4.0; extra == "test"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
Provides-Extra: lint
Requires-Dist: ruff>=0.6.4; extra == "lint"
Requires-Dist: mypy>=1.11.0; extra == "lint"
Dynamic: license-file

# 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

```bash
pip install wormhole-cli
```

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

## Run

```bash
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.

```text
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

```text
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`](../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](./LICENSE) for the full
text.

## Version History

| Version | Milestone | Notes |
|---|---|---|
| 0.1.0 | Initial release | Reference terminal coding agent. Pulls `wormhole-sdk>=0.13.0,<0.14.0`. |
