Agent Bridge

Free open-source developer alpha for one terminal room with Claude, Codex, and project memory.

Agent Bridge keeps the project context. Claude and Codex are workers inside the session.

Created by @newtophilly.

Agent Bridge is independent and not affiliated with Anthropic, OpenAI, Claude Code, or Codex.

Status

Developer alpha. Expect rough edges.

Current target:

Free local CLI. Bring your own Claude/Codex accounts. Your project memory stays local.

Prerequisites

• Node.js 18+
• Claude Code CLI installed and authenticated if you want to use @claude
• Codex CLI installed and authenticated if you want to use @codex

Windows support is planned but not validated yet. WSL2 is likely the safest Windows path until real testing is done.

What Works Now

• agent-bridge init sets up local project memory.
• agent-bridge try scans a project and starts the local browser control panel.
• agent-bridge scan imports an existing folder into .agent-bridge/.
• agent-bridge status shows project, scan, and permission state.
• agent-bridge doctor checks installed tools, git, and context health.
• agent-bridge start opens the one-terminal room.
• agent-bridge serve opens a local browser control panel with project status, memory, pins, search, handoff actions, and browser-based agent routing.
• @claude, @codex, @both, and @debate route messages to installed CLIs.
• /remember, /preference, /decide, /focus, /checkpoint, and /summary manage durable local context.
• /handover, /timeline, and /why turn saved memory into continuity for future-you.
• /limits, /compact, and /performance help users manage context pressure and speed/depth.
• /context <question> previews which saved memories and decisions are relevant to a prompt.
• /packet <question> prints a copy-ready context packet for ChatGPT, Gemini, Perplexity, Aider, or any other AI.

Run It

From a cloned repo:

git clone <repo-url>
cd agent-bridge
npm run check
node bin/agent-bridge.js scan
node bin/agent-bridge.js doctor
node bin/agent-bridge.js start
node bin/agent-bridge.js serve

Fastest real-project test:

cd /path/to/your-project
node /path/to/agent-bridge/bin/agent-bridge.js try

From this folder:

node bin/agent-bridge.js scan
node bin/agent-bridge.js status
node bin/agent-bridge.js doctor
node bin/agent-bridge.js start

Or through npm scripts:

npm run scan
npm run status
npm run doctor
npm run start

For step-by-step usage, see docs/USER_GUIDE.md.

For release positioning and public-alpha readiness, see docs/LAUNCH_PLAN.md.

For the demo script, see docs/DEMO.md.

For testing Agent Bridge on a real project, see docs/FIRST_PROJECT_TEST.md.

For the first self-review proof loop, see docs/CASE_STUDY_SELF_REVIEW.md.

For the roadmap, see docs/ROADMAP.md.

For product direction, see docs/PRODUCT_NOTES.md.

For architecture, see docs/ARCHITECTURE.md.

For private remote access, see docs/TAILSCALE.md.

Room Commands

@claude <message>      Ask Claude
@codex <message>       Ask Codex
@both <message>        Ask both, then synthesize
@debate <question>     Structured Claude/Codex debate

/remember <note>       Save stable project memory
/preference <note>     Save a user/workflow preference
/decide <decision>     Save a project decision
/focus                 Show active task and policies
/checkpoint [note]     Save current checkpoint
/compact [note]        Create a fast local context summary
/context <question>    Preview relevant context selection
/packet <question>     Print a copy-ready context packet for another AI
/handover [note]       Write CURRENT_STATE.md for future you
/timeline              Rebuild project timeline
/why <topic>           Show reasoning trail for a topic
/limits                Show context pressure and current limits
/performance [level]   Show or set fast, balanced, or deep mode
/summary               Show session summary
/scan                  Rescan/import the folder
/exit                  Leave the room

Local Memory

Agent Bridge stores durable context locally:

.agent-bridge/
  project.json
  permissions.json
  agents.md
  memory.md
  preferences.md
  decisions.md
  pins.md
  context-summary.md
  CURRENT_STATE.md
  TIMELINE.md
  stack.md
  structure.md
  sessions/
  runs/

Git is optional. Existing projects can be imported with agent-bridge scan.

Privacy

Agent Bridge stores project memory locally in .agent-bridge/.

Do not commit .agent-bridge/ unless you have reviewed it and intentionally want to share its contents. This repo ignores .agent-bridge/ by default.

License

Apache-2.0. See LICENSE.

Support

Agent Bridge is free and open source. If it helps you, star the repo or share feedback:

• GitHub: @newtophilly

Disclaimer

See DISCLAIMER.md.