Roadmap

Roadmap

What's next for Scarf. Public, opinionated, subject to change. The internal version of this lives in scarf/docs/ROADMAP.md — the public wiki version is a distillation.

Now (2.0.x)

• Stability. 2.0 was a big multi-server release. Expect 2.0.x patches focused on edge cases in remote diagnostics, snapshot recovery, ACP reconnection, and correctness.
• Wiki bootstrap. This wiki is new — Phase 2 is filling it out, Phase 3 is keeping it in sync (ongoing).

Near-term

These are the unblocked candidates for 2.1 / 2.2:

• Test coverage. A MockTransport unlocks unit-testing the service layer; protocol-oriented testing for HermesEnvService, ACPClient framing, HermesPathSet, HermesConfig decoding. See Testing.
• Mermaid diagrams in the wiki. Architecture pages get a lot of value from one good diagram; deferred to keep Phase 1 focused on text.
• Per-project FSEvents on remote. Remote currently has one global mtime-poll loop (HermesFileWatcher line 84 has a TODO); per-project paths would reduce remote chattiness.
• More MCP presets. The curated list grows as MCP ecosystem matures.

Medium-term

• Custom commands palette. A ⌘K-style palette for quick actions across all sidebar sections.
• Better Insights. Rolling heatmaps, drill-downs from any chart, exportable summaries.
• Voice mode polish. Speaker selection, partial-results display, better handling of long-form dictation.
• In-app log filtering by structured fields. Currently text-search; a typed query (level=error AND component=gateway AND session=...) would help.

Long-term / speculative

• Versioned docs. GitHub wikis don't support /v1.0/ paths natively; could mirror to GitHub Pages with a static-site generator (deferred — see Wiki Maintenance "Out of scope").
• DocC → wiki bridge for auto-generated API reference.
• Translated wiki pages if there's demand.

What we're NOT doing

• A web version of Scarf. The whole point is being a native macOS app close to the metal.
• Background sync / push notifications. Scarf is a viewer; Hermes runs the agent.
• Bundled Hermes installer. Hermes installation belongs in Hermes-land.
• Closed-source / paid tier. MIT-licensed, free, will stay that way.

Suggesting features

Open an issue at https://github.com/awizemann/scarf/issues with what you want and why. Star the repo if you'd use it (signal helps prioritization).

---

Last updated: 2026-04-20 — Scarf v2.0.1