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
pipx install agentjoy-bridge
# or: pip install agentjoy-bridge
Windows (PATH): if
agentjoycommand is not found, run via module:python -m agentjoy_bridge init --api http://127.0.0.1:8000 --open補足：
pythonが見つからない場合はpy -m agentjoy_bridge ...を試してください。
Doctor (diagnostics)
If setup is confusing (PATH, backend, config), run:
agentjoy doctor
It prints:
- backend reachability (
/health) - config/profile status
- whether your API key / user token work
Optional (creates a small run):
agentjoy doctor --write-test
Secrets are redacted in the output.
Profiles (multiple environments)
You can keep multiple connection settings (local/staging/prod) and switch:
agentjoy profile set local --api http://127.0.0.1:8000 --use
agentjoy profile set staging --api https://staging.example.com --api-key ... --user-token ...
agentjoy profile list
agentjoy profile use staging
agentjoy profile show staging
For one-off commands without switching the current profile:
agentjoy demo --profile local --open
agentjoy health --profile staging
3-minute Quickstart (no Codex required)
Fastest: one command onboarding
If you're running from the AgentJoy repo (so ./backend exists), this command can:
- start backend (if needed)
- create a workspace + save config
- create a demo run + open the share URL
agentjoy quickstart --api http://127.0.0.1:8000 --open
Windows (PATH):
python -m agentjoy_bridge quickstart --api http://127.0.0.1:8000 --open
補足：
pythonが見つからない場合はpy -m agentjoy_bridge ...を試してください。
1) Start AgentJoy backend
cd backend
python -m uvicorn agentjoy.main:app --reload --port 8000
2) Bootstrap a Workspace + save config
This creates a workspace and stores config at ~/.agentjoy/config.json.
agentjoy init --api http://127.0.0.1:8000 --open
# (alias: --api-base)
3) Create a demo run + open the share URL
agentjoy demo --open
Codex (recommended)
agentjoy codex-run "Fix failing tests"
It will print a share URL you can open in a browser.
Claude Code
See integrations/claude-plugin/agentjoy/ for hook configs and examples.
Compatibility: upstream JSON changes
LLM tools evolve quickly. If a new Claude/Codex version changes the JSON field names that the Bridge reads, you can adjust the extraction paths without waiting for a package release.
- Create a template overrides file:
agentjoy adapters --init
agentjoy adapters
- Edit the file shown (typically
~/.agentjoy/bridge_adapters.json) and add new dot-paths.
This feature is intentionally lightweight: unknown fields are ignored, and the Bridge keeps running.
License
MIT
1 maintainer
Release files for agentjoy-bridge 0.3.36
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agentjoy_bridge-0.3.36.tar.gz | 27.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agentjoy_bridge-0.3.36-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 55.3 kB
Release files / agentjoy_bridge-0.3.36.tar.gz
| Download URL | agentjoy_bridge-0.3.36.tar.gz |
|---|---|
| Size | 27.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
40a7f08ee020542c864f5c442afdcf605b5c8858e7839fc371d825f822c8af81
|
|
BLAKE2b-256 checksum How to use checksums |
0ed8b8a1561b2b1242555a90152fb9370b7a8ec56f9fabc8e794a188212657dc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / agentjoy_bridge-0.3.36-py3-none-any.whl
| Download URL | agentjoy_bridge-0.3.36-py3-none-any.whl |
|---|---|
| Size | 27.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cd4020d41072da376259e43ac381e40dd73e7bc07558b3f68d318d2185c81be0
|
|
BLAKE2b-256 checksum How to use checksums |
c07eaac411892d55aff9488a8e2146027901ef7dbb57f757b6ad58b20f2ac4b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
