recira

Wire recira — persistent memory for coding agents — into your MCP clients in one command.

npx @recira/cli login <token>     # token is on the console → Connect page
npx @recira/cli init              # detects Cursor / Claude / Codex / VS Code and configures each
npx @recira/cli status            # endpoint, detected clients, reachability

Commands

| Command | What it does | |---|---| | recira login [token] | Store your token + endpoint in ~/.recira/config.json. | | recira init | Configure detected MCP clients (or --client a,b). Non-destructive — only touches the recira entry. | | recira config <client> | Print the config block for one client (copy/paste form). | | recira status | Show resolved endpoint, which clients are detected, and whether the server is reachable. | | recira uninstall | Remove recira from clients (and --skill artifacts). |

Flags

• -t, --token <token> — auth token (else RECIRA_TOKEN, else the stored token).
• -u, --url <url> / --local — override the endpoint (--local = http://127.0.0.1:8000).
• -s, --scope <global|project> — write machine-wide (default) or into the current repo.
• -c, --client <ids> — target specific clients: cursor,claude-desktop,claude-code,codex,vscode.
• --skill — also drop the portable SKILL.md + Cursor/Copilot rules so agents reach for recira on their own (passive context).
• --hooks — also install an active Cursor sessionStart hook that injects the recall-before/remember-after contract every session. Claude Code gets this via the plugin; Copilot has no hook API, so its always-apply instructions file (--skill) is the lever.
• --print — preview the config without writing files.

Making recall automatic

Three layers, increasingly active — combine as you like:

1. MCP tool descriptions + server instructions (always on) — the tools tell the agent when to call them.
2. --skill — drops always-apply rules (SKILL.md, Cursor .mdc, Copilot .instructions.md) so the agent carries the contract as context.
3. --hooks — runs a sessionStart hook that injects the contract into Cursor at session start. Opt-in, since hooks execute a command.

Supported clients

| id | client | config written | |---|---|---| | cursor | Cursor | ~/.cursor/mcp.json (or .cursor/mcp.json) | | claude-desktop | Claude Desktop | claude_desktop_config.json (bridged via mcp-remote) | | claude-code | Claude Code | ~/.claude.json (or .mcp.json) | | codex | Codex CLI | ~/.codex/config.toml + RECIRA_MCP_TOKEN export | | vscode | VS Code (Copilot) | user/project mcp.json |

Each write is non-destructive: existing servers and settings are preserved, and the prior file is snapshotted to <file>.recira-bak before the first change.