Claude Code Integration
Add persistent memory to Anthropic's Claude Code CLI.
About Claude Code
Claude Code is Anthropic's official CLI tool for using Claude in your terminal. It supports MCP (Model Context Protocol), which allows ekkOS to provide persistent memory across all your coding sessions.
Configuration
Step 1: Find your settings file
Claude Code stores its configuration at:
Step 2: Add ekkOS MCP server
Add or merge the following into your settings.json:
{
"mcpServers": {
"ekkos-memory": {
"command": "npx",
"args": ["-y", "@ekkos/mcp-server"],
"env": {
"EKKOS_API_KEY": "your_api_key_here"
}
}
}
}Step 3: Restart Claude Code
Close your terminal and reopen it. Claude Code will automatically load the MCP server.
Getting Your API Key
- 1Go to platform.ekkos.dev
- 2Sign up or log in with GitHub
- 3Go to Settings → API Keys
- 4Click "Generate New Key"
Verify Installation
After restarting, ask Claude to use memory:
"Search my memory for recent patterns""What do you remember about this project?"If Claude uses tools like ekkOS_Search, ekkOS_Forge, or ekkOS_Conflict, the integration is working.
Available Memory Tools
ekkOS_SearchSearch across all memory layers for patterns and solutions
ekkOS_ForgeSave learned solutions as reusable patterns
ekkOS_DirectiveCreate MUST/NEVER/PREFER/AVOID rules
ekkOS_ConflictValidate actions against your directives and patterns
Troubleshooting
MCP server not loading?
- • Verify your settings.json is valid JSON
- • Check Node.js 18+ is installed:
node --version - • Try running manually:
EKKOS_API_KEY=xxx npx @ekkos/mcp-server