Metadata-Version: 2.4
Name: agentjoy-bridge
Version: 0.1.1
Summary: AgentJoy Bridge CLI (Codex / Claude Code / Agent tool activity -> AgentJoy Runs)
Author: VNL Works
License: MIT
Project-URL: Homepage, https://github.com/vnl-works/agentjoy
Project-URL: Repository, https://github.com/vnl-works/agentjoy
Project-URL: Issues, https://github.com/vnl-works/agentjoy/issues
Keywords: ai,agent,observability,ux,codex,claude,mcp
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# 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
