Cortex
Documentation
Install and connect Cortex
Install Cortex through the Socra CLI, then let Cortex configure each supported coding agent detected on your computer.
Before you start
You need:
- A Socra Account.
- At least one supported coding agent: Codex, Claude Code, Cursor, or GitHub Copilot CLI.
- macOS, Linux, or Windows.
The Cortex integration adds SessionStart context and a hosted MCP connection to each detected agent host. The hosted MCP surface includes operations that can create, update, and delete Cortex resources. Your agent host applies its own approval policy before it invokes a tool.
Install the Socra CLI
Run the installer:
curl -fsSL https://cli.socra.cloud/install.sh | sh
Open a new terminal after the installer completes.
Install Cortex and sign in
Install the Cortex CLI namespace:
socra install cortex
Sign in to your Socra Account:
socra account login
The browser authorization flow asks you to choose the Account that Cortex uses for CLI operations.
Configure your coding agents
Run:
socra cortex setup
The command detects supported coding agents, installs or updates the Cortex plugin for each detected host, and verifies the resulting installation. You can run the command again without creating duplicate installations.
Restart every configured agent host after the command completes. Each host asks you to authorize its Cortex MCP connection when it first needs Cortex tools. The plugin contains a public OAuth client ID, not a client secret, and the setup process does not copy your Socra CLI access token into an agent host.
Verify the connection
Verify CLI access:
socra cortex map
Then start a new session in one configured coding agent and ask:
Use Cortex to list the Modules I can access.
The setup is complete when the agent can call Cortex and return the Module list. A new Account can return an empty list.