How tools relate to flows
The ten workflow flows and the harness call these tools in the right order, so most days you drive Ryvem through a flow, not a tool. Where a client lacks prompt or slash-command support, the guide tool returns the same flows step by step. The handiest tools to run directly are board (your tasks by column), task (detail plus the live delta), search_tasks, prs/pr_diff (review the team's PRs) and memory_search (recall anything from the graph).
Naming and count
Names below are the exact registered tool names. The three knowledge-base tools also register byte-identical kb_search / kb_page / kb_spaces aliases, kept for one release — they are not counted in the 60.
Board 13 tools
Read and drive the cards on your board — Jira, Trello or the zero-config local board — through one provider-agnostic surface.
| Tool | What it does |
|---|---|
boards | Lists the active provider's boards (those with your open tasks by default; all shows every visible board). Never picks one for you. |
use_board | Selects the session's active board and returns its columns in flow order. |
board | Your open tasks on the active board, grouped by column and annotated with local work memory (branch/PR/merged). |
task | Full detail of a task plus its live delta: description with acceptance criteria, links, subtasks, new images inlined and only the comments new since your last check. |
move | Moves a card by applying the matching transition; to accepts a column name, a status name, or "next". |
comment | Adds a markdown comment to the card, written in the board's language with no AI references. |
assign | Sets a task's assignee — a provider account id, or the literal "me". |
link_tasks | Creates a directional issue link between two tasks (blocks, is blocked by, duplicates, relates to, …). |
search_tasks | Searches tasks across the provider (native query language such as JQL, or free text), with mine, assignee and limit filters. |
members | Lists the users assignable to the active board's project (name, email, accountId). |
create_task | Creates a card in the active project from an issue type and summary; parentKey makes it a subtask. |
subtasks | The subtask picture around a card: children and a done/total figure on a parent, or parent and siblings on a subtask. |
checklist | Reads and toggles the acceptance-criteria checklist (- [ ] / - [x]) in the card description. |
Work 6 tools
The task lifecycle backed by the memory graph: branch memory, refinement, closing and the board plan.
| Tool | What it does |
|---|---|
start | Starts or resumes a task: decides between continuing the existing branch or creating a new one — using branch memory, git and PR state — and persists the decision. |
refine | Replaces the card description with your refined markdown (restructured and lossless), recorded in local memory when a repo is bound. |
finish | Closes a task's work cycle: with prUrl records the PR on the current branch, without it marks the task done, and logs the event. |
history | The repo's work memory — work items with their branches (base, PR, merged) and latest events — after a merge-aware refresh. |
plan | Persists and reads the board execution plan (order, dependencies, overlaps, notes) in the memory graph. |
suggest | Records an improvement suggestion as a searchable memory node — surfaced via memory_search, never applied to your files. |
Project 5 tools
Repo intelligence, skill packs and opening/tracking pull requests.
| Tool | What it does |
|---|---|
project | Detects the repo stack, lists the local conventions found (which take precedence over skill packs) and the applicable packs, and sets the active repo. |
skill | The built-in engineering skill packs: a table of all packs, or one pack's full markdown content. |
pr | Opens a pull request for the current branch (GitHub or Bitbucket, detected from origin); title and body in English, with no AI references. base can target another task's branch for a stacked PR. |
pr_status | Rich status of a PR by number: state, merge target, mergeability, approvals and the aggregated CI/checks state. |
pr_comment | Posts a comment on a PR, in the PR's language, with no AI references. |
Docs / knowledge base 3 tools
Query a Confluence knowledge base. The flows consult it automatically while refining and working a task; you can also query it by hand.
| Tool | What it does |
|---|---|
docs_search | Searches the knowledge base (CQL when the query looks like it, free text otherwise), optionally scoped to one space. |
docs_page | Reads a full page as markdown, with metadata and URL — by id (preferred) or title. |
docs_spaces | Lists the spaces you can see (key, name, type) to discover a space to scope a search. |
Each also registers a deprecated, byte-identical alias: kb_search, kb_page, kb_spaces.
Attachments 1 tool
| Tool | What it does |
|---|---|
attachment | Reads one card attachment by id — PDF, XLSX, CSV, text and code extracted to text, images inline — cached content-addressed so re-reads cost no download. |
Conversation 3 tools
Talk to the team on the card without blocking: ask, track and conclude clarification threads.
| Tool | What it does |
|---|---|
ask | Posts a question to the team as a card comment with real @mentions and records it as an open thread in local memory. |
resolve_thread | Concludes an open ask thread: posts a visible completion comment starting with "✅" and marks the thread resolved. |
threads | Validates pending clarifications: scans tracked threads and checks each card live for a reply, listing what still waits. |
Review 6 tools
Code review of the team's PRs on both sides of the conversation. The same PR scope that opens PRs is enough to list, comment inline, reply, resolve and approve — it can never reject.
| Tool | What it does |
|---|---|
prs | Lists open PRs to review (others' by default; mine/all change the scope), each with a reviewed-since marker. |
pr_diff | The full review context: header, changed files, the unified diff per file, comment threads (with NEW-since-last-pass flags) and your previous review. |
pr_review | Submits a review — inline comments with event "comment" (default) or "approve"; request-changes is impossible by construction. |
pr_reply | Replies to a specific existing review comment, threaded under its commentId (optionally resolving the thread). |
pr_resolve | Resolves (or, with reopen, reopens) a review thread by its threadRef. |
pr_request_review | (Re-)requests reviewers and/or marks a draft PR ready for review. |
Memory 4 tools
Read the temporal memory graph, where nothing is ever deleted, plus the budgeted repo map. See the Memory graph reference.
| Tool | What it does |
|---|---|
memory_search | Full-text search of the graph (tasks, PRs, reviews, conversations, plans, suggestions) with optional kind/scope filters; returns compact hits. |
memory_get | Expands one node by id — any version, including superseded ones — with its full body and structured data. |
memory_history | The full supersedes chain of a node (oldest first), so you can see how a task, review or plan evolved. |
repo_map | A ranked, token-budgeted symbol skeleton of a repo (files with their key definitions), cached per git blob hash. |
Graph 1 tool
| Tool | What it does |
|---|---|
graph_export | Renders the entire temporal memory graph to one self-contained, offline HTML file — a force-directed map with search, filters and supersede-chain history — and returns the file path plus node/edge counts. |
Harness 5 tools
Drive the deterministic agent harness. The universal entry point is harness_next; the full model is in the Agent harness reference.
| Tool | What it does |
|---|---|
harness_next | The self-driving entry point: acquires the loop lease and returns the pending or next brief to execute as a role, or reports the loop done. |
harness_report | Submits the pending brief's report; the engine validates it, runs the step's gates, and advances the loop or embeds feedback in a bounded retry. |
harness_status | Lists the live agent loops and their state (kind, status, step, iteration, pending brief) without advancing anything. |
harness_config | Writes the agents block of ryvem.json — enabled roles, execution mode, loop budget, model tiers, per-role tiers. |
harness_abort | Terminally aborts a loop and releases its lease; it serves no further briefs. |
Onboard 2 tools
Deep-read a repo into memory, incrementally — a full read once, then git-anchored deltas.
| Tool | What it does |
|---|---|
onboard_status | Resolves the repo and its anchor: no anchor returns the full deep-reading protocol; an anchor returns the exact targeted delta work list (re-read / new / verify-removed / renames). |
onboard_record | Persists the codebase map, business rules (with evidence), glossary, objective and any removals into the graph, and writes the new git anchor. |
Guide 1 tool
| Tool | What it does |
|---|---|
guide | Returns the complete step-by-step instructions of a workflow (start-session, work, run-board, review-pr, define-task, …). Call without arguments to list the flows. Works in every MCP client, including those without prompt support. |
Setup 2 tools
The provider-agnostic entry points for bootstrapping a new project.
| Tool | What it does |
|---|---|
workspaces | Lists the workspaces (Trello organizations, Jira projects) the resolved account can create boards or cards inside. |
create_board | Creates a new board in a workspace when the provider supports it (e.g. Trello); providers that cannot (e.g. Jira) return an actionable error. |
Config 8 tools
List, inspect and edit the global profile store in a conversation with the user. Destructive tools require an explicit confirm: true; secrets are always redacted. See Configuration.
| Tool | What it does |
|---|---|
config_list | Lists every configured profile (provider, default flag, which accounts are present). Read-only and secret-safe. |
config_show | Shows one profile's fields; token fields are redacted, never returned in full. |
config_set | Sets a dotted field on a profile (e.g. board.url); overwriting an existing value needs confirm: true. |
config_unset | Removes a dotted field from a profile. Destructive: needs confirm: true. |
config_add_profile | Creates a new profile seeded with its board provider (jira, trello, or local). |
config_remove_profile | Deletes a profile and all its credentials, reassigning the default if needed. Destructive: needs confirm: true. |
config_set_default | Points the default profile at an existing profile. No data is lost. |
config_clear | Wipes every profile from the global config. The most destructive config tool: needs confirm: true. |