agentbridge 0.3.1

Connect AI brains to local coding agents through MCP
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# Architecture

AgentBridge is a local process. It is not a coding agent.

```
                Brain
       ┌─────────┼─────────┐
       │         │         │
    Gemini     Claude    ChatGPT
       │         │         │
       └─────────┼─────────┘
                 │
       MCP (inspect + task_start)
                 │
          ┌──────▼──────┐
          │ AgentBridge │
          └──────┬──────┘
                 │
              OpenCode
                 │
                 ▼
           Project hub
        (one or more repos)
```

V0.3 adds OAuth 2.1 and multi-project hosting to the same loop:

```
ChatGPT Web
        ↓  Remote MCP
   AgentBridge (Rust)
        ↓  C2C PLAN
     OpenCode CLI
        ↓  edits + tests
   Local Workspace
        ↑  git_diff / test_status
   AgentBridge
        ↓  REVIEW
   ChatGPT Web
```

## Layers

1. **MCP server** (`src/mcp.rs`) — Streamable HTTP tools. Inspection is read-only. `list_projects` / `switch_project` select a mounted workspace. `task_start` / `task_status` / `task_cancel` control the local Executor.
2. **Project hub** (`src/projects.rs`) — One or more local repositories in a single process. Each tool call is sandboxed to the selected project's root.
3. **Workspace** (`src/workspace.rs`) — Path isolation, file read, listing, search.
4. **OAuth 2.1** (`src/oauth.rs`) — Protected Resource Metadata, Authorization Server Metadata, authorization code + PKCE, dynamic client registration, `/mcp` 401 challenge.
5. **C2C protocol** (`src/protocol.rs`) — Small PLAN/REVIEW messages. `C2cPlan` is the structured Brain → Executor payload.
6. **Executor** (`src/executor.rs`) — `OpenCodeExecutor` spawns `opencode run` with structured args in the selected project directory.
7. **Task runtime** (`src/task.rs`) — Lifecycle: created → planned → running → executed | failed | blocked | cancelled. One runtime per project.
8. **Bridge** (`src/server.rs`) — `http://127.0.0.1:8030/mcp`. Cloudflare Tunnel is optional and external.

There is no Cloudflare logic in the MCP server. A tunnel is just a way to point a public HTTPS URL at localhost.

## Trust boundary

The Brain is a remote model. It must never receive:

- Arbitrary filesystem access
- A generic shell tool
- Write tools
- An executable name (OpenCode's command comes from local config)
- Secret files (`.env`, keys, `~/.ssh`, …)

The Executor is a local agent the user already trusts with the repo. AgentBridge starts it only inside the configured workspace, then records:

```
status, summary, exit_code, tests, changed_files, error
```

Internal model reasoning is not stored or returned.

## State

Task/test state lives at:

```
<workspace>/.agentbridge/state.json
<workspace>/.agentbridge/current.c2c
<workspace>/.agentbridge/executor.pid
```

The MCP server reads this from disk on every `test_status` / `execution_summary` / `task_status` call so the CLI and the Brain stay in sync without a database.