Your agents forget everything between chats, and each one learns the project from scratch. fxmind gives them one memory that lives in your repo, plus expert skills for your stack and a quality checklist they must pass before saying "done".
- Shared memory — facts learned by any agent are saved in
.fxmind/memory/, committed with your code and reused by every agent and teammate.
- Knowledge packs — best practices for your stack: Web (React, Next.js, Vue, Node, APIs, databases, security, accessibility) and FiveM (vRP, QBCore, Qbox, ESX, NUI). The right pack is picked automatically.
- Verified work — every change goes through short gates and an independent reviewer before it is accepted.
- Decisions with Jev AI (optional) — Jev helps choose the task type, relevant memories, tools and what is worth saving. Off by default; it never sees your code or file paths. See docs/jev-optional.md.
- Built for parallel agents — agents claim the files they edit, so two agents don't overwrite each other.
Install
Requires Node.js 20.9+. Pick one way:
Ask your agent (any agent) — paste this in the chat, inside your project:
Install fxmind in this project. Check that Node.js 20.9+ is installed, then run in the project root:
npx --yes github:proelias7/fxmind --claude -y
(replace --claude with the flag for the agent you are: --codex, --cursor, --gemini, --opencode or --copilot).
It installs the fxmind runtime globally so its MCP and hooks keep working. Show me the summary and tell me to restart you; then I will run /fxmind init.
Plugin — Claude Code: /plugin install fxmind --marketplace proelias7/fxmind · Codex: codex plugin marketplace add proelias7/fxmind then codex plugin add fxmind@fxmind. Then ask: "set up fxmind in this project".
Terminal — run in your project folder:
npx --yes github:proelias7/fxmind init
Choose packs, agents and skills in the terminal. Setup asks whether to enable Jev; its key is entered through a hidden prompt. Restart your agent, then run /fxmind init in chat to read the main modules and learn project facts.
To configure Jev separately later:
npx --yes github:proelias7/fxmind jev
With the CLI installed globally, use fxmind init and fxmind jev. The key stays in ~/.fxmind/jev.env; never send it through chat.
Update
npx --yes github:proelias7/fxmind --update -y
Your memories are kept; only fxmind's own files are refreshed.
Use
Talk to your agent normally. A few commands help:
| In the agent chat | What it does |
|---|
/fxmind init | Read the main modules, learn verified facts and map the project |
/fxmind learn <topic> | Save what the agent verified about a part of the project |
/fxmind create <feature> | Design a new feature, approve it, then build it |
/fxmind audit <folder> | Security and performance report |
Codex uses $fxmind, Gemini uses /fxmind:learn.
Options
npx --yes github:proelias7/fxmind --claude -y # pick the agent: --cursor --claude --codex --gemini --opencode --copilot
npx --yes github:proelias7/fxmind --pack web -y # pick the pack: web, fivem (default: detected)
Everything else — MCP tools, hooks, web panel, global install, custom packs — is in the full reference.
License
MIT — proelias7
