From 4167ddcd96469fc8d56999a1c63ca077728079b5 Mon Sep 17 00:00:00 2001 From: arkml <6592213+arkml@users.noreply.github.com> Date: Wed, 21 Jan 2026 18:04:54 +0530 Subject: [PATCH 1/4] Revise README with updated links and project details Updated links, improved project description, and added demo section. --- README.md | 164 +++++++++++++++++++----------------------------------- 1 file changed, 57 insertions(+), 107 deletions(-) diff --git a/README.md b/README.md index 8dda9c59..0a03a770 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@

- rowboatlabs%2Frowboat | Trendshift + rowboatlabs/rowboat | Trendshift

@@ -12,141 +12,91 @@ Discord - + Website Twitter - - Y Combinator -

-# RowboatX - Claude Code for Everyday Automations +# Rowboat +**An open-source, local-first AI coworker with memory for everyday work** + -RowboatX is a local-first CLI for creating background AI agents with full shell access. +Rowboat connects your email and meeting notes, builds long-lived knowledge from them, and uses that knowledge to help get work done on your machine. -**Example agents you can create:** -- Research every person before your meetings (Exa search MCP + Google Calendar MCP) -- Daily podcast summarizing your saved articles (ElevenLabs MCP + ffmpeg) -- Auto-triage Slack DMs and draft responses while you sleep (Slack MCP) - -## Quick start -```bash -npx @rowboatlabs/rowboatx@latest -``` +--- ## Demo -[![Screenshot](https://github.com/user-attachments/assets/ab46ff8b-44bd-400e-beb0-801c6431033f)](https://www.youtube.com/watch?v=cyPBinQzicY&t) -## Examples -### Add and Manage MCP servers -`$ rowboatx` -- Add MCP: 'Add this MCP server config: \ ' -- Explore tools: 'What tools are there in \ ' +[![Demo video](https://github.com/user-attachments/assets/f378285b-4ef3-4a4b-aa20-7dbb664e496c)](https://www.youtube.com/watch?v=T2Bmiy05FrI) -### Create background agents -`$ rowboatx` -- 'Create agent to do X.' -- '... Attach the correct tools from \ to the agent' -- '... Allow the agent to run shell commands including ffmpeg' +--- -### Schedule and monitor agents -`$ rowboatx` -- 'Make agent \ run every day at 10 AM' -- 'What agents do I have scheduled to run and at what times' -- 'When was \ last run' -- 'Are any agents waiting for my input or confirmation' +## Quick start -### Run background agents manually -``` bash -rowboatx --agent= --input="xyz" --no-interactive=true -``` -```bash -rowboatx --agent= --run_id= # resume from a previous run -``` -## Models support -You can configure your models using: -```bash -rowboatx model-config -``` +**Download for Mac:** -Alternatively, you can directly edit `~/.rowboat/config/models.json` -```json -{ - "providers": { - "openai": { - "flavor": "openai" - }, - "lm-studio": { - "flavor": "openai-compatible", - "baseURL": "http://localhost:2000/...", - "apiKey": "...", - "headers": { - "foo": "bar" - } - }, - "anthropic": { - "flavor": "anthropic" - }, - "google": { - "flavor": "google" - }, - "ollama": { - "flavor": "ollama" - } - }, - "defaults": { - "provider": "lm-studio", - "model": "gpt-5" - } -} -``` -## Contributing +https://github.com/rowboatlabs/rowboat/releases/latest -We want help with: -- **Agent templates** - Pre-built agents others can use (podcast generator, meeting prep, etc.) -- **MCP server integrations** - Add support for new tools -- **Platform support** - Windows improvements, Linux edge cases +Or build from source: ```bash -git clone git@github.com:rowboatlabs/rowboat.git -cd rowboat -npm install -npm run build -npm link -rowboatx +[build instructions] ``` -Ping us on [Discord](https://discord.com/invite/rxB8pzHxaS) if you want to discuss before building. +## What it does ---- -## Prefer a Web UI: Rowboat Studio +Rowboat ingests your: +- **Email** (Gmail) +- **Meeting notes** (Granola, Fireflies) -*Cursor for Multi-agent Workflows* +and organizes them into a local, Obsidian-compatible vault of plain Markdown files with backlinks. -⚡ Build AI agents instantly with natural language | 🔌 Connect tools with one-click integrations | 📂 Power with knowledge by adding documents for RAG | 🔄 Automate workflows by setting up triggers and actions | 🚀 Deploy anywhere via API or SDK

+This vault is not just for browsing or search. It becomes a working memory that Rowboat’s AI uses to take actions on your behalf. -### Quick start -1. Set your OpenAI key - ```bash - export OPENAI_API_KEY=your-openai-api-key - ``` - -2. Clone the repository and start Rowboat (requires Docker) - ```bash - ./start.sh - ``` +As new emails and meetings come in, the relevant notes update automatically, building persistent context across people, projects, organizations, and topics. -3. Access the app at [http://localhost:3000](http://localhost:3000). +--- + +## How it’s different + +Most AI tools reconstruct context on demand by searching transcripts or documents. + +Rowboat maintains **long-lived knowledge** instead: +- context accumulates over time +- relationships are explicit and inspectable +- notes are editable by you, not hidden inside a model +- everything lives on your machine as plain Markdown + +The result is memory that compounds, rather than retrieval that starts cold every time. + +--- + +## What you can do with it + +Rowboat uses this knowledge to help with everyday work, including: + +- Drafting emails using accumulated context +- Preparing for meetings from prior decisions and discussions +- Organizing files and project artifacts as work evolves +- Running shell commands or scripts as agent actions +- Extending capabilities via external tools and MCP servers + +Actions are explicit and grounded in the current state of your knowledge. + +--- + +## Local-first by design + +- All data is stored locally as plain Markdown +- No proprietary formats or hosted lock-in +- Works with local models via Ollama or LM Studio, or hosted models if you prefer +- You can inspect, edit, back up, or delete everything at any time -#### Create a multi-agent assistant with MCP tools by chatting with Rowboat -[![meeting-prep](https://github.com/user-attachments/assets/c8a41622-8e0e-459f-becb-767503489866)](https://youtu.be/KZTP4xZM2DY) -See [Docs](https://docs.rowboatlabs.com/) for more details. - ---
From 70ffbfb3194f1423e79d3bd4c60259f2c8b32288 Mon Sep 17 00:00:00 2001 From: arkml <6592213+arkml@users.noreply.github.com> Date: Wed, 21 Jan 2026 18:17:14 +0530 Subject: [PATCH 2/4] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0a03a770..d02b5df6 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -![ui](https://github.com/user-attachments/assets/fdf0679f-b107-48ce-b326-04db752838d9) +![ui](https://github.com/user-attachments/assets/0a742932-9c84-4fda-a3f7-c4157d9f99c0)
From b0cf13a194c5f4890ebb45e101d21c488fd3853b Mon Sep 17 00:00:00 2001 From: arkml <6592213+arkml@users.noreply.github.com> Date: Wed, 21 Jan 2026 18:25:44 +0530 Subject: [PATCH 3/4] Update README with new badges and remove duplicates Removed duplicate website link and added Y Combinator badge. --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index d02b5df6..4c2df7ac 100644 --- a/README.md +++ b/README.md @@ -9,15 +9,18 @@

+ + Website + Discord - - Website - Twitter + + Y Combinator +

# Rowboat From 5404eff655df5ed80a316805bf8ec3ad0ae4a7af Mon Sep 17 00:00:00 2001 From: arkml <6592213+arkml@users.noreply.github.com> Date: Wed, 21 Jan 2026 19:22:02 +0530 Subject: [PATCH 4/4] Update Discord link and remove build instructions --- README.md | 13 +++---------- 1 file changed, 3 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 4c2df7ac..09fd5f95 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -![ui](https://github.com/user-attachments/assets/0a742932-9c84-4fda-a3f7-c4157d9f99c0) +Work knowledge graph
@@ -12,7 +12,7 @@ Website - + Discord @@ -44,13 +44,6 @@ Rowboat connects your email and meeting notes, builds long-lived knowledge from https://github.com/rowboatlabs/rowboat/releases/latest - -Or build from source: - -```bash -[build instructions] -``` - ## What it does Rowboat ingests your: @@ -105,5 +98,5 @@ Actions are explicit and grounded in the current state of your knowledge. Made with ❤️ by the Rowboat team -[Discord](https://discord.gg/rxB8pzHxaS) · [Twitter](https://x.com/intent/user?screen_name=rowboatlabshq) +[Discord](https://discord.com/invite/htdKpBZF) · [Twitter](https://x.com/intent/user?screen_name=rowboatlabshq)