You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AGENTS.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ Detailed navigation/runbooks live in:
9
9
10
10
-`docs/codebase-map.md` (task-oriented file map: "if you need X, edit Y")
11
11
-`README.md` (setup, build, release, and broader project docs)
12
-
-`docs/shaping/rest-api-migration.md` (architecture decision: ACP to REST API migration)
12
+
-`docs/shaping/rest-api-migration.md` (REST backend architecture and parity status)
13
13
14
14
## Project Purpose
15
15
@@ -29,17 +29,15 @@ We pull upstream CodexMonitor changes regularly (weekly/monthly). The fork's tra
29
29
30
30
The frontend thread reducer receives events in the **same shape** as original CodexMonitor. All OpenCode-to-CodexMonitor translation happens in Rust, never in the frontend.
31
31
32
-
### Backend: Migrating from ACP to REST API
32
+
### Backend: REST API
33
33
34
-
The backend is migrating from `opencode acp` (JSON-RPC over stdio) to `opencode serve` (HTTP REST + SSE). See `docs/shaping/rest-api-migration.md` for the full rationale, requirements, and implementation slices.
35
-
36
-
The migration touches three files — the same three already diverged from upstream:
34
+
The backend uses `opencode serve` (HTTP REST + SSE). The translation layer is isolated to three Rust files so frontend merges stay clean:
37
35
38
36
-`src-tauri/src/backend/event_translator.rs` — protocol events to CodexMonitor event shapes
39
37
-`src-tauri/src/shared/codex_core.rs` — all protocol methods
40
38
-`src-tauri/src/backend/app_server.rs` — process spawn, event routing
41
39
42
-
Internal Rust module paths (`codex_core.rs`, `codex/mod.rs`, etc.) are **not renamed** — only user-facing strings. This minimizes merge conflicts with upstream.
40
+
Internal Rust module paths (`codex_core.rs`, `codex/mod.rs`, etc.) are **not renamed** — only user-facing strings. This minimizes merge conflicts with upstream. (The original CodexMonitor used Codex CLI; this fork uses OpenCode REST instead.)
43
41
44
42
## Non-Negotiable Architecture Rules
45
43
@@ -178,7 +176,7 @@ Use extra care in high-churn/high-complexity files:
178
176
179
177
- Task-oriented code map: `docs/codebase-map.md`
180
178
- Setup/build/release/test commands: `README.md`
181
-
-Architecture decision (ACP to REST migration): `docs/shaping/rest-api-migration.md`
0 commit comments