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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| agentjoy_bridge-0.3.36.tar.gz | 27.9 kB | Without provenance | Details for agentjoy_bridge-0.3.36.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agentjoy_bridge-0.3.36-py3-none-any.whl | Python 3 | none | any | Details for agentjoy_bridge-0.3.36-py3-none-any.whl |
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
|
Security for agentjoy-bridge 0.3.36
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.