Metadata-Version: 2.4
Name: baserun-cli
Version: 0.1.16
Summary: BaseRun agent-side daemon (connects to nchan, spawns CLI agents, publishes run events)
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: websockets>=13.0
Requires-Dist: httpx>=0.27.0

# baserun-cli

BaseRun agent-side daemon. It connects to the BaseRun nchan channel, runs local CLI agents, and publishes run events back to BaseRun.

## Run

```bash
NCHAN_URL="wss://baserun.livesig.cn/nchan" \
AGENT_APP_ID="<agent_id>" \
AGENT_APP_SECRET="<agent_secret>" \
CONNECTOR_TYPE="claude_code" \
uvx baserun-cli
```

`CONNECTOR_TYPE` defaults to `claude_code`.

## Pass agent CLI arguments

Every argument is preserved and appended to every command launched for the configured agent. No extra `--` separator is required.

```bash
uvx baserun-cli --model opus --verbose
```

This applies to new sessions, resumed sessions, and all native-fork subprocesses. `baserun-cli` does not validate these arguments; the selected Claude Code, Codex, ccagent, or custom agent command is responsible for accepting or rejecting them.

`-h` and `--help` show `baserun-cli` help only when used as the sole argument. When combined with other arguments, they are passed through to the agent CLI.

## Build

```bash
cd baserun-cli
rm -rf dist build *.egg-info
python3 -m build
```

## Publish

```bash
cd baserun-cli
python3 -m twine upload dist/*
```

Or with uv:

```bash
cd baserun-cli
uv build
uv publish
```
