A desktop AI coworker with a memory of your work and built-in surfaces to act on it.
-
-
-
-Brain
-Rowboat indexes email, meetings, slack and assistant conversations into a living Obsidian-style backlinked knowledge graph.
- |
-
-
- |
-
-
-
-Email
-The built-in email client sorts emails into important and everything else. Rowboat automatically drafts responses for important email using all the work context.
- |
-
-
- |
-
-
-
-Background agents
-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.
- |
-
-
-
- |
-
-
-
-Built-in Browser
-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 want the assistant to access.
- |
-
-
- |
-
-
-
-Meeting Notes
-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.
- |
-
-
- |
-
-
-
-Code Mode
-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.
- |
-
-
- |
-
-
-
-Apps
-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.
- |
-
-
- |
-
-
-
-Integrations
-Includes one-click integrations to most popular products.
- |
-
-
- |
-
-
-
+[Watch the full video](https://www.youtube.com/watch?v=7xTpciZCfpw)
---
@@ -161,6 +81,23 @@ All API key files use the same format:
}
```
+## What it does
+
+Rowboat is a **local-first AI coworker** that can:
+- **Remember** the important context you don’t want to re-explain (people, projects, decisions, commitments)
+- **Understand** what’s relevant right now (before a meeting, while replying to an email, when writing a doc)
+- **Help you act** by drafting, summarizing, planning, and producing real artifacts (briefs, emails, docs, PDF slides)
+
+Under the hood, Rowboat maintains an **Obsidian-compatible vault** of plain Markdown notes with backlinks — a transparent “working memory” you can inspect and edit.
+
+## Integrations
+
+Rowboat builds memory from the work you already do, including:
+- **Gmail** (email)
+- **Google Calendar**
+- **Rowboat meeting notes** or **Fireflies**
+
+It also contains a library of product integrations through Composio.dev
## How it’s different
@@ -174,6 +111,24 @@ Rowboat maintains **long-lived knowledge** instead:
The result is memory that compounds, rather than retrieval that starts cold every time.
+## What you can do with it
+
+- **Meeting prep** from prior decisions, threads, and open questions
+- **Email drafting** grounded in history and commitments
+- **Docs & decks** generated from your ongoing context (including PDF slides)
+- **Follow-ups**: capture decisions, action items, and owners so nothing gets dropped
+- **On-your-machine help**: create files, summarize into notes, and run workflows using local tools (with explicit, reviewable actions)
+
+## Live notes
+
+Live notes are notes that stay updated automatically. You can create one by typing '@rowboat' on a note.
+
+- Track a competitor or market topic across X, Reddit, and the news
+- Monitor a person, project, or deal across web or your communications
+- Keep a running summary of any subject you care about
+
+Everything is written back into your local Markdown vault. You control what runs and when.
+
## Bring your own model
Rowboat works with the model setup you prefer:
diff --git a/apps/cli/src/application/lib/command-executor.ts b/apps/cli/src/application/lib/command-executor.ts
index b2a5a94f..cd16f05e 100644
--- a/apps/cli/src/application/lib/command-executor.ts
+++ b/apps/cli/src/application/lib/command-executor.ts
@@ -4,13 +4,7 @@ import { getSecurityAllowList, SECURITY_CONFIG_PATH } from '../../config/securit
import { getExecutionShell } from '../assistant/runtime-context.js';
const execPromise = promisify(exec);
-// Order matters: longer separators (`||`, `&&`) must precede their single-char
-// prefixes (`|`, `&`) so the leftmost-longest match consumes the right token.
-// `&` (background), backtick / `$(` (command substitution), and `(` `)`
-// (subshell) are also command separators — without them, `echo hi & rm /x`,
-// `echo \`rm /x\``, and `echo $(rm /x)` slip past isBlocked() with only
-// `echo` in the allowlist.
-const COMMAND_SPLIT_REGEX = /(?:\|\||&&|&|;|\||\n|`|\$\(|\(|\))/;
+const COMMAND_SPLIT_REGEX = /(?:\|\||&&|;|\||\n)/;
const ENV_ASSIGNMENT_REGEX = /^[A-Za-z_][A-Za-z0-9_]*=.*/;
const WRAPPER_COMMANDS = new Set(['sudo', 'env', 'time', 'command']);
const EXECUTION_SHELL = getExecutionShell();
diff --git a/apps/cli/todo.md b/apps/cli/todo.md
index 3ca4d45c..9c97afd3 100644
--- a/apps/cli/todo.md
+++ b/apps/cli/todo.md
@@ -12,4 +12,4 @@ o file logging
rowboat agent
---
-- create agent
+- create agent
\ No newline at end of file
diff --git a/apps/docs/docs.json b/apps/docs/docs.json
index 3178f741..8442b158 100644
--- a/apps/docs/docs.json
+++ b/apps/docs/docs.json
@@ -55,6 +55,6 @@
"chatgpt",
"claude"
]
- }
+ }
}
-
+
\ No newline at end of file
diff --git a/apps/docs/docs/development/contribution-guide.mdx b/apps/docs/docs/development/contribution-guide.mdx
index 8fbf2a1d..1089d7e0 100644
--- a/apps/docs/docs/development/contribution-guide.mdx
+++ b/apps/docs/docs/development/contribution-guide.mdx
@@ -52,4 +52,4 @@ Rowboat is open-source and we welcome contributions of all kinds — bug reports
## Getting Help
-If you're stuck or unsure about anything, drop a message in our [Discord](https://discord.gg/wajrgmJQ6b). We're happy to help you get unblocked.
+If you're stuck or unsure about anything, drop a message in our [Discord](https://discord.gg/wajrgmJQ6b). We're happy to help you get unblocked.
\ No newline at end of file
diff --git a/apps/docs/docs/development/roadmap.mdx b/apps/docs/docs/development/roadmap.mdx
index 8202b2b2..6248e567 100644
--- a/apps/docs/docs/development/roadmap.mdx
+++ b/apps/docs/docs/development/roadmap.mdx
@@ -4,4 +4,4 @@ icon: "road"
# Roadmap
-Explore the future development plans and upcoming features for Rowboat.
+Explore the future development plans and upcoming features for Rowboat.
\ No newline at end of file
diff --git a/apps/x/.gitignore b/apps/x/.gitignore
index 2c5f63fd..db195fb4 100644
--- a/apps/x/.gitignore
+++ b/apps/x/.gitignore
@@ -1,3 +1,2 @@
node_modules/
test-fixtures/
-*.tsbuildinfo
diff --git a/apps/x/.pnpm-store/v11/index.db b/apps/x/.pnpm-store/v11/index.db
deleted file mode 100644
index 7f9770bd..00000000
Binary files a/apps/x/.pnpm-store/v11/index.db and /dev/null differ
diff --git a/apps/x/ANALYTICS.md b/apps/x/ANALYTICS.md
index 5bc0f456..572e9a6f 100644
--- a/apps/x/ANALYTICS.md
+++ b/apps/x/ANALYTICS.md
@@ -16,15 +16,13 @@
## Event catalog
-All PostHog events include `app_version` and `platform: 'desktop'` automatically. Main-process events add them in `packages/core/src/analytics/posthog.ts`; renderer events get them from the `analytics:bootstrap` IPC payload via `posthog.register` (plus an initialization-time `before_send` hook for `app_version`). `platform` guards against the legacy web dashboard's autocapture (`apps/rowboat`, unidentified by design) muddying desktop dashboards if it ever shares the project.
-
### `llm_usage`
Emitted whenever ai-sdk returns token usage (one event per LLM call, not per run).
| Property | Type | Notes |
|---|---|---|
-| `use_case` | enum | `copilot_chat` / `live_note_agent` / `meeting_note` / `knowledge_sync` / `code_session` |
+| `use_case` | enum | `copilot_chat` / `live_note_agent` / `meeting_note` / `knowledge_sync` |
| `sub_use_case` | string? | Refines `use_case` — see taxonomy table below |
| `agent_name` | string? | Present when the call goes through an agent run (`createRun`); omitted for direct `generateText`/`generateObject` |
| `model` | string | e.g. `claude-sonnet-4-6` |
@@ -41,9 +39,9 @@ Every `llm_usage` emit point in the codebase:
| `use_case` | `sub_use_case` | `agent_name`? | Where | File:line |
|---|---|---|---|---|
-| `copilot_chat` | (none) | yes | User chat in renderer (turn runtime; the ALS default when no caller set a use case) | `packages/core/src/runtime/turns/bridges/real-usage-reporter.ts` (`reportModelUsage`); legacy runs (code-mode carve-out) still emit from `packages/core/src/runtime/legacy/engine.ts` (`streamLlm` finish-step) |
+| `copilot_chat` | (none) | yes | User chat in renderer (default for any `createRun` without `useCase`) | `packages/core/src/agents/runtime.ts:1313` (finish-step in `streamLlm`) |
| `copilot_chat` | `scheduled` | yes | Background scheduled agent runner | `packages/core/src/agent-schedule/runner.ts:167` |
-| `copilot_chat` | `file_parse` | inherits | `parseFile` builtin tool inside any chat | `packages/core/src/runtime/tools/domains/parsing.ts:179` |
+| `copilot_chat` | `file_parse` | inherits | `parseFile` builtin tool inside any chat | `packages/core/src/application/lib/builtin-tools.ts:770` |
| `live_note_agent` | `routing` | no | Pass 1 routing classifier (`generateObject`) | `packages/core/src/knowledge/live-note/routing.ts:93` |
| `live_note_agent` | `manual` | yes | Pass 2 agent run — user clicked Run / called the `run-live-note-agent` tool | `packages/core/src/knowledge/live-note/runner.ts:140` (createRun, `subUseCase: trigger`) |
| `live_note_agent` | `cron` | yes | Pass 2 agent run — cron expression matched | same call site |
@@ -53,10 +51,10 @@ Every `llm_usage` emit point in the codebase:
| `knowledge_sync` | `agent_notes` | yes | Agent notes learning service | `packages/core/src/knowledge/agent_notes.ts:309` (createRun) |
| `knowledge_sync` | `tag_notes` | yes | Note tagging | `packages/core/src/knowledge/tag_notes.ts:86` (createRun) |
| `knowledge_sync` | `build_graph` | yes | Knowledge graph note creation | `packages/core/src/knowledge/build_graph.ts:253` (createRun) |
+| `knowledge_sync` | `label_emails` | yes | Email labeling | `packages/core/src/knowledge/label_emails.ts:73` (createRun) |
| `knowledge_sync` | `inline_task_run` | yes | Inline `@rowboat` task execution (two call sites) | `packages/core/src/knowledge/inline_tasks.ts:471, 552` (createRun) |
| `knowledge_sync` | `inline_task_classify` | no | Inline task scheduling classifier (`generateText`) | `packages/core/src/knowledge/inline_tasks.ts:673` |
| `knowledge_sync` | `pre_built` | yes | Pre-built scheduled agents | `packages/core/src/pre_built/runner.ts:43` (createRun) |
-| `code_session` | (none) | yes | Code-section coding session in Rowboat mode (direct mode talks to the on-device coding agent and emits no `llm_usage`) | `packages/core/src/code-mode/sessions/service.ts` (createRun) |
##### `live_note_agent` sub-use-case shape
@@ -91,106 +89,9 @@ All in `apps/renderer/src/lib/analytics.ts`:
- `chat_message_sent` — `{ voice_input, voice_output, search_enabled }`
- `oauth_connected` / `oauth_disconnected` — `{ provider }`
- `voice_input_started` — no properties
-- `call_started` — `{ preset: 'voice' | 'video' | 'share' | 'practice' }` — a hands-free call began (see `apps/x/VIDEO_MODE.md`)
-- `call_turn_latency` — `{ endpoint_to_submit_ms, submit_to_speak_ms, speak_to_audio_ms, total_ms }` — voice-to-voice latency breakdown for one call turn (utterance accepted → submitted → first TTS speak → audio playing)
- `search_executed` — `{ types: string[] }`
- `note_exported` — `{ format }`
-### Client auto-update funnel
-
-The desktop client's own updates — distinct from the in-app apps feature, which owns `app_updated`:
-
-- `update_prompted` — renderer (`apps/renderer/src/lib/analytics.ts`): the "Update available" card was shown for a staged update
-- `update_restarted` — main (`apps/main/src/updater.ts`), `{ from, to? }`: the user clicked restart-to-update (`to` may be missing when the update feed doesn't report the release name)
-- `update_failed` — main (`apps/main/src/updater.ts`), `{ message }`: the auto-updater errored (includes network errors for now)
-- `client_updated` — main (`apps/main/src/ipc.ts`), `{ from, to }`: first launch on a newer version (fires once per update, whatever the restart path; downgrades restamp silently and don't fire)
-### `view_opened` — feature-importance funnel
-
-One event per view the user lands on, fired centrally from the `currentViewState` effect in `apps/renderer/src/App.tsx`. `view` is one of: `chat`, `file`, `graph`, `task`, `suggested-topics`, `meetings`, `live-notes`, `email`, `workspace`, `knowledge-view`, `chat-history`, `home`, `code`, `bg-tasks`, `apps`. Keyed on the view *type*, so switching files or threads inside a view doesn't re-fire.
-
-This is the top of every feature funnel: unique users on `view = 'email'` ÷ all users = how many people even open email. First visit to a key view also sets a one-shot person property (`has_used_email`, `has_used_meetings`, `has_used_live_notes`, `has_used_bg_agents`, `has_used_apps`, `has_used_code`) for cohort building.
-
-### Feature action events
-
-All renderer events live in `apps/renderer/src/lib/analytics.ts` (typed wrappers); the emit sites are in the components named below. Events marked **(main)** are captured in `apps/main/src/ipc.ts` via `capture()` because the operation runs there.
-
-**Email** (`components/email-view.tsx`):
-
-- `email_thread_opened` — a thread was expanded in the list
-- `email_compose_opened` — `{ mode: 'new' | 'reply' | 'replyAll' | 'forward' | 'draft' }` — a composer was opened
-- `email_sent` — `{ mode, has_attachments, ai_assisted }` — `ai_assisted` is true when Write-with-AI produced a draft in that composer
-- `email_ai_draft_generated` — `{ mode: 'generate' | 'rewrite' }` — the Write/Edit-with-AI bar completed
-- `email_archived` / `email_trashed` — one thread archived / moved to trash
-- `email_marked_unread` — explicit mark-as-unread (marking *read* fires automatically on open, so it's deliberately not tracked)
-- `email_importance_changed` — `{ importance: 'important' | 'other' }` — user corrected the importance verdict
-- `email_category_changed` — `{ category }` — user re-filed a thread
-- `email_category_archived` — `{ category }` — bulk "archive all in category"
-- `email_searched` — a search query executed (debounced, one per settled query)
-- `email_instructions_saved` — standing email-agent instructions saved
-- `email_sync_triggered` — manual refresh button
-
-**Meetings** (`App.tsx`, `components/meetings-view.tsx`):
-
-- `meeting_recording_started` — `{ has_calendar_event }` — transcription actually began (all entry points: meetings view, home, sidebar, popup funnel through one call site)
-- `meeting_recording_stopped` — `{ duration_seconds }`
-- `meeting_popup_action` — `{ action: 'take-notes' | 'dismiss' }` **(main)** — the "meeting detected" popup window runs without PostHog, so the action is captured in its IPC handler
-- `meeting_note_opened` — a past meeting note opened from the meetings list
-
-**Calls** (`App.tsx`):
-
-- `call_started` — (pre-existing, above) fires on every call-button press that starts a call
-- `call_ended` — `{ duration_seconds }`
-
-**Background agents** (`components/bg-tasks-view.tsx`, `components/apps/app-detail.tsx`):
-
-- `bg_agent_created` — `{ method: 'manual' | 'coding' | 'copilot', has_triggers }` — `copilot` means the user submitted the "describe it" form (the agent is then created by Copilot in chat)
-- `bg_agent_updated` — instructions/triggers/model saved on an existing agent
-- `bg_agent_toggled` — `{ active }`
-- `bg_agent_run_clicked` — manual Run now
-- `bg_agent_stopped` — manual stop of a run
-- `bg_agent_deleted`
-
-**Live notes** (`components/live-note-sidebar.tsx`, `components/live-notes-view.tsx`):
-
-- `live_note_saved` — live config created or edited via the panel
-- `live_note_toggled` — `{ active }`
-- `live_note_run_clicked` — manual Run
-- `live_note_stopped` — in-flight run stopped
-- `live_note_deleted` — live config removed from the note
-- `live_note_edit_with_copilot_clicked`
-
-**Search** (`components/search-dialog.tsx`):
-
-- `search_opened` — the palette opened
-- `search_executed` — (pre-existing, above)
-- `search_result_selected` — `{ type: 'knowledge' | 'chat' }`
-
-**Apps** — all **(main)**, in `apps/main/src/ipc.ts` (pre-existing except `app_rolled_back`): `app_created`, `app_installed`, `app_uninstalled`, `app_updated`, `app_rolled_back`, `app_published`, `app_starred`, `app_deleted`. Plus renderer-side `app_opened` — `{ folder }` — an installed app's UI was opened (`components/apps/app-frame.tsx`).
-
-**Code mode** — both **(main/core)**:
-
-- `code_session_created` — `{ mode: 'direct' | 'rowboat', agent }` — captured in the `codeSession:create` IPC handler. This is the direct-vs-rowboat session split.
-- `code_session_message_sent` — `{ mode, agent }` — one per direct-drive message (`packages/core/src/code-mode/sessions/service.ts`). Direct turns bypass the agent runtime and emit no `llm_usage`, so this is the only usage-depth signal for direct mode; Rowboat-mode depth comes from `llm_usage where use_case = code_session`.
-
-**Billing** (`components/billing-error-dialog.tsx`):
-
-- `billing_error_shown` — `{ kind: 'subscription_required' | 'out_of_credits' | 'subscription_inactive' }` — the paywall dialog appeared
-- `billing_upgrade_clicked` — `{ kind }` — the upgrade CTA was clicked (shown → clicked = paywall conversion)
-
-**Failures** — success events all have a failure sibling where the operation can fail after the click:
-
-- `email_send_failed` — send returned an error or threw (`components/email-view.tsx`)
-- `meeting_summarize_failed` — post-recording notes generation threw (`App.tsx`)
-- `bg_agent_run_failed` / `bg_agent_run_completed` — `{ trigger: 'manual' | 'cron' | 'window' | 'event' }` **(core)** — every background-agent run settles as exactly one of these (`packages/core/src/background-tasks/runner.ts`), giving a failure *rate* across all trigger sources, not just manual clicks
-
-**Misc**:
-
-- `note_created` — new note from the sidebar/knowledge actions (`App.tsx`)
-- `note_edited` — a note's autosave wrote changed content; deduped to one event per note per app session (so it counts "notes touched", not keystroke bursts)
-- `settings_opened` — `{ tab }` — settings dialog opened (tab = the initial tab)
-- `settings_tab_changed` — `{ tab }`
-- `onboarding_completed` — the onboarding flow finished (`App.tsx`)
-
## Person properties
Persistent across sessions for the same user. Set via `posthog.people.set` or as the `properties` arg to `identify`.
@@ -200,14 +101,10 @@ Persistent across sessions for the same user. Set via `posthog.people.set` or as
| `email` | main on identify | From `/v1/me`; powers PostHog cohort match + integrations |
| `plan`, `status` | main on identify | Subscription state |
| `api_url` | both processes (init + identify) | Distinguishes prod / staging / custom — assign meaning in PostHog dashboard. `https://api.x.rowboatlabs.com` = production |
-| `platform` | both processes (init + identify) | Always `desktop` from this app; segments desktop users from any other surface |
-| `app_version` | both processes (init + identify) | Electron app version; also included automatically on every event |
| `signed_in` | renderer | `true` while rowboat OAuth is connected |
| `{provider}_connected` | renderer | One of `gmail`, `calendar`, `slack`, `rowboat` |
| `total_notes` | renderer (init) | Workspace size signal |
| `has_used_search`, `has_used_voice` | renderer | One-shot first-use flags |
-| `has_used_email`, `has_used_meetings`, `has_used_live_notes`, `has_used_bg_agents`, `has_used_apps`, `has_used_code` | renderer (`view_opened`) | One-shot first-use flags per feature view |
-| `has_created_bg_agent` | renderer | One-shot: user set up a background agent |
## How to add a new event
diff --git a/apps/x/CODE_MODE_ENGINES_PLAN.md b/apps/x/CODE_MODE_ENGINES_PLAN.md
deleted file mode 100644
index ce7a4958..00000000
--- a/apps/x/CODE_MODE_ENGINES_PLAN.md
+++ /dev/null
@@ -1,271 +0,0 @@
-# Code Mode — Managed Engine Provisioning Plan
-
-Branch: `feat/code-mode-managed-engines` (off `dev` @ `8ce24ebb`)
-
-## 1. Problem & Goal
-
-Code mode runs two coding agents — **Claude Code** and **Codex** — by spawning their
-ACP adapters, which in turn spawn a heavy **native engine binary** (~205 MB claude,
-~194 MB codex). We need code mode to work in **packaged releases with ~99% reliability
-for both agents**, without shipping a ~400 MB installer.
-
-### Current state (HEAD = revert of #614)
-- Packaged builds **do not stage** the ACP adapters, and `forge.config.cjs`
- `ignore: /^\/node_modules\//` strips them. At runtime `agents.ts` resolves the
- adapter via `require.resolve(...)` then spawns it — which **throws
- `Cannot find module '@agentclientprotocol/...'`**.
-- **Net: packaged code mode is broken in every release.** It only works in `dev`
- because pnpm symlinks exist. There is no 400 MB bloat today — but no function either.
-
-### Why the two prior approaches are insufficient
-- **Bundle engines (A):** +~400 MB per installer (one claude + one codex native binary
- per OS/arch). Works offline, but installer is huge.
-- **Drive from user's local install (B)** — what #614 settled on and was reverted:
- requires the user to have **both** CLIs installed **and** logged in, correct version,
- on the right PATH. Depends on the user's machine → **structurally cannot hit 99%**
- (version skew, GUI-launch PATH stripping, missing installs). This is why #614 was
- reverted.
-
-## 2. Chosen Architecture — Managed Engine Provisioning (validated against Conductor)
-
-Split the problem into **engine** vs **auth**, treat them differently — exactly what
-Conductor (conductor.build) does:
-
-1. **Engine = owned by the app.** We provision **version-pinned** engine binaries into
- **app-support** (`~/.rowboat/engines/
+ 
-
-