Agent-CoreX

Execute any task with a single natural language query.

Agent-CoreX is a thin CLI + MCP client for the Agent-CoreX v2 backend. All intelligence — query decomposition, tool selection, input extraction, and execution — lives in the backend.

Install

# pip
pip install agent-corex

# uvx (no install required)
uvx agent-corex run "list my supabase projects"

# Homebrew (macOS / Linux)
brew tap ankitpro/agent-corex
brew install agent-corex

# Binary — download from GitHub Releases
# https://github.com/ankitpro/agent-corex/releases/latest

Quickstart

# Authenticate
agent-corex login --key acx_your_api_key

# Run a query
agent-corex run "list my supabase projects"

# Debug mode — see full execution pipeline
agent-corex run "create a github repo called my-app" --debug

CLI Reference

agent-corex run "<query>"                 Execute a task
agent-corex run "<query>" --debug         Show full step details
agent-corex config set api_url=<url>      Set backend URL
agent-corex config set api_key=<key>      Set API key
agent-corex config show                   Show current config
agent-corex login --key <key>             Store and verify API key
agent-corex logout                        Remove stored API key
agent-corex health                        Check backend status
agent-corex version                       Print version
agent-corex serve                         Start MCP server (for Claude/Cursor)

MCP Usage

Agent-CoreX exposes a single MCP tool — execute_query — for use with Claude Desktop, Cursor, and other MCP-compatible clients.

Claude Desktop / Cursor

Add to your MCP config:

{
  "agent-corex": {
    "command": "agent-corex",
    "args": ["serve"],
    "env": {
      "AGENT_COREX_API_KEY": "acx_your_api_key"
    }
  }
}

uvx (no install required)

{
  "agent-corex": {
    "command": "uvx",
    "args": ["agent-corex", "serve"],
    "env": {
      "AGENT_COREX_API_KEY": "acx_your_api_key"
    }
  }
}

Once connected, use Claude naturally — it will call execute_query automatically:

"List my Supabase projects" "Create a GitHub repo called my-app and add a README" "Deploy my Railway service"

Examples

# List Supabase projects
agent-corex run "list my supabase projects"

# Multi-step: list and analyze
agent-corex run "list my supabase projects and show their sizes"

# Debug mode — see intents, tools, inputs, latency
agent-corex run "deploy my railway service" --debug

# Missing input — backend will ask what's needed
agent-corex run "deploy service"

Configuration

Config is stored at ~/.agent-corex/config.json:

{
  "api_url": "https://api.v2.agent-corex.com",
  "api_key": "acx_..."
}

Override via environment variables:

AGENT_COREX_API_KEY=acx_...        # takes priority over config file
AGENT_COREX_API_URL=http://...     # for local development

Architecture

User / LLM
    │
    ├── CLI: agent-corex run "<query>"
    │         └── POST /execute/query → backend v2
    │                   (decompose → retrieve → select → execute)
    │
    └── MCP: execute_query tool
              └── POST /execute/query → backend v2

The CLI is intentionally minimal:

backend = brain (query decomposition, tool selection, execution)
CLI = interface (send query, display response)
MCP = bridge (expose single tool to LLMs)

License

MIT — see LICENSE

Metadata

Release files for agent-corex 4.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agent-corex 4.4.5
File	Size	Uploaded
agent_corex-4.4.5.tar.gz	65.3 kB	Apr 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for agent-corex 4.4.5
File	Interpreter	ABI	Platform	Reset
agent_corex-4.4.5-py3-none-any.whl 31.5 kB Apr 28, 2026	Python 3	none	any	Details

Total release size: 96.8 kB

Release files / agent_corex-4.4.5.tar.gz

Download URL	agent_corex-4.4.5.tar.gz
Size	65.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`6d889e3d8ced01e8719a8a9d233a2bf23b7ae7bac7805a7e7c37ea6cf019565b`
BLAKE2b-256 checksum How to use checksums	`0564c4de92197fd2f69a289d42bb4aa89981485e7327725eb5c011f8155981ce`
Upload date	Apr 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Release files / agent_corex-4.4.5-py3-none-any.whl

Download URL	agent_corex-4.4.5-py3-none-any.whl
Size	31.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`010fb102eb7f762779ec89b351c21762123f39d1360e8925d13fe83268f7c2b0`
BLAKE2b-256 checksum How to use checksums	`50d4c0533facdfaa879a6d3d112d384b3343a47d4c80e5128ed2fe7819544c7a`
Upload date	Apr 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.12`