🚀 Agent-Corex

Intelligent Tool Selection for LLMs

Quick Start Guide

Get Agent-Corex running in 5 minutes

Quick Start (5 Minutes)

Step 1 — Install

Pick any one method:

Homebrew (macOS / Linux — no Python required):

brew tap ankitpro/agent-corex
brew install agent-corex

Direct binary (macOS arm64):

curl -fsSL https://github.com/ankitpro/agent-corex/releases/latest/download/agent-corex-macos-arm64 \
  -o /usr/local/bin/agent-corex && chmod +x /usr/local/bin/agent-corex

Direct binary (Linux x86_64):

curl -fsSL https://github.com/ankitpro/agent-corex/releases/latest/download/agent-corex-linux-x86_64 \
  -o /usr/local/bin/agent-corex && chmod +x /usr/local/bin/agent-corex

Windows — run PowerShell as Administrator and paste:

Invoke-WebRequest `
  -Uri https://github.com/ankitpro/agent-corex/releases/latest/download/agent-corex-windows-x86_64.exe `
  -OutFile "$env:SystemRoot\System32\agent-corex.exe"
agent-corex --version

This installs to System32 so agent-corex works from any terminal. No admin? See the per-user install in the full guide.

pip (Python 3.8+):

pip install agent-corex

Step 2 — Verify

agent-corex --version
# agent-corex 1.1.0
# (also works as: agent-corex version)

Step 3 — Connect to Your AI Tools

# Authenticate
agent-corex login --key acx_your_key

# See which tools (Claude Desktop, Cursor, VS Code, etc.) are installed
agent-corex detect

# Inject agent-corex as an MCP server into all detected tools
agent-corex init

Example output:

Scanning for AI tools...

  [+] Claude Desktop: /Users/you/Library/Application Support/Claude/claude_desktop_config.json
      Existing servers (will be kept): filesystem, git
      Add 'agent-corex' entry? [Y/n]: Y
      [+] Injected. Backup saved.

  [+] VS Code: /Users/you/Library/Application Support/Code/User/mcp.json
      Add 'agent-corex' entry? [Y/n]: Y
      [+] Injected. Backup saved.

Done. Restart your AI tools for changes to take effect.

Restart Claude Desktop / Cursor / VS Code — Agent-CoreX will appear as an available MCP server.

Step 4 — Verify Setup

agent-corex status

agent-corex  v1.1.0

Auth
  [+] Logged in: Yes

MCP Clients
  [+] Claude Desktop: detected
      agent-corex inject: [+] Yes
  [+] VS Code: detected
      agent-corex inject: [+] Yes

If something looks wrong:

agent-corex doctor   # runs 7 health checks and shows exactly what to fix

Step 5 — Browse & Install MCP Servers

agent-corex registry              # browse the marketplace catalog
agent-corex install-mcp github    # install the GitHub MCP server
agent-corex install-mcp postgres  # install Postgres
agent-corex list                  # see all currently installed servers
agent-corex update                # pull latest configs from registry

Useful Commands

agent-corex detect             # detect AI tools
agent-corex init               # inject into all tools
agent-corex eject              # remove from all tools
agent-corex status             # full status report
agent-corex doctor             # health diagnostics
agent-corex keys               # show/verify API key
agent-corex logout             # remove credentials

Next Steps