Skip to content

v0.1.0a2 — dependency-free feedback alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@nemo83 nemo83 released this 13 Oct 14:59
v0.1.0a2
8f66976

Feedback alpha. Discover existing local Claude Code and Codex sessions and send explicit messages between them, through a typed Python API or the agent-bridge CLI.

What's new in 0.1.0a2

  • Zero third-party runtime packages. The websockets dependency is replaced by a synchronous, standard-library RFC 6455 client for the Codex Unix socket. It bounds headers to 16 KiB and messages to 4 MiB, masks frames, validates the handshake, framing and UTF-8, uses total deadlines, and never reconnects or replays.
  • Dependency guard. A CI check fails on any third-party import or wheel runtime requirement.
  • Install-by-reference plugins for Claude Code and Codex (skills only):
    • Claude Code: /plugin marketplace add easy1staking-com/claude-2-codex, then /plugin install agent-bridge@easy1staking-agent-bridge-claude
    • Codex: codex plugin marketplace add easy1staking-com/claude-2-codex --ref main, then codex plugin add agent-bridge@easy1staking-agent-bridge-codex
  • Self-contained. The repo references no other projects.

Install

  1. Download agent-bridge-linux-x86_64 and SHA256SUMS.
  2. Run sha256sum --ignore-missing --check SHA256SUMS.
  3. Run chmod +x agent-bridge-linux-x86_64, then ./agent-bridge-linux-x86_64 --help.

The executable bundles Python, so you need no Python or pip. It needs Linux system libraries compatible with the Ubuntu 22.04 build baseline (glibc 2.35 or newer), plus the installed, authenticated claude and codex CLIs, which supply the sessions being connected. The wheel requires Python 3.11 or newer and has no dependencies. This package is not on PyPI.

Validation

  • Tests: 134 pass with site-packages disabled and against a clean installed wheel outside the checkout. That includes 41 adversarial transport tests run against an independently written stdlib test server.
  • CI: passed on Python 3.11 and 3.14, plus the standalone build, for commit 8f66976. The assets here are that run's artifacts.
  • Live checks:
    • The CI executable discovered live sessions with no provider errors.
    • A local a2 build delivered an addressed message to Claude.
    • Claude replied from the installed a2 wheel over the new transport, and Codex observed that reply exactly once.

Known limits

  • Approval and disconnect tests ran on the previous transport. The held manual approval test (B-2) and the abrupt sender disconnect tests during an active turn (D-1) and during a held approval (D-2) passed on 0.1.0a1's websockets transport. They are not yet repeated on the new client, and that is a stable-release gate.
  • Delivery is not guaranteed. queued and rpc_accepted receipts mean the provider accepted the message, not that the agent read it. There is no delivery deadline. After a sender crash, a message can be recorded as unknown yet still have been delivered, so check the recipient before any deliberate resend.
  • Platform: local Linux only, single user. macOS is tracked in #1. A native-language (C/Go/Rust) build is deferred until after feedback.

Built by Codex and Claude, with mutual adversarial review. See CONTRIBUTORS.md. Please report feedback in GitHub issues, and redact tokens, session IDs and message bodies.

Assets 6
Loading