ekkOS_docs
Integration

Windsurf Integration

Add cross-session intelligence to Codeium's Windsurf IDE.

MCP-Powered Memory

ekkOS integrates with Windsurf via the Model Context Protocol (MCP), giving the AI access to 70+ memory tools that persist learnings across sessions.

12 Memory Layers
Patterns, directives, secrets, codebase
29 MCP Tools
Search, forge, recall, track, conflict detection
Cross-IDE Sync
Memory syncs across all your environments

Setup Guide

1Get Your ekkOS API Key

  1. 1.
  2. 2.
    Navigate to Settings → API Keys
  3. 3.
    Click Create New Key and copy it

2Create MCP Configuration

Create the file .windsurf/mcp.json in your project root:

{
  "mcpServers": {
    "ekkos-memory": {
      "command": "npx",
      "args": ["-y", "@ekkos/cli@latest", "mcp"],
      "env": {
        "EKKOS_API_KEY": "your_api_key_here"
      }
    }
  }
}
Pro Tip: Replace your_api_key_here with your actual API key from Step 1.

3Restart Windsurf

MCP servers only load on startup. Restart Windsurf to activate ekkOS memory tools.

macOS: Cmd+Q → Reopen
Windows: Alt+F4 → Reopen

4Verify Integration

Open Windsurf's AI chat and ask:

"Search ekkOS memory for patterns about error handling"

If the integration is working, the AI will call the ekkOS_Search tool and return results from your memory layers.

Available Tools

Core Memory Tools

  • ekkOS_SearchSearch all 12 layers
  • ekkOS_ForgeCreate patterns
  • ekkOS_ContextGet full context
  • ekkOS_RecallRecall past conversations

Directive Tools

  • ekkOS_DirectiveCreate MUST/NEVER rules
  • ekkOS_UpdateDirectiveUpdate existing rule
  • ekkOS_DeleteDirectiveRemove rule
  • ekkOS_UniversalDirectivesGet global rules

Plan Management

  • ekkOS_PlanCreate task plans
  • ekkOS_GenerateAI-generate plans
  • ekkOS_PlanStatusUpdate plan status
  • ekkOS_TemplatesReusable templates

Secrets Management

  • ekkOS_StoreSecretEncrypt & store
  • ekkOS_GetSecretRetrieve & decrypt
  • ekkOS_ListSecretsList all secrets
  • ekkOS_RotateSecretUpdate secret value

70+ tools total. View the complete reference at /tools.

Troubleshooting

ekkOS tools not appearing?

  • • Verify .windsurf/mcp.json exists in your project root
  • • Check that EKKOS_API_KEY is set correctly (no quotes needed in JSON value)
  • • Restart Windsurf completely (MCP servers only load on startup)
  • • Check Windsurf's Output panel → MCP Servers for connection errors

"Invalid API key" error?

  • • Verify your API key at platform.ekkos.dev
  • • Ensure there are no extra spaces or quotes around the key in mcp.json
  • • Check that your ekkOS account has an active subscription (free tier includes 5K calls/month)

Tools appear but AI doesn't use them?

The AI needs to be instructed to use memory tools. Consider adding a CLAUDE.md file to your project root with memory-first instructions.

View CLAUDE.md Setup Guide →

Next Steps

Tool Reference

Complete MCP tools reference

View tools

CLAUDE.md Setup

Configure AI to use memory proactively

Learn more

Cursor Integration

Setup for Cursor IDE

View guide

Need Help?

Platform Dashboard
platform.ekkos.dev
Support Email
support@ekkos.dev