Skip to content

v0.3.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 03 May 08:14
v0.3.0
381b0e7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

The agent-native release. Two-line setup, three killer capabilities, one machine-readable catalog. Backward-compatible with 0.2.0.

Headlines

  • One-shot install for 10 IDEs / agent runtimes. chatgpt-bridge install --for <target> writes the right MCP/config block to the right path on the right OS. Idempotent, supports --dry-run and --uninstall. Refuses to overwrite a non-JSON config file.
    Targets: claude-code, claude-desktop, codex, cursor, zed, cline, continue, gemini-cli, aider (snippet), openai-sdk (snippet), all (auto-detects what's installed).
  • Multimodal input. Vision (image_url content parts) and file context ({type:"input_file", file:{path|url|data,mime}} — bridge extension) work first-class on /v1/chat/completions. Reference images (reference_images[] — bridge extension) drive style/composition on /v1/images/generations. 25 MiB per attachment, 100 MiB aggregate. Path-traversal guard blocks attempts to read ~/.codex/auth.json.
  • Machine-readable catalog. chatgpt-bridge capabilities returns one JSON document describing every verb, arg, return shape, idempotency, side effects, typical latency, and error-code → structured remedy mapping. Agents read once, know everything.

Two-line setup

npx @openai/codex login                          # one-time browser auth
npx chatgpt-bridge install --for claude-code     # or codex, cursor, zed, gemini-cli, all, ...

Quick taste

# vision
chatgpt-bridge chat "what font is this?" --attach screenshot.png

# file context
chatgpt-bridge chat "audit this spec against OpenAPI 3.1" --attach spec.md

# image with reference (style transfer)
chatgpt-bridge image "hero shot, brand-consistent" \
  --ref moodboard.png --ref logo.svg --out hero.png

# agent-native discovery
chatgpt-bridge capabilities | jq '.verbs[].name'

# health + structured remedy
chatgpt-bridge doctor

Wire compatibility

  • Existing OpenAI-SDK code against localhost:10531/v1/* keeps working.
  • Existing MCP tools (chat, generate_image, health) keep working — they just gain optional attachments / references args.
  • chatgpt-bridge gen kept as a deprecation alias for image (warns to stderr, then forwards). Removed in 0.5.
  • Bridge extensions (non-portable to api.openai.com) are flagged in code, in the catalog, and in the docs.

Full release notes

See CHANGELOG.md.

Install

npm i -g chatgpt-bridge@0.3.0
# or one-shot
npx chatgpt-bridge@0.3.0 install --for claude-code
Assets 5
Loading