gmem

What is gmem?

gmem is an MCP server that gives AI coding agents (Claude Code, Cursor, Cline, Continue.dev) persistent, typed project memory for blockchain development. It stores entities like Solana programs, EVM contracts, PDAs, accounts, architectural decisions, audit findings, and integrations in an append-only SQLite database, so context is never lost between sessions.

How to use gmem?

Install gmem globally via npm (npm install -g @yksanjo/gmem) or add it to your MCP client configuration by specifying npx -y @yksanjo/gmem as the command. It exposes 7 read/write/query/ingest MCP tools. To auto-ingest an existing project, use the gmem.ingest_anchor (for Anchor workspaces) or gmem.ingest_hardhat (for Hardhat workspaces, v1.1+) tool.

Key features of gmem

• Auto-ingest Anchor and Hardhat workspaces
• SQLite with FTS5 BM25 ranking for semantic recall
• Append-only versioning – history is never overwritten
• One SQLite database per project – no cross-project leakage
• 7 MCP tools for read/write/query/ingest workflows
• MIT-licensed, single binary via npm

Use cases of gmem

• Preserve project context for AI agents working on Solana or EVM smart contracts across sessions
• Track architectural decisions, audit findings, and rationale alongside code
• Automatically ingest workspace metadata (IDLs, ABIs, Anchor versions) into memory
• Maintain a shared, typed project memory for teams using AI coding tools

FAQ from gmem

How do I install gmem?

Use npm install -g @yksanjo/gmem for a global install, or add the npx -y @yksanjo/gmem command to your MCP client configuration.

What entities does gmem support?

gmem defines first-class entity types: Program, Contract, PDA, Account, Decision, Finding, and Integration. Each has typed fields relevant to on-chain development.

How does gmem store memory?

Memory is stored in a local SQLite database with FTS5 full-text search and BM25 ranking. Each project gets its own database, and all writes are append-only to preserve history.

Is gmem open source?

Yes, gmem is MIT-licensed. The source is available on GitHub at https://github.com/yksanjo/gmem.

Can gmem auto-ingest existing Solana and EVM projects?

Yes. gmem provides gmem.ingest_anchor for Anchor workspaces (Solana) and gmem.ingest_hardhat for Hardhat workspaces (EVM, v1.1+).