ekkOS_Connect Extension
Universal AI Memory Gateway — one-click setup for persistent memory across Cursor, Claude Code, VS Code, Windsurf, and Codex.
Overview
ekkOS_Connect is the official VS Code extension that turns any AI coding assistant into one with persistent memory. It auto-configures MCP for every supported IDE, provides real-time session diagnostics, and a one-click setup wizard.
Key Features
Activity Dashboard
Real-time monitoring of memory operations — searches, retrievals, forged patterns, and directive creation tracked in the sidebar.
One-Click OAuth
Seamless Google OAuth authentication. No manual API key copying — connect your account in one click and start using memory instantly.
Auto MCP Deployment
One click deploys MCP configuration to Cursor, Claude Code, Claude Desktop, Windsurf, Codex, and VS Code Continue.
Session Context Panel
Real-time sidebar showing active sessions, applied patterns, turn count, and memory operations as they happen.
Setup Wizard
3-gate preflight system checks Claude Code, session support, and MCP configuration. Auto-fixes common issues with platform-specific guides.
Secure Credentials
OAuth authentication with optional on-disk key storage (chmod 600). Scoped hook keys with strict file permissions.
Installation
VS Code / Cursor Marketplace
- 1Open Extensions (Cmd/Ctrl + Shift + X)
- 2Search for
ekkOS_Connect - 3Click Install — works in VS Code, Cursor, and Windsurf
CLI Companion (Optional)
The CLI provides ekkos run for infinite context mode with ccDNA compaction. Not required for the extension. See the CLI Reference for full documentation.
Getting Started
1Open the ekkOS Sidebar
Click the ekkOS icon in the activity bar (left sidebar) to open the control panel.
2Connect Your Account
Click “Connect Account” and sign in with Google OAuth. No manual API key copying required.
3Auto MCP Deployment
MCP configuration is automatically deployed to all detected IDEs. The sidebar shows per-IDE connection status.
4Setup Project Rules (Optional)
Run ekkOS: Setup Rules for Current Project to deploy .claude.md and .cursorrules to your workspace.
Claude Code: Two Modes
ekkos run
Infinite Context Mode
- Infinite context via ccDNA compaction
- Proxy routing through mcp.ekkos.dev
- Auto-clear + auto-continue
- Zero knowledge loss on compaction
- Full hooks, skills & MCP tools
Vanilla Claude
Standard 200k Window
- Standard 200k token context
- Direct Anthropic API calls
- Full hooks, skills & MCP tools
- Patterns, directives & recall
- No auto-compaction
Both paths share hooks (~/.claude/hooks/), skills (~/.claude/skills/), and MCP configuration. Switch between them freely.
Supported IDEs
| IDE | Config Location | Format |
|---|---|---|
| Cursor | ~/.cursor/mcp.json | JSON |
| Claude Code CLI | ~/.claude/settings.json | JSON |
| Claude Desktop | ~/Library/Application Support/Claude/ | JSON |
| Windsurf | ~/.codeium/windsurf/mcp_config.json | JSON |
| Codex CLI | ~/.codex/config.toml | TOML |
| VS Code (Continue) | Continue extension config | JSON |
All Commands
Account & Connection
| ekkOS: Connect Account | Start OAuth flow and authenticate |
| ekkOS: Disconnect Account | Remove credentials and sign out |
| ekkOS: Open Sidebar | Open the ekkOS control panel |
| ekkOS: Open Dashboard | Open platform.ekkos.dev |
| ekkOS: Refresh Status | Refresh connection and activity status |
Deployment
| ekkOS: Deploy MCP Config to All IDEs | Deploy MCP configuration everywhere |
| ekkOS: Deploy AI Instructions to Project | Deploy .claude.md and .cursorrules |
| ekkOS: Deploy Custom Agents to Claude Code | Deploy agent plugins to ~/.claude/ |
| ekkOS: Setup Rules for Current Project | Setup ekkOS rules in workspace |
| ekkOS: Setup Global Hooks | One-time global hooks for all projects |
| ekkOS: Validate Templates | Validate template files for correctness |
Setup & Diagnostics
| ekkOS: Setup Wizard (Recommended) | One-button setup with auto-fix |
| ekkOS: Run System Check | 3-gate preflight (Claude, Session, MCP) |
| ekkOS: macOS Setup Guide | Platform-specific setup instructions |
| ekkOS: Windows Setup Guide | Windows-specific setup + quick fix |
| ekkOS: Linux Setup Guide | Linux-specific setup instructions |
Session Context
| ekkOS: Show Session Context | Open session context panel |
| ekkOS: Refresh Session Context | Refresh session data |
| ekkOS: Focus Active Session | Jump to the active session |
Configuration
| Setting | Default | Description |
|---|---|---|
| ekkos.apiUrl | https://mcp.ekkos.dev | ekkOS API endpoint |
| ekkos.platformUrl | https://platform.ekkos.dev | Platform dashboard URL |
| ekkos.autoDeployMcp | true | Auto-deploy MCP after authentication |
| ekkos.showStatusBar | true | Show ekkOS status bar item |
| ekkos.autoSetup | true | Auto-setup rules in new workspaces |
| ekkos.allowDiskApiKey | true | Store scoped hook key on disk (chmod 600) |
Sidebar Panels
Connect Panel
Main dashboard showing account status, setup score, IDE detection, and quick actions.
Session Context Panel
Real-time view of active sessions with turn count, applied patterns, file changes, and memory operations. Updates live as you work.
Troubleshooting
MCP not loading in your IDE?
- • Check Node.js version:
node --version(must be 18+) - • Run
ekkOS: Run System Checkfor 3-gate diagnostics - • Verify config exists at the correct path (see IDE table above)
- • Restart your IDE completely after deployment
Extension not detecting installed IDEs?
- • Verify IDE installation paths match OS defaults
- • Run the Setup Wizard for auto-detection and fix
- • On Windows, use the Windows Quick Fix command