Metadata-Version: 2.4
Name: twinco-bridge
Version: 1.1.0
Summary: Connect local AI agents (Claude Code, Codex, etc.) to TwinCo
Project-URL: Homepage, https://twinco.ai
Project-URL: Repository, https://github.com/twinco-ai/twinco-bridge
Author-email: TwinCo <dev@twinco.ai>
License-Expression: MIT
Keywords: agent,ai,bridge,claude-code,codex,twinco
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: pydantic>=2.0
Requires-Dist: websockets>=13.0
Provides-Extra: keyring
Requires-Dist: keyring>=25.0; extra == 'keyring'
Description-Content-Type: text/markdown

# twinco-bridge

Connect local AI agents (Claude Code, Codex, etc.) to [TwinCo](https://twinco.ai).

## Install

```bash
pip install twinco-bridge
```

## Quick start

```bash
# Authorize this machine
twinco-bridge connect --server https://your-twinco-server.com

# Start the bridge
twinco-bridge
```

## Live task output

While the bridge runs in a terminal, every task your twin dispatches is
rendered live — the twin's prompt, the agent's responses, and each tool
call as it happens:

```
--- task 4739dacc | claude-code | cwd=~/projects/platform-api ---
[4739dacc] TWIN -> AGENT
[4739dacc]   Analyze and fix this failing auto_delivery_action: ...
[4739dacc] [tool] Bash {"command": "git diff"}
[4739dacc] AGENT Looking at the parser change first...
[4739dacc] done | 146s | 12 tool calls | tokens in=26097 out=4521 | session=179206d4
```

Flags:

- `--quiet` — disable live output entirely
- `--show-reasoning` — include the agent's thinking blocks
- `--show-tool-results` — include truncated tool outputs
- `--stream` — force rendering when stdout is not a TTY (it is
  auto-disabled for pipes/log files otherwise)

Concurrent tasks are distinguished by the `[call_id]` prefix on every
line.

## Supported agents

| Agent | Binary | Status |
|-------|--------|--------|
| Claude Code | `claude` | Supported |
| Codex | `codex` | Supported |
| OpenClaw | `openclaw` | Supported |
| Hermes | `hermes` | Supported |

The bridge auto-discovers installed agents on your PATH.

## License

MIT
