CLI & MCP

Hand your agent
the whole rulebook

Flow ships a command line tool, an MCP server and a skill file. Your agent gets taught how to use it, and you decide what it's allowed to do.

zsh — nyxe
$ nyxe session.search --query "migration" --limit 5
{ "ok": true, "value": { "matches": 11 } }

$ nyxe insight.generate --kind summary --id 4f2a
{ "ok": true, "value": { "kind": "summary" } }

$ nyxe insight.emit --id 4f2a --to reminder
⚠ requires grant: emitExternal
exit 4 · consent denied
THE COMMAND

It puts itself on your PATH

Nyxe installs a nyxe command onto your PATH on launch, and it describes its own commands, so an agent can list them itself instead of hunting for a doc.

ONE BINARY

Query your own week from the terminal.

Every session, meeting and note is one command away. Search across them, generate a summary, or list what you shipped. Reading is free and needs nothing but the binary.

nyxe schema
QUERY — READS
nyxe session.list --since «date»reads
nyxe session.search --query «text»reads
nyxe session.get --id «uuid»reads
GENERATE — ON-DEVICE
nyxe insight.generate --kind summarylocal
ACT — NEEDS A GRANT
nyxe insight.emit --to reminderemitExternal

Self-documenting

nyxe schema emits the whole command tree, so the guide an agent reads is generated from the tool rather than written by hand.

Sessions
Fix auth token refresh2h 14m
Migrate outbox replay48m
Harden domain verify1h 02m
Migration sync42m
Design review31m

Structured output

Every result is a JSON envelope, so an agent can act on the answer instead of scraping a pretty table.

Nothing to wire up

No API keys and no server to babysit. It reads Flow's own local database directly, so Flow doesn't even need to be open.

MCP SERVER

Set up in the agent
apps you already run.

Flow registers its MCP server with the agent apps it finds and drops a skill file beside each. A connected agent gets a read-only subset: it can search your sessions and generate summaries on-device, and change nothing until you grant it.

Claude DesktopClaude CodeCursorWindsurfVS CodeClineCodexAntigravityOpenCode
THE RULEBOOK

It hands over a guide

Registering isn't enough on its own. Flow also drops a skill file next to each agent, so it knows what the tool is for and where the line is before it touches anything.

SKILL FILE

Each agent arrives knowing the rules.

The guide says the same thing every time. Reading is free, acting needs consent, and a denied grant is surfaced rather than retried. An agent that follows it stays inside the lines by default.

~/.claude/skills/nyxe-flow/SKILL.md
# nyxe-flow — how to use it

Reading is free. Query sessions and notes with
nyxe session.search and session.get.

Summaries run on-device. Sending and deleting
need a grant, and return exit 4 without one.

# Don't retry a denied grant. Surface it.
FAQ

Questions developers ask

It reads Claude Code and Codex sessions on its own. It also registers its MCP server and installs a skill file across the agent apps you use, including Claude Desktop, Cursor, Windsurf, VS Code, Cline, Codex, Antigravity and OpenCode, so each one arrives knowing how to use it.

Install it,
then point your agent at it.

The CLI, MCP server and skill file ship with Flow.

macOS · included with every paid Nyxe plan