CALL THIS FIRST in every conversation about a project. Returns a brief (max 4,000 characters) with the project's hard rules (never break them), any handoff note from the last AI, open todos, open problems, recent changes, recent decisions and key learnings, and opens a FlowState session automatically. Pass project="" (or id). size=quick (short) or deep (longer, up to 12,000) if needed. Unknown project? Call with no arguments, or with folder="", to get the list of projects.

Record work as you go (write; project required). kind: decision (a choice made and why), change (something changed), problem (bug or blocker), learning (lesson or gotcha), todo (follow-up). summary: one short line. details: optional. component: optional component name (changes and problems default to 'General'). suggested=true: you are not sure the user wants this recorded, so it goes to the review queue instead of being saved. priority (todos; severity for problems): critical, urgent, normal (default), low. source: user_stated (the user said it), ai_inferred (your conclusion) or from_code (read in code or commits). Never include secrets (writes containing keys, tokens or passwords are refused).

List items waiting in the review queue (auto-captured session summaries and records logged with suggested=true). Read-only. Show them to the user; approving or rejecting is the user's decision.

Approve a review item so it becomes a normal FlowState record. To edit then approve, pass the corrected summary/details (or priority/category/component). ONLY call this when the user has explicitly told you, in this chat, to approve or reject this specific item. Never decide on your own initiative, and never approve your own suggestions unless the user explicitly says so. user_request must quote the user's words. Write: requires project="".

Reject a review item. It is kept, marked rejected, with the user's reason (nothing is deleted). ONLY call this when the user has explicitly told you, in this chat, to approve or reject this specific item. Never decide on your own initiative, and never approve your own suggestions unless the user explicitly says so. user_request must quote the user's words. Write: requires project="".

Link things across projects (write for add/remove; project required). Use when projects share something, e.g. several apps use one protocol: link(action="add", project="App A", link_type="uses", target_project="Owner", target_component="Wire Protocol"). Source is the project, or component="", or item_type+item_id (decision, change, learning, problem, todo). Target: target_project (+ target_component), target_type+target_id, or url (a GitHub/Linear link to keep on a record). link_type: uses, depends_on, part_of, same_as (also supersedes, subtask_of, blocks). Changes logged on a shared component alert every project linked to it (an update todo + a note in its brief). FlowState only alerts; it does not change other apps' code. remove: link_id (or the add fields). list: links of the project or of one item.

Read or change the review mode: which new records wait in the review queue for the user's OK. Modes: off (nothing waits), auto_only (default: only auto-captured items), types (also the listed kinds), everything. action=get is read-only. action=set ONLY when the user has explicitly asked you, in this chat, to change the review mode; never change it on your own initiative or to get your writes saved. user_request must quote the user's words; every change is logged with them. project=... sets an override for one project (clear=true removes it); no project = the whole install.

Edit history of FlowState records, and undo. action=list (read): recent edits and deletes in a project, or of one record (record_type + record_id), with old and new values. action=undo (write; project required): put back the last change to that record (a deleted record comes back); recorded too, so undoing again redoes it. Refused if the record changed again since. New records are not undone here (set them done/cancelled). action=who (read): who did what, newest first, across projects or one project: app, model, machine and how the app was identified, for edits, review decisions, links, handoffs, rules and new records; filters by_app, by_model, by_machine, since, until (local time, e.g. 2026-10-17 or 2026-10-17 14:30), page.

Find likely duplicates, stale todos and records filed in the wrong project, and put them in the review queue as suggestions (write; project required; additive: nothing is moved, closed or deleted). The user approves or rejects each one; approving applies only that suggestion and it can be undone with history. Suggestions the user rejected are not repeated. kinds: any of duplicate, stale, misfiled (default all).

Bring memories or notes into a project's REVIEW QUEUE (write; project required; nothing is saved as a record until the user approves). format=memory (default): a Claude or ChatGPT memory export or copy, as text/markdown (one per line) or JSON. format=flowstate_markdown: a file made by flowstate export-md; new lines and edited lines become review items. Pass the file's contents as text. Lines that look like secrets are skipped, not stored.

A project's HARD RULES: things never to do in it (e.g. "Never push to main"). They are shown first in every start_here brief, in full. action=list (read). action=add (write; project required): rule = one short sentence (max 300 characters; 2,000 per project); add one when the user states a rule. action=remove (write): rule_id, ONLY when the user asks you in this chat; user_request must quote their words.

Handoff notes between AIs. Stopping mid-task (out of time, context or tokens, or the user ends the chat)? action=leave (write; project required) with where_i_was (what was being done and its state) and next_step. The next AI sees it first in start_here. When you continue from a note, action=pickup with handoff_id so it stops showing. action=list (read).

Keep facts current. action=stale (read): facts (paths, ports, hosts, URLs, config) in a project not checked for 60+ days; check them. action=mark (write): you confirmed a record still holds (record_type + record_id; optional source). action=source (write): set where a record came from: user_stated, ai_inferred or from_code. If a fact changed, log the change instead.

Ask FlowState a question in plain words (read-only), e.g. "which port does the LAN server use?". Returns a short answer quoted from the best-matching records, with their ids (type #id), plus matching hard rules and handoff notes. Local only (meaning search if a local model is installed, keywords otherwise). If nothing matches it says so; it never guesses. project optional (default: all projects).

List all projects with their status.

Create a new project.

Update project details. Write: requires project="" (or project_id).

Get project context. Use lean=True (default) for minimal tokens at session start. Use lean=False for full details when needed.

Create a component within a project. Write: requires project="" (or project_id).

List components in a project.

Update a component. Write: requires project="" (or project_id).

Capture an insight or learning. This is your memory - use it! Write: requires project="" (or project_id).

Get learnings. Use compact=True to save tokens.

Log a change to a component. Write: requires project="" (or project_id).

Get recent changes. Use compact=True to save tokens.

Search todos, decisions, changes, learnings, problems and solutions. Matches words (and word endings); also by meaning when a local model is installed (the reply's mode says which was used).

Manage problems. Actions: log, list, solve, get_tree Write: requires project="" (or project_id).

Manage solution attempts. Actions: log, outcome Write: requires project="" (or project_id).

Manage todos. Actions: add, update, list, next (what to do next: open, unblocked, highest priority), block / unblock (todo_id waits on blocked_by todos or blocked_by_problem). add takes parent_todo_id for a subtask. Priority: critical, urgent, normal (default), low (older names high and medium also work). list filters by priority or min_priority and sorts by priority (default), due or newest. Write: requires project="" (or project_id).

Manage sessions. Actions: start, end, current, log_conversation, list_conversations, list_sessions Write: requires project="" (or project_id).

Manage file attachments. Actions: attach, list, remove, search Write: requires project="" (or project_id).

Git operations. Actions: init, status, sync, set_remote, clone, history

Manage project variables (servers, credentials, config). Actions: create, list, update, delete Write: requires project="" (or project_id).

Manage project methods (auth flows, deployment steps, patterns). Actions: create, list, update, delete Write: requires project="" (or project_id).

Manage Claude's learned skills and session state. Actions: learn_skill, get_skills, confirm_skill, save_state, get_state, log_metric, get_metrics Write: requires project="" (or project_id).