From 131dcba8ce98d5abf8af63926f1de31cf192fb2e Mon Sep 17 00:00:00 2001 From: allo Date: Fri, 4 Sep 2026 09:59:04 +0800 Subject: [PATCH] docs: move roadmap from #4 to docs/ROADMAP.md --- docs/ROADMAP.md | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 docs/ROADMAP.md diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md new file mode 100644 index 0000000..dbfd4eb --- /dev/null +++ b/docs/ROADMAP.md @@ -0,0 +1,44 @@ +# Roadmap + +> Moved from issue #4 on 2026-09-04. Issues are for bug reports and feature requests; the roadmap lives here. To pick up an item, open an issue referencing it. + +## Where we are (v1.12) + +- **5 platforms** — OpenClaw, Codex, Claude Code, Hermes (SQLite) and OMP, parsed from their native log formats +- **Session browser** with tool-call inspection, trace/waterfall view, spawn tracking and message timeline +- **Prompt tooling** — extraction (noise filtered), template clustering with outcome attribution, Claude-powered rewrites, and a prompt library that installs entries as native slash commands +- **Global search** across all platforms, insights dashboard, incremental session backup +- **React + Vite frontend** served by an Express backend; 46 tests on Node's built-in runner, CI on Node 22 + +## Roadmap + +- [x] **Publish to npm** so `npx agent-xray` works without cloning — automated from GitHub releases (v1.14.0+) +- [x] **Hosted live demo** on GitHub Pages with clearly-labeled synthetic session data, so people can try the UI before installing +- [x] **Gemini CLI adapter** (`~/.gemini/tmp`) — shipped (#5) +- [ ] **More platform adapters** — opencode and Aider are the most-requested log formats; the per-platform module layout in `lib/platforms/` is designed for this +- [x] **Session export & sharing** — render a session (with tool calls) to a standalone Markdown/HTML file you can attach to a bug report or blog post (#6) +- [ ] **Cost & token analytics** — per-session and per-day token spend, broken down by model, building on the token counts we already parse for the summary panel +- [ ] **Watch mode ergonomics** — highlight the currently-active session and surface "agent is waiting for input" state in the sidebar + +### Product + +From a product review (2026-08-21) — funnel and retention fixes around the npm release: + +- [x] Demo must showcase the differentiators (search, spawn navigation, prompt library), not the thinnest layer (#12) +- [x] First launch: auto-pick the first platform that actually has sessions (#13) +- [x] Prompt optimization: drop the hard dependency on a local claude CLI (#14) + +### Tech debt + +Structural cleanups surfaced by a code review — not features, but they lower the cost of every future one: + +- [x] Extract a unified PLATFORMS registry to collapse seven copy-pasted adapter skeletons (#8) +- [x] Decide the legacy UI's fate and eliminate the markdown/pure double-write (#9) +- [x] Split server.js into route modules and lib/ business logic (#10) + +## Non-goals (for now) + +- Cloud sync or any server-side storage of session data — AgentXRay stays a local, read-only viewer of your own logs +- A plugin marketplace — adapters land in-tree until the format count justifies more + +Issue references above are created alongside this roadmap; anything without a link is open for discussion.