Metadata-Version: 2.4
Name: agent-corex
Version: 4.4.1
Summary: Thin CLI + MCP client for Agent-CoreX — execute any task with a single query
Author-email: Ankit Agarwal <ankitagarwalpro@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/ankitpro/agent-corex
Project-URL: Documentation, https://github.com/ankitpro/agent-corex#readme
Project-URL: Repository, https://github.com/ankitpro/agent-corex.git
Project-URL: Bug Tracker, https://github.com/ankitpro/agent-corex/issues
Project-URL: Changelog, https://github.com/ankitpro/agent-corex/releases
Keywords: mcp,ai-agent,cli,llm,agent-corex,tool-execution
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-httpx>=0.30.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

# 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

```bash
# 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

```bash
# 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:

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

### uvx (no install required)

```json
{
  "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

```bash
# 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`:

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

Override via environment variables:
```bash
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](LICENSE)
