CodeCortex AI — autonomous coding agent for the terminal
Project description
CodeCortex AI
Autonomous coding agent for the terminal — powered by LLMs.
Installation
pip install codecortex-ai
Quick Start
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
# 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
codecortex_ai-0.1.1.tar.gz
(51.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codecortex_ai-0.1.1.tar.gz.
File metadata
- Download URL: codecortex_ai-0.1.1.tar.gz
- Upload date:
- Size: 51.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0aa809188f97085ddb7c8b268db54448f39e1728cde49231e6a51284146d9498
|
|
| MD5 |
c9700e7191a9e7d5e46cd34f000484a3
|
|
| BLAKE2b-256 |
b4c82428097560cf65a1ccb55b07a930af2dc6e442ca7613176745ed38da1956
|
File details
Details for the file codecortex_ai-0.1.1-py3-none-any.whl.
File metadata
- Download URL: codecortex_ai-0.1.1-py3-none-any.whl
- Upload date:
- Size: 66.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1bcf30a50d2f9327d9f80651afb227784c0bfc18489dd9818c12708507daa74a
|
|
| MD5 |
745ca7e2250da9f7cdaa122a93457364
|
|
| BLAKE2b-256 |
f3b80d84cd6bdf448504db44bffcd80759c72699970f9f54659140f1d7b3e210
|