vellum-ai

Cut a new release: create the release branch (staging bake), then dispatch the production Release run on that branch.

Add a vendor's remote MCP server to the bundled integrations catalog (plugins/mcp-catalog/<name>/ + plugins/marketplace.json) so users can connect it from the Integrations page. Covers vetting the server's OAuth support, the icon, the package files, the…

Create and edit Excel spreadsheets (.xlsx) whose formulas carry their computed values, so sums and totals show in every viewer, plus date and time formats, recalculating and verifying an existing workbook.

Control a connected desktop

Point at things on the screen the user is showing you

Act on behalf of your user in any third-party software that supports OAuth 2.0

Set up channel verification for phone, Telegram, Slack, Discord, or email channels via outbound verification flow

Browse the web using `assistant browser` CLI commands

First-run onboarding for the Polyglot language learning plugin. Use when the user first interacts with Polyglot, when they want to set up a new language, or when they say things like "I want to learn Spanish" or "set up language learning." Gathers language…

Instructions for weaving target language into normal conversations when the user is in ambient mode. Use when the Polyglot plugin is in ambient mode and the user is having a normal (non-practice) conversation. This is the differentiated experience — language…

Instructions for immersive mode where the assistant responds primarily in the target language. Use when the user is in immersive mode — advanced learners or intensive practice periods. The assistant uses English only for clarification or when the user is…

Run a dedicated language practice session. Use when the user asks to practice, says "let's practice [language]", wants to do a lesson, or when a practice session should start. Generates life-contextual scenarios, adapts difficulty, and teaches through…

Track writing sessions, maintain a daily word count streak, and deliver guilt messages when the user skips. Logs word counts and durations, shows stats, and celebrates milestones. Use when the user wants to start a writing session, set a word count goal,…

Generate a daily writing prompt calibrated to the user's genre and streak, with difficulty that escalates as they build a habit. Saves drafts to a gallery that grows over time. Use when the user asks for a writing prompt, daily prompt, wants to write…

Deliver constructive-but-savage feedback on a piece of prose. Runs programmatic text analysis first (adverb density, passive voice, weak verbs, clichés, sentence rhythm, word repetition, reading level), then roasts the draft using the real numbers as…

Critique a query letter against publishing industry standards. Checks word count, hook, comp titles, bio, agent personalization, and paragraph structure, then delivers professional feedback on hook strength, story clarity, comps relevance, and bio…

Reconstruct the history behind a decision, project, claim, or recurring idea using Threadkeeper's staged evidence retrieval. Use when the user asks what happened, why a decision was made, when an idea started, what changed, or where a claim came from.

Review Threadkeeper open loops, memory-gardener proposals, contradictions, and serendipity connection hypotheses. Use when the user asks what needs review, wants to accept, reject, snooze, complete, archive, explore, or dismiss a Threadkeeper item.

Configure Threadkeeper, including an explicit, changeable conversation backfill scope, serendipity setting, and sensitive-category privacy default. Use when the user asks to set up, enable, configure, or backfill Threadkeeper.

Coach the user on building sustainable health habits around sleep, daily movement, consistency, and behavior change. Use when the user mentions struggling with consistency, motivation, sleep, getting enough steps, or wants to build healthier routines. Also…

Guide the user on nutrition, meal planning, and dietary choices. Use when the user asks about what to eat, protein intake, calorie targets, meal timing, hydration, macronutrients, or building a meal plan. Also activates when the user mentions struggling with…

Help the user plan workouts, choose exercises, and structure training routines. Use when the user asks about workout splits, exercise selection, progressive overload, rest days, or wants a training plan. Also activates when the user mentions wanting to start…

Verify native iOS behavior of the vellum-assistant Capacitor app on a real iOS simulator: build from a worktree, boot against the qa-mock-backend server, drive with XCUITest, and record video proof. Use for anything WKWebView/Swift-side — edit menus, native…

Visually test vellum-assistant clients/web changes on a feature branch: boot the app locally with mocked platform APIs, drive it in headless Chromium with mobile/coarse-pointer emulation, dispatch real CDP touch gestures, and produce screenshots plus an…

Stand up a fake vellum platform + daemon backend so any vellum-assistant client (web via Playwright, iOS via simulator, Electron) boots to the real chat UI with scripted conversation state — no real accounts, daemon, or network. Shared core of the qa-web-ui…

Set up the iMessage channel with the user's own Photon, Linq, or Comms account so the assistant can send and receive texts. After the provider is stored, save and verify the user's iMessage handle on their guardian contact if it is missing. Use when the user…

Send an iMessage or SMS to a phone number. Use when the user asks the assistant to text someone, or asks it to text them.

Answer board-game rules questions from the installed boardgame-rules plugin, or validate a specific play situation against a pre-authored worked example. Use when the user asks how a supported game works, what a rule is, whether a move is legal, or whether…

Teach a supported board game at the table, during one sitting: ask what the players already know, teach in layers (goal, turn loop, exceptions), cite every ruling, and bridge to their known games — but only when the corpus has a real analogy. Use when someone…

Set up the SMS channel with the user's own Twilio account and number so the assistant can send and receive texts. After the credentials are stored, save and verify the user's SMS handle on their guardian contact if it is missing. Use when the user wants to…

Send an SMS to a phone number. Use when the user asks the assistant to text someone, or asks it to text them.

Send a note-taking bot into a meeting via Recall.ai; only when the user explicitly asks.

Guide the user through setting up the Recall.ai API key for the Meeting Bot plugin.

Help the user discover coffee beans they'll love — recommend origins, explain roasts and processing, and find current, buyable bags matched to their taste. Use when the user asks what coffee to buy, wants bean recommendations, mentions a roaster or single…

Guide the user to the right coffee equipment — espresso machines, grinders, and brewers — matched to their budget, experience, and kitchen. Use when the user asks what machine or grinder to buy, wants to upgrade their setup, asks about espresso vs. pour-over…

Deep multi-perspective code review of a GitHub pull request. Spawns parallel subagents to review from different angles (convention compliance, bug detection, git history context), scores each finding for confidence, and posts high-confidence issues as a PR…

Git and GitHub workflow automation: branch management, commits, PRs, code review, diffs, logs, and changelog generation. Use when the user asks to commit, branch, open/review/merge a PR, see git status, diff, log, or generate release notes from commit history.