Make Gemini 3.8 Flash remember, plan, verify — and eliminate hallucinations.
Persistent cross-tool memory via Engram · 4 proactive coding skills · strict anti-hallucination rules.
One plugin for Gemini CLI, Antigravity, Cursor, VS Code, Windsurf, and Claude Code.
Fast AI models are incredible coding partners until they:
- Forget architecture decisions and re-ask the same questions every new session.
- Invent imaginary packages, deprecated functions, and fake CLI flags.
- Say "fixed!" without ever executing tests or verifying their changes.
Flashmind solves this with three integrated layers:
- 🧠 Shared Memory (Engram MCP): Automatically recalls previous project bugs and decisions at the start of a task, and saves new lessons before closing. Reviews overdue memories (
mem_review) against the current code before trusting them. All editors share one local database. - 🛡️ Anti-Hallucination Rules (
GEMINI.md): Enforces citing code evidence, separating facts from assumptions, and admitting unknowns. - 🎯 Proactive Agent Skills: Step-by-step playbooks loaded on-demand for planning, debugging, and verification.
Add to your tool's MCP configuration (mcp.json / mcp_config.json):
{
"mcpServers": {
"flashmind": {
"command": "npx",
"args": ["-y", "flashmind"]
}
}
}Install in one command:
gemini extensions install https://github.com/Hvftpie13/Flashmind_Gemini-3.8-Flash_Smart-agent
gemini -m gemini-3.8-flashIncludes the Engram binary, all Agent Skills, and automated client configuration:
macOS / Linux:
git clone https://github.com/Hvftpie13/Flashmind_Gemini-3.8-Flash_Smart-agent flashmind
cd flashmind
./install.sh antigravity-cliWindows (PowerShell):
git clone https://github.com/Hvftpie13/Flashmind_Gemini-3.8-Flash_Smart-agent flashmind
cd flashmind
.\install.ps1 antigravity-cliPre-configured files are available in configs/:
| Client / Editor | MCP Configuration File | Rules Location |
|---|---|---|
| Antigravity | configs/antigravity/mcp_config.json → ~/.gemini/config/mcp_config.json |
AGENTS.md → Rules / ~/.gemini/GEMINI.md |
| Cursor | configs/cursor/mcp.json → ~/.cursor/mcp.json |
configs/cursor/flashmind.mdc → ~/.cursor/rules/ |
| VS Code (Copilot) | configs/vscode/mcp.json → .vscode/mcp.json |
configs/vscode/flashmind.instructions.md |
| Windsurf | configs/windsurf/mcp_config.json → ~/.codeium/windsurf/mcp_config.json |
configs/windsurf/global_rules.md |
| Claude Code | Run bash configs/claude-code.sh |
AGENTS.md → CLAUDE.md |
| Any MCP Client | configs/mcp.json |
AGENTS.md |
Loaded automatically when relevant to your current prompt:
| Skill | Trigger | Purpose |
|---|---|---|
plan-first |
Tasks with 3+ steps or multi-file edits | Read code → Draft plan → Execute one verified step at a time. |
no-invented-code |
Writing new functions or imports | Always verify symbols and installed versions against local source. |
systematic-debugging |
Errors, test failures, or crashes | Check past memories → Reproduce → Root-cause → Minimal fix → Prove it. |
verify-before-done |
Before declaring "fixed" or "done" | Run linter/tests and report exact terminal results. |
| Command | Action |
|---|---|
/memory:recall <query> |
Search and summarize what memory knows about a topic |
/memory:save <fact> |
Save a verified decision or discovery |
/memory:forget <item> |
Delete outdated memories |
/memory:summary |
Generate and record a session summary |
/verify |
Audit the last answer claim-by-claim with source evidence |
Updating never touches your memories: they live in ~/.engram/ and ~/.flashmind/. See CHANGELOG.md for what changed.
| How you installed | How to update |
|---|---|
| Gemini CLI extension | gemini extensions update flashmind (or gemini extensions update --all). It updates in place, so do not run install again. If it cannot find the source (e.g. you installed under the old repo name), run gemini extensions uninstall flashmind, then install again from the current URL. |
| NPX | Restart your editor. If it keeps running an old version, clear npx's cached copy with npm cache clean --force and restart. |
| Automated installer / git clone | cd flashmind && git pull, then run ./install.sh (macOS/Linux) or .\install.ps1 (Windows) again. Skills are overwritten by name, not duplicated. |
| Manual config files | Re-copy from configs/ and replace, never append (see below). |
| Engram | brew upgrade engram, or re-run go install github.com/Gentleman-Programming/engram/v3/cmd/engram@latest. |
Avoiding duplicates
- One entry per server. Keep a single
"flashmind"and a single"engram"key in your MCP config. Edit the existing entry; do not paste a second copy. - Replace rules, don't append. For Cursor, Windsurf and VS Code, overwrite the file with the same name. For a shared file such as
~/.gemini/GEMINI.mdorCLAUDE.md, wrap the rules in markers the first time you paste them, and replace everything between the markers on each update:<!-- flashmind:start --> ...contents of AGENTS.md... <!-- flashmind:end --> - One copy of the skills. If you copied
skills/into more than one folder (for example~/.gemini/skillsand~/.agents/skills), keep one and delete the other. - Start a new session after updating so the agent loads the new rules and skills.
- 100% Local: All memories are stored on your machine (
~/.engram/or~/.flashmind/). Zero telemetry or external API calls. - Secret Redaction: Automatically rejects passwords, bearer tokens, API keys, and sensitive credentials.
- Zero Dependencies: Lightweight and fast with 0 third-party runtime npm packages.
MIT © Flashmind Contributors.