Coding agents already execute shell commands, so they can use MemoryGraph directly. Two steps: install globally, then add instructions.
Install
cd memory-graph/ts && bun install && bun link
# or: bun build src/cli.ts --compile --outfile ~/.local/bin/memorygraph
memorygraph stats # verify
A graph DB-based MCP memory server for coding agents with intelligent relationship tracking
ดาว
255
เครื่องมือ
—
อัปไทม์
—
memorygraph is now available from any directory. Data persists in ~/.memorygraph/.
Add Agent Instructions
Paste this into your agent's instruction file (~/.claude/CLAUDE.md, .cursorrules, .windsurfrules, or AGENTS.md):
## Memory
`memorygraph` CLI is installed. Use it for persistent memory across sessions.
Before work: `memorygraph recall --query "<task>" --limit 10` and `memorygraph briefing`
On decisions/fixes: `memorygraph store --type solution --title "<title>" --content "<what>" --tags "<component>,fix"`
On errors: `memorygraph store --type error --title "<error>" --content "<details>" --tags "<component>,error"`
Link: `memorygraph link <from-id> <to-id> SOLVES --strength 0.8`
Session end: `memorygraph store --type conversation --title "Session: <topic>" --content "<summary>" --tags "<tags>"`
Types: solution | problem | code_pattern | fix | error | workflow | command | technology
Tags: lowercase, hyphenated, include component (auth, database, cli), 2-5 per memory
Do NOT wait to be asked. Store automatically on triggers.
Example Session
# Start: load context
memorygraph recall --query "authentication redis" --limit 10
memorygraph briefing
# Fix a bug: store problem + solution, link them
memorygraph store --type problem --title "Auth token expiry too short" --content "Tokens expiring after 1h" --tags "auth,bug"
# → abc-123
memorygraph store --type solution --title "Extend token expiry to 24h" --content "Changed JWT expiry, added refresh rotation" --tags "auth,fix" --importance 0.8
# → def-456
memorygraph link def-456 abc-123 SOLVES --strength 0.9
# End: store summary
memorygraph store --type conversation --title "Session: auth token fix" --content "Fixed token expiry, added refresh rotation" --tags "auth,session-summary"
Multi-Project Setup
All projects share ~/.memorygraph/falkordblite.db by default. To isolate per project:
export MEMORY_FALKORDBLITE_PATH=~/.memorygraph/my-project.falkor
# or tag memories with project name and filter:
memorygraph search --query "auth" --tags my-project
Troubleshooting
Agent not using commands: Use "REQUIRED"/"MUST" in instructions, include exact commands
Command not found: bun link from ts/, or ensure ~/.local/bin is on PATH
Memories not persisting: memorygraph config to check path, memorygraph health to verify
Generate a session briefing with recent activity and open issues
predict
Predict what might be needed based on current context
warn
Warn about potential issues (deprecated approaches, known errors)
outcome
Record an outcome for a memory (success/failure tracking)
Integration
Command
Purpose
capture
Capture task context from current environment
analyze-project
Analyze the current project codebase
workflow
Track or suggest workflow improvements
Temporal
Command
Purpose
as-of
Query relationships as they existed at a specific time
history
Get full relationship history for a memory
changes
Show relationship changes since a timestamp
Data Management
Command
Purpose
export
Export to JSON or Markdown
import
Import from JSON
migrate
Migrate between backends
health
Run a health check
config
Show current configuration
Backends
Backend
Type
Config
Native Graph
Zero-Config
Best For
falkordblite (default)
Embedded
File path
Cypher
Yes
Default, graph queries without server
sqlite
Embedded
File path
Simulated
Yes
Zero-dependency fallback
falkordb
Client-server
Host:port
Cypher
No
High-performance production
memgraph
Client-server
Bolt URI
Cypher
No
Real-time analytics
cloud
Cloud
API Key
Cypher
No
Multi-device sync, team sharing
Backend Configuration
# Use FalkorDBLite (default, zero-config)
bun run src/cli.ts stats
# Use SQLite
MEMORY_BACKEND=sqlite bun run src/cli.ts stats
# Use FalkorDB (client-server)
MEMORY_BACKEND=falkordb MEMORY_FALKORDB_HOST=localhost MEMORY_FALKORDB_PORT=6379 bun run src/cli.ts stats
# Use Memgraph
MEMORY_BACKEND=memgraph MEMORY_MEMGRAPH_URI=bolt://localhost:7687 bun run src/cli.ts stats
# Use Cloud
MEMORY_BACKEND=cloud MEMORYGRAPH_API_KEY=mg_your_key bun run src/cli.ts stats
Environment Variables
Variable
Description
Default
MEMORY_BACKEND
Backend type
falkordblite
MEMORY_FALKORDBLITE_PATH
FalkorDBLite database path
~/.memorygraph/falkordblite.db
MEMORY_SQLITE_PATH
SQLite database path
~/.memorygraph/memory.db
MEMORY_FALKORDB_HOST
FalkorDB server host
localhost
MEMORY_FALKORDB_PORT
FalkorDB server port
6379
MEMORY_MEMGRAPH_URI
Memgraph Bolt URI
bolt://localhost:7687
MEMORYGRAPH_API_KEY
Cloud API key
-
MEMORYGRAPH_API_URL
Cloud API URL
https://graph-api.memorygraph.dev
MEMORY_TOOL_PROFILE
Tool profile (core or extended)
core
MEMORY_LOG_LEVEL
Log level
INFO
Memory Types
Type
Use Case
task
Tasks and action items
code_pattern
Recurring code patterns or conventions
problem
Problems or challenges encountered
solution
Solutions, decisions, or approaches chosen
project
Project context, environment, setup info
technology
Technology choices and evaluations
error
Errors discovered
fix
Fixes applied to errors
command
Useful commands or CLI snippets
file_context
Context about specific files
workflow
Workflow or process descriptions
general
General purpose memories
conversation
Conversation summaries
Relationship Types
Type
Meaning
RELATED_TO
General connection
BUILDS_ON
New memory extends an older one
CONTRADICTS
New memory supersedes or invalidates an older one
CONFIRMS
New memory provides evidence for an older one
SOLVES
A solution solves a problem
CAUSES
One memory causes another
REQUIRES
One memory depends on another
IMPROVES
An improvement over an existing approach
REPLACES
Replaces an older approach
DEPENDS_ON
Workflow dependency
Memory Best Practices
Session Workflow
# Start of session: recall recent context
bun run src/cli.ts recall --query "recent work" --limit 10
# During work: store decisions and patterns
bun run src/cli.ts store \
--type solution \
--title "Use JWT for auth" \
--content "JWT tokens with 24h expiry, refresh token rotation" \
--tags "auth,security,api" \
--importance 0.8
# Link it to a prior decision
bun run src/cli.ts link <new-id> <prior-id> BUILDS_ON --strength 0.9
# End of session: store summary
bun run src/cli.ts store \
--type conversation \
--title "Session: auth refactor" \
--content "Refactored auth middleware, added JWT, fixed token refresh bug" \
--tags "auth,session-summary"
# Export backup
bun run src/cli.ts export --format json --output session-backup.json
Add to CLAUDE.md or AGENTS.md
## Memory Protocol
### REQUIRED: Before Starting Work
You MUST use `recall` before any task. Query by project, tech, or task type.
### REQUIRED: Automatic Storage Triggers
Store memories on ANY of:
- Git commit: what was fixed/added
- Bug fix: problem + solution
- Architecture decision: choice + rationale
- Pattern discovered: reusable approach
### Memory Fields
- Type: solution | problem | code_pattern | fix | error | workflow
- Title: Specific, searchable
- Content: Accomplishment, decisions, patterns
- Tags: project, tech, category (required)
- Importance: 0.8+ critical, 0.5-0.7 standard, 0.3-0.4 minor
- Relationships: Link related memories when they exist
cd ts
bun install
bun test # Run tests
npx tsc --noEmit # Type check
bun build src/cli.ts --compile --outfile memorygraph # Compile binary
Import / Migration
# Import from JSON export
bun run src/cli.ts import --input backup.json --skip-duplicates
# Migrate between backends
bun run src/cli.ts migrate --to sqlite --to-path ./local.db
bun run src/cli.ts migrate --to falkordblite --to-path ./graph.falkor --no-verify
bun run src/cli.ts migrate --to memgraph --to-uri bolt://localhost:7687
SDK
The TypeScript SDK provides a client for the MemoryGraph Cloud API: