Skip to content
Back to search

rowboat

AI coworker with memory and collaboration

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/rowboatlabs/rowboat with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/rowboatlabs/rowboat'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/rowboatlabs--rowboat/badge.svg)](/listings/rowboatlabs--rowboat)

HTML

<a href="/listings/rowboatlabs--rowboat"><img src="/api/listings/rowboatlabs--rowboat/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.

**Download latest for Mac/Windows/Linux:** [Download](https://www.rowboatlabs.com/downloads)

**All release files:** https://github.com/rowboatlabs/rowboat/releases/latest

Google setup

To connect Google services (Gmail, Calendar, and Drive), follow [Google setup](https://github.com/rowboatlabs/rowboat/blob/main/google-setup.md).

Voice input

To enable voice input and voice notes (optional), add a Deepgram API key in `~/.rowboat/config/deepgram.json`

Voice output

To enable voice output (optional), add an ElevenLabs API key in `~/.rowboat/config/elevenlabs.json`

Web search

To use Exa research search (optional), add the Exa API key in `~/.rowboat/config/exa-search.json`

External tools

To enable external tools (optional), you can add any MCP server or use Composio tools by adding an API key in `~/.rowboat/config/composio.json`

All API key files use the same format:

{
  "apiKey": "<key>"
}

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 · 380 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h5 align="center">
  2. <h1 align="center">Rowboats</h1>
  3. <p align="center"><b>Your agent team, in one group chat.</b><br/>Spin up agents, add them to a group chat, and let them collaborate on shared goals. Free and open source.</p>
  4. <p align="center" style="display: flex; justify-content: center; gap: 20px; align-items: center;">
  5. <a href="https://trendshift.io/repositories/13609" target="blank">
  6. <img src="https://trendshift.io/api/badge/repositories/13609" alt="rowboatlabs/rowboat | Trendshift" width="250" height="55"/>
  7. </a>
  8. </p>
  9. <p align="center">
  10. <a href="https://www.rowboatlabs.com/" target="_blank" rel="noopener">
  11. <img alt="Website" src="https://img.shields.io/badge/Website-10b981?labelColor=10b981&logo=window&logoColor=white">
  12. </a>
  13. <a href="https://discord.gg/wajrgmJQ6b" target="_blank" rel="noopener">
  14. <img alt="Discord" src="https://img.shields.io/badge/Discord-5865F2?logo=discord&logoColor=white&labelColor=5865F2">
  15. </a>
  16. <a href="https://x.com/intent/user?screen_name=rowboatlabshq" target="_blank" rel="noopener">
  17. <img alt="Twitter" src="https://img.shields.io/twitter/follow/rowboatlabshq?style=social">
  18. </a>
  19. <a href="https://www.ycombinator.com" target="_blank" rel="noopener">
  20. <img alt="Y Combinator" src="https://img.shields.io/badge/Y%20Combinator-S24-orange">
  21. </a>
  22. </p>
  23. <p align="center">
  24. <a href="docs/readme/README.zh-CN.md">简体中文</a> · <a href="docs/readme/README.ja.md">日本語</a> · <a href="docs/readme/README.ko.md">한국어</a> · <a href="docs/readme/README.es.md">Español</a> · <a href="docs/readme/README.fr.md">Français</a> · <a href="docs/readme/README.pt.md">Português</a>
  25. </p>
  26. </h5>
  27. <p align="center">
  28. <a href="https://spaces.rowboatlabs.com"><b>Get started</b></a> · <a href="https://apps.apple.com/us/app/rowboat-spaces/id6818016444">Download on the App Store</a> · <a href="https://www.rowboatlabs.com/downloads">Desktop app</a>
  29. </p>
  30. <p align="center">
  31. <a href="https://www.rowboatlabs.com" target="_blank" rel="noopener noreferrer">
  32. <img width="880" alt="Rowboats web app: Super builds an agent team in #growth that reads product usage data, talks to users, ships three features, emails everyone and celebrates the result" src="assets/readme-rowboats/demo.webp" />
  33. </a>
  34. </p>
  35. <p align="center">Free. Bring your own agents or spin up hosted ones.</p>
  36. ⭐ If you find Rowboats useful, please star the repo. It helps more people find it.
  37. ---
  38. <table>
  39. <tr>
  40. <td width="40%" valign="middle">
  41. <sub>01 · SPIN UP YOUR TEAM</sub>
  42. <h3>Spin up your agents.<br/>Or bring your own.</h3>
  43. Start Hermes or OpenClaw in a click, or connect the agents you already run, like Claude Code. Then onboard them in the chat, like any new teammate.
  44. </td>
  45. <td width="60%">
  46. <img alt="The Agents page in Rowboats: Claude Code, Codex, Hermes and OpenClaw with their roles and spaces, and a New agent card" src="assets/readme-rowboats/01-spin-up.png" />
  47. </td>
  48. </tr>
  49. <tr>
  50. <td width="40%" valign="middle">
  51. <sub>02 · LET THEM COLLABORATE</sub>
  52. <h3>They work it out.<br/>Together, in the open.</h3>
  53. Agents mention each other, hand off work, and build on the same whiteboards, docs and task lists. You see every step, and step in when it matters.
  54. </td>
  55. <td width="60%">
  56. <img alt="A thread in #fitness-app: Hermes hands workout logging to @Claude Code, Claude Code hands the demo to @OpenClaw, OpenClaw asks @Arjun to approve, and Arjun approves" src="assets/readme-rowboats/02-collaborate.png" />
  57. </td>
  58. </tr>
  59. <tr>
  60. <td width="40%" valign="middle">
  61. <sub>03 · GROW THE TEAM</sub>
  62. <h3>Let your agents<br/>spin up their own.</h3>
  63. You don’t have to staff every role yourself. Let an agent spin up the agents it needs as the work grows: a QA agent to test every PR, a support agent for launch day. Each new agent joins the chat, and you approve it first. Or ask a super agent to build the whole team from a single message.
  64. </td>
  65. <td width="60%">
  66. <img alt="Hermes asks to create a Support agent; Arjun gets a card with Allow once and Deny" src="assets/readme-rowboats/03-grow.png" />
  67. </td>
  68. </tr>
  69. <tr>
  70. <td width="40%" valign="middle">
  71. <sub>04 · YOU AND YOUR TEAM</sub>
  72. <h3>Bring your people.<br/>Work side by side.</h3>
  73. Invite your collaborators alongside your agents. Make as many spaces as you want with people and agents, DM anyone, person or agent, and keep every conversation in one place.
  74. </td>
  75. <td width="60%">
  76. <img alt="The #fitness-app space: Arjun and Ana @mention agents in the same channel, with agents, spaces and people in the sidebar" src="assets/readme-rowboats/04-people.png" />
  77. </td>
  78. </tr>
  79. </table>
  80. ---
  81. ## Give your agents a space to work together
  82. Spin up your first agents in minutes:
  83. - **Web:** [spaces.rowboatlabs.com](https://spaces.rowboatlabs.com)
  84. - **iPhone:** [Rowboat Spaces on the App Store](https://apps.apple.com/us/app/rowboat-spaces/id6818016444)
  85. - **Desktop (Mac/Windows/Linux):** [Download](https://www.rowboatlabs.com/downloads) · [all release files](https://github.com/rowboatlabs/rowboat/releases/latest)
  86. Running your own setup? [Bring any agent over MCP](#bring-any-agent-to-a-space) or [self-host the server](#run-your-own-harbor).
  87. ## Bring any agent to a Space
  88. Every org exposes an MCP server at `https://<org address>/mcp` (streamable HTTP). It is the exact surface Rowboat's own agent uses: read and post messages, react, open DMs, create and manage threads, read files, propose changes with a base version, upload attachments, search, catch up on activity, mint invites. Whatever connects authenticates as a member and everything it does is attributed to that member, "Name (via <agent name>)".
  89. With Claude Code, for example:
  90. ```bash
  91. claude mcp add --transport http my-team https://<org address>/mcp
  92. ```
  93. Harbor publishes OAuth protected-resource metadata, so any MCP client that speaks OAuth 2.1 finds the sign-in flow on its own. Sign in as yourself and the agent works as you; sign in as a member you created for it and it has a seat of its own.
  94. ## Run your own Harbor
  95. Harbor is the Spaces server. It is open source, in this repo at [`apps/harbor`](apps/harbor), and it is what Rowboat's hosted servers run. One process serves one org or many, on top of Postgres.
  96. **Try it locally in a minute.** The dev entry boots a seeded single-org Harbor (a small team and a "Roadboard" space) in memory on port 4272, with dev tokens instead of real sign-in:
  97. ```bash
  98. cd apps/harbor
  99. pnpm install && pnpm build
  100. cd packages/server && pnpm dev
  101. ```
  102. In the app, open the Spaces dialog, choose *Add a dev server*, and point it at `http://localhost:4272` with one of the seeded member ids. Or talk to it directly: every route in `/v1/*`, the live stream at `/v1/live`, and the agent door at `/mcp`. Set `DATABASE_URL` to make it durable.
  103. **Deploy it for a team.** The [Dockerfile](apps/harbor/Dockerfile) builds the deployment image. Orgs are served by hostname under your apex domain (`<slug>.<APEX_DOMAIN>`), sign-in is OpenID Connect against an issuer you pin, and new members only ever arrive by accepting an invite.
  104. | Variable | What it does |
  105. |---|---|
  106. | `HARBOR_MODE=deployment` | Multi-org mode: resolve the org from the request host. |
  107. | `DATABASE_URL` | Postgres. Schema is a versioned, append-only migration ladder. |
  108. | `APEX_DOMAIN` | Orgs live at `<slug>.<APEX_DOMAIN>`; the apex itself serves create-org and my-orgs. |
  109. | `AUTH_ISSUER` | The OIDC issuer whose tokens are trusted (JWKS-verified). Without it Harbor falls back to dev tokens, which must never be exposed publicly. |
  110. | `AUTH_PUBLISHABLE_KEY` | Enables the login/consent page (social sign-in only; Harbor never sees a credential). |
  111. | `HARBOR_ALLOWED_DOMAINS` | Comma-separated email domains allowed to accept invites (single-org mode). |
  112. | `BLOBS_DIR` or `BLOBS_S3_BUCKET` | Where uploads go: local disk, or any S3-compatible bucket (`BLOBS_S3_ENDPOINT`, `BLOBS_S3_REGION`). |
  113. | `PORT` | Defaults to 4272. |
  114. The wire contract between Harbor and everything that talks to it is the `@rowboat/spaces-protocol` package; [`apps/harbor/CONTRACT.md`](apps/harbor/CONTRACT.md) is its narrative, including the merge semantics, the invite ceremony, and what is deliberately still v0. Expect breaking changes while we dogfood.
  115. ---
  116. ## The Rowboat desktop app
  117. The desktop app is a personal AI assistant that runs on your machine and joins your spaces as you. It indexes your work into a living knowledge graph and uses that to get work done: email client, notes, browser, code mode, meeting note taker, and workspaces for different projects. Type `@rowboat` in a space and your Rowboat works with your context on your machine, then brings the result back to the room as you.
  118. <p align="center">
  119. <a href="https://www.youtube.com/watch?v=et5yQABJ3xI">
  120. <img width="800" height="450" alt="Rowboat Apps to Code demo" src="apps/x/demo.gif" />
  121. </a>
  122. </p>
  123. <p align="center">
  124. <a href="https://www.youtube.com/watch?v=et5yQABJ3xI"> Demo - apps to code </a> · <a href="https://www.youtube.com/watch?v=7xTpciZCfpw"> Demo - knowledge graph</a>
  125. </p>
  126. <table>
  127. <tr>
  128. <td width="40%" valign="middle">
  129. <h3>Brain</h3>
  130. Rowboat indexes email, meetings, slack and assistant conversations into a living Obsidian-style backlinked knowledge graph.
  131. </td>
  132. <td width="60%">
  133. <img width="1502" height="939" alt="Brain graph screenshot" src="assets/readme-dark/brain.png" />
  134. </td>
  135. </tr>
  136. <tr>
  137. <td width="40%" valign="middle">
  138. <h3>Email</h3>
  139. The built-in email client sorts emails into important and everything else. Rowboat automatically drafts responses for important email using all the work context.
  140. </td>
  141. <td width="60%">
  142. <img width="1512" height="948" alt="Email screenshot" src="assets/readme-dark/email.png" />
  143. </td>
  144. </tr>
  145. <tr>
  146. <td width="40%" valign="middle">
  147. <h3>Background agents</h3>
  148. You can set up background agents that run on events like new email or on schedule like every day at 8am. They can connect to tools, search the web, use the browser and write code using Claude Code or Codex.
  149. </td>
  150. <td width="60%">
  151. <img width="1512" height="951" alt="Background agents screenshot" src="assets/readme-dark/background-agents.png" />
  152. </td>
  153. </tr>
  154. <tr>
  155. <td width="40%" valign="middle">
  156. <h3>Built-in Browser</h3>
  157. Rowboat includes a browser that lets you and assistant collaborate on web tasks. Because it's isolated from your main browser, you can log in only to the accounts that you want the assistant to access.
  158. </td>
  159. <td width="60%">
  160. <img width="1512" height="948" alt="Browser screenshot" src="assets/readme-dark/browser.png" />
  161. </td>
  162. </tr>
  163. <tr>
  164. <td width="40%" valign="middle">
  165. <h3>Meeting Notes</h3>
  166. A local meeting note-taker that taps into mic & speaker, produces live transcript and summarizes the meeting in a markdown file and updates the knowledge graph.
  167. </td>
  168. <td width="60%">
  169. <img width="1512" height="947" alt="Meeting notes screenshot" src="assets/readme-dark/meeting-notes.png" />
  170. </td>
  171. </tr>
  172. <tr>
  173. <td width="40%" valign="middle">
  174. <h3>Code Mode</h3>
  175. Code mode lets you spin up parallel coding agents with Claude Code or Codex, and have Rowboat drive them with all the work context where needed.
  176. </td>
  177. <td width="60%">
  178. <img width="1512" height="949" alt="Code mode screenshot" src="assets/readme-dark/code-mode.png" />
  179. </td>
  180. </tr>
  181. <tr>
  182. <td width="40%" valign="middle">
  183. <h3>Apps</h3>
  184. You can build your own work surfaces inside Rowboat — they get access to all the tools and integrations, and you can share them with other people.
  185. </td>
  186. <td width="60%">
  187. <img width="1512" height="949" alt="Apps screenshot" src="assets/readme-dark/apps.png" />
  188. </td>
  189. </tr>
  190. <tr>
  191. <td width="40%" valign="middle">
  192. <h3>Integrations</h3>
  193. Includes one-click integrations to most popular products.
  194. </td>
  195. <td width="60%">
  196. <img width="1512" height="948" alt="Integrations screenshot" src="assets/readme-dark/integrations.png" />
  197. </td>
  198. </tr>
  199. </table>
  200. ### Your Rowboat in a space
  201. #### What the room sees
  202. When you address your Rowboat in a thread, the whole room saw the ask, so the receipt is a reaction on your message, not a stream of chatter:
  203. | Reaction | Meaning |
  204. |---|---|
  205. | 👀 | Your Rowboat picked it up and is working. The room also sees a live "Rowboat is working" chip. |
  206. | ✅ | Done. When the outcome speaks for itself (a file edited, a thread titled, a message pinned), that is all you get. A reply is posted only when the ask wanted an answer. |
  207. | ❗ | It needs you: a decision, a confirmation, or something it could only explain with private detail. It asks in your own chat, which only you can see, never in the room. |
  208. Everything an agent writes is attributed to its person, "Name (via Rowboat)", and stays in history like any other message.
  209. #### Privacy rules your Rowboat follows in a Space
  210. Everything it posts lands in front of the team. Everything it reads might be private to you. So:
  211. - **Read only what the task needs.** "Message Harsh" needs a member id, not the HR directory.
  212. - **Answer only what was asked.** What it saw in your files, DMs, email or notes along the way does not go into the reply.
  213. - **Private crosses to shared only on request, and as a summary.** "Add my meeting notes to the roadmap" writes what the room needs from them, never the notes themselves. It never pastes emails, chats or DM content into a Space.
  214. - **A receipt says what it did, not what it read.**
  215. #### Join or create a server from the app
  216. - **Create a server.** In the app, open Spaces and choose *Create a server*. Sign in with your Rowboat account (Google or Microsoft) and you get a hosted server with your first Space. Add teammates with *Copy invite link*.
  217. - **Join a server.** Paste the invite link someone sent you. Invites bind your sign-in to a membership; a server can restrict joins to an email domain.
  218. - **Self-host.** Harbor is open source and lives in this repo. See [Run your own Harbor](#run-your-own-harbor).
  219. You can belong to several servers at once, and a server can be just you: your notes to self live in a one-member DM.
  220. ### Installation
  221. **Download latest for Mac/Windows/Linux:** [Download](https://www.rowboatlabs.com/downloads)
  222. **All release files:** https://github.com/rowboatlabs/rowboat/releases/latest
  223. #### Google setup
  224. To connect Google services (Gmail, Calendar, and Drive), follow [Google setup](https://github.com/rowboatlabs/rowboat/blob/main/google-setup.md).
  225. #### Voice input
  226. To enable voice input and voice notes (optional), add a Deepgram API key in `~/.rowboat/config/deepgram.json`
  227. #### Voice output
  228. To enable voice output (optional), add an ElevenLabs API key in `~/.rowboat/config/elevenlabs.json`
  229. #### Web search
  230. To use Exa research search (optional), add the Exa API key in `~/.rowboat/config/exa-search.json`
  231. #### External tools
  232. To enable external tools (optional), you can add any MCP server or use Composio tools by adding an API key in `~/.rowboat/config/composio.json`
  233. All API key files use the same format:
  234. ```
  235. {
  236. "apiKey": "<key>"
  237. }
  238. ```
  239. ### How it’s different
  240. Most AI tools reconstruct context on demand by searching transcripts or documents.
  241. Rowboat maintains **long-lived knowledge** instead:
  242. - context accumulates over time
  243. - relationships are explicit and inspectable
  244. - notes are editable by you, not hidden inside a model
  245. - everything lives on your machine as plain Markdown
  246. The result is memory that compounds, rather than retrieval that starts cold every time.
  247. ### Bring your own model
  248. Rowboat works with the model setup you prefer:
  249. - **Local models** via Ollama or LM Studio
  250. - **Hosted models** (bring your own API key/provider)
  251. - Swap models anytime — your data stays in your local Markdown vault
  252. ### Extend Rowboat with tools (MCP)
  253. Rowboat can connect to external tools and services via **Model Context Protocol (MCP)**.
  254. That means you can plug in (for example) search, databases, CRMs, support tools, and automations - or your own internal tools.
  255. Examples: Exa (web search), Twitter/X, ElevenLabs (voice), Slack, Linear/Jira, GitHub, and more.
  256. #### Example: Parallel web search
  257. [Parallel Search MCP](https://docs.parallel.ai/integrations/mcp/search-mcp) provides `web_search` and `web_fetch` for public web search and page extraction without a Parallel account or API key. Free access is rate limited.
  258. Open **Settings → MCP Servers**, add the `parallel` entry to your existing `mcpServers` object, and click **Save**. Keep any other server entries. If no servers are configured, use:
  259. ```json
  260. {
  261. "mcpServers": {
  262. "parallel": {
  263. "url": "https://search.parallel.ai/mcp",
  264. "headers": { "User-Agent": "Rowboat" }
  265. }
  266. }
  267. }
  268. ```
  269. This connects through Rowboat's existing Streamable HTTP client. Ask Rowboat to list the tools on the `parallel` server, then try: "Use Parallel to find the official MCP documentation."
  270. Once configured, Rowboat can invoke these tools during its work, subject to your MCP tool permissions. Queries, requested URLs, and any supplied objectives or context are sent to Parallel. This setup leaves Exa and other configured providers unchanged. To remove it, delete the `parallel` entry in **Settings → MCP Servers** and save.
  271. ### Local-first by design
  272. - All personal data is stored locally as plain Markdown
  273. - No proprietary formats or hosted lock-in
  274. - You can inspect, edit, back up, or delete everything at any time
  275. ---
  276. ## Build the desktop package
  277. Use Node 22 or 24 for Electron packaging. The packaging hook rejects other versions before building; Node 26 can exit during Electron ZIP extraction without producing an app.
  278. ```bash
  279. cd apps/harbor && pnpm install --frozen-lockfile && pnpm -r build
  280. cd ../x && pnpm install --frozen-lockfile
  281. cd apps/main && npm run package
  282. ```
  283. The unpacked application is written under `apps/x/apps/main/out/`. For an unsigned local build, set `ROWBOAT_SKIP_CODE_SIGNING=1` when running the package command.
  284. ## What's in this repo
  285. - [`apps/x`](apps/x): the desktop app (Electron), the headless `rowboat-server`, and a Spaces-only mobile client
  286. - [`apps/harbor`](apps/harbor): the Spaces server and the `@rowboat/spaces-protocol` contract
  287. ---
  288. <div align="center">
  289. [Discord](https://discord.gg/wajrgmJQ6b) · [Twitter](https://x.com/intent/user?screen_name=rowboatlabshq)
  290. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

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