Metadata-Version: 2.4
Name: codecortex-ai
Version: 0.1.0
Summary: CodeCortex AI — autonomous coding agent for the terminal
Author: Tanishq Shukla
License: MIT
Keywords: ai,coding,agent,cli,openai,llm
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: openai
Requires-Dist: click
Requires-Dist: rich
Requires-Dist: pydantic
Requires-Dist: tomli
Requires-Dist: platformdirs
Requires-Dist: tiktoken
Requires-Dist: fastmcp
Requires-Dist: httpx
Requires-Dist: duckduckgo-search
Requires-Dist: python-dotenv

# CodeCortex AI

**Autonomous coding agent for the terminal** — powered by LLMs.

## Installation

```bash
pip install codecortex-ai
```

## Quick Start

```bash
codecortex
```

On first run, you'll be prompted for:
- **API Key** (required) — your OpenAI, OpenRouter, or any compatible provider key
- **Base URL** (optional) — leave blank for OpenAI, or enter a custom endpoint

Configuration is saved to `~/.codecortex/config.json`.

## Usage

```bash
# Interactive mode
codecortex

# Single prompt
codecortex "refactor this function to use async/await"

# Specify working directory
codecortex --cwd ./my-project

# Reset saved config
codecortex --reset
```

## Supported Providers

Any OpenAI-compatible API works:
- **OpenAI** — leave Base URL empty (default)
- **OpenRouter** — `https://openrouter.ai/api/v1`
- **Anthropic via proxy** — any compatible endpoint
- **Local models** (Ollama, LM Studio) — `http://localhost:11434/v1`

## Commands

Inside the interactive session:

| Command      | Description                    |
|-------------|--------------------------------|
| `/help`     | Show help                      |
| `/config`   | Show current configuration     |
| `/model`    | View or change model           |
| `/approval` | View or change approval policy |
| `/tools`    | List available tools           |
| `/mcp`      | List MCP servers               |
| `/stats`    | Show session statistics        |
| `/save`     | Save current session           |
| `/sessions` | List saved sessions            |
| `/resume`   | Resume a saved session         |
| `/clear`    | Clear conversation             |
| `/exit`     | Quit                           |

## License

MIT
