Skip to content
Back to search

roam-releases

Let your coding agents share memory and message each other across machines: OpenCode, Claude Code, Codex, Cursor, Gemini CLI. Docs and Windows releases.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/deepxd-code--roam-releases/badge.svg)](/listings/deepxd-code--roam-releases)

HTML

<a href="/listings/deepxd-code--roam-releases"><img src="/api/listings/deepxd-code--roam-releases/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Make a **private repo** on GitHub (or anywhere git can push) and clone it: `git clone <your-private-repo-url> $HOME\roam-relay` 2. Download `roam-setup-x64-2.5.1.exe` from [Releases](https://github.com/DeepxD-code/roam-releases/releases/latest) and run it. Windows SmartScreen will warn once: the installer isn't code-signed yet. Verify it with the published SHA-256 if you like. 3. The setup finds your agents and asks which to capture. 4. Work as usual. On your other machine: clone the same repo to `$HOME\roam-relay`, install, run `roam resume`.

Full guide: [docs/INSTALL.md](docs/INSTALL.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 85 lines
  1. # Roam
  2. **Let your coding agents share memory and message each other — across machines, across agents.**
  3. Roam saves every OpenCode, Claude Code, Codex, Cursor and Gemini CLI session to a private
  4. git repo **you** choose. On your other machine, or in a different agent, you pick up exactly
  5. where you stopped: `roam resume` brings back the latest session, `roam search` finds
  6. anything older, and agents can leave each other signed notes.
  7. No Roam server. No account. Your sessions only ever go to your own repo.
  8. **[Download for Windows (v2.5.1)](https://github.com/DeepxD-code/roam-releases/releases/latest)** ·
  9. [Website](https://roam-rho-gold.vercel.app) · [Install guide](docs/INSTALL.md) ·
  10. [Privacy](docs/PRIVACY.md) · [FAQ](docs/FAQ.md) · [Changelog](CHANGELOG.md)
  11. ---
  12. ## What it does
  13. | | |
  14. |---|---|
  15. | **Capture** | Each agent session becomes a markdown handoff: prompts, answers, files touched, todos. OpenCode through a live plugin; Claude Code, Codex, Cursor, Gemini CLI, Antigravity, Crush and Aider through a small background watcher. |
  16. | **Sync** | Handoffs are committed to a private git remote you own (GitHub, GitLab, your own server). Append-only: git stores each new line once. |
  17. | **Resume** | `roam resume` (or `roam_resume` inside the agent) loads the latest session for this project, from any machine. |
  18. | **Search** | `roam search <words>` searches every session, on every machine, in every agent. A local index keeps it fast. |
  19. | **Agents talk to each other** | `roam_send` / `roam_inbox`: an agent on one machine can leave a signed note for the agents on another, or for a different agent on the same machine. |
  20. | **MCP server** | `roam serve` exposes `roam_search`, `roam_resume`, `roam_inbox` and more to any MCP-capable agent. |
  21. | **Secret scrubbing** | API keys, tokens, connection strings and similar are removed before anything is written. |
  22. ## Measured, not promised
  23. On a real 4.8 GB session history (Windows laptop, November 2026):
  24. | | |
  25. |---|---|
  26. | `roam search`, rare word | ~0.6 s |
  27. | `roam search`, very common word | ~5 s |
  28. | `roam_search` inside OpenCode | 1–3 s rare word, ~8 s common word |
  29. | First index build (one-time) | 78 s, 1.2 GB RAM |
  30. | Same-machine message delivery | a local file write (5–37 ms) |
  31. | Two-machine test (separate Windows VM) | 7/7 checks pass: each machine finds and resumes the other's sessions |
  32. ## Quick start
  33. 1. Make a **private repo** on GitHub (or anywhere git can push) and clone it:
  34. `git clone <your-private-repo-url> $HOME\roam-relay`
  35. 2. Download `roam-setup-x64-2.5.1.exe` from [Releases](https://github.com/DeepxD-code/roam-releases/releases/latest) and run it.
  36. Windows SmartScreen will warn once: the installer isn't code-signed yet. Verify it with the published SHA-256 if you like.
  37. 3. The setup finds your agents and asks which to capture.
  38. 4. Work as usual. On your other machine: clone the same repo to `$HOME\roam-relay`, install, run `roam resume`.
  39. Full guide: [docs/INSTALL.md](docs/INSTALL.md).
  40. ## Agent skill
  41. [`skills/roam/SKILL.md`](skills/roam/SKILL.md) is a free skill that tells your agent when to use
  42. Roam: `roam_resume` at the start of a session, `roam_search` before asking you about past work,
  43. and `roam_send` / `roam_inbox` to hand work between agents. Drop the `roam` folder into your
  44. agent's skills folder (for Claude Code: `~/.claude/skills/`). It needs Roam installed.
  45. ## Platforms
  46. - **Windows 10/11:** supported.
  47. - **macOS (Apple Silicon) / Linux x64:** preview builds on every release, tested in CI on real macOS and Ubuntu machines. See [docs/INSTALL-MAC-LINUX.md](docs/INSTALL-MAC-LINUX.md). The guided setup hasn't been run on a real Mac or Linux desktop yet, so [tell me](https://github.com/DeepxD-code/roam-releases/issues/new/choose) if anything breaks.
  48. ## Free and Pro
  49. | | Free | Pro (₹1,499 / 6 months) |
  50. |---|---|---|
  51. | Capture, resume and search on your machine | ✅ | ✅ |
  52. | All supported agents, MCP server, secret scrubbing | ✅ | ✅ |
  53. | Pair machines and message between them | | ✅ |
  54. | Semantic search, voice notes, PR summaries, stats (Labs) | | ✅ |
  55. ## Bugs and ideas
  56. Please [open an issue](https://github.com/DeepxD-code/roam-releases/issues/new/choose).
  57. Run `roam feedback` to write a diagnostic report you can attach (it's written locally; nothing is sent).
  58. ## License
  59. Roam is proprietary software by DeepxD-code. The Free tier is free to download and use;
  60. the source code isn't public. This repository holds documentation and release builds.
  61. Security reports: see [SECURITY.md](SECURITY.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.