# agentjoy-bridge

AgentJoy Bridge is a tiny, dependency-free CLI that converts agent/tool activity into **AgentJoy Run events**.

It supports:
- OpenAI Codex CLI (`codex exec --json`)
- Claude Code hooks / plugin hooks
- (Template included) ChatGPT Apps SDK viewer (MCP)

## Install

```bash
pipx install agentjoy-bridge
# or: pip install agentjoy-bridge
```

## Quickstart

1) Start AgentJoy backend:

```bash
cd backend
python -m uvicorn agentjoy.main:app --reload --port 8000
```

2) Configure bridge:

```bash
agentjoy configure --api-base http://127.0.0.1:8000 --api-key YOUR_WORKSPACE_API_KEY
```

3) Run with Codex:

```bash
agentjoy codex-run "Fix failing tests"
```

It will print a **share URL** you can open in a browser.

## License

MIT
