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.0.tar.gz
(51.1 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.0.tar.gz.
File metadata
- Download URL: codecortex_ai-0.1.0.tar.gz
- Upload date:
- Size: 51.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3ae17ec64fd186c22a3fe3a86587adac029baa9f8606c83fd54bc17c409e428a
|
|
| MD5 |
a896426f3e840f7905ce3eaed51fbe31
|
|
| BLAKE2b-256 |
5f7bb04b8522aa9da6f240323005574a8b0ec040c3c4abe2f029df801e01b486
|
File details
Details for the file codecortex_ai-0.1.0-py3-none-any.whl.
File metadata
- Download URL: codecortex_ai-0.1.0-py3-none-any.whl
- Upload date:
- Size: 66.6 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 |
762d22a5c047363a66525bc6b41b2eb8f5a26245c747f640973383427871df07
|
|
| MD5 |
3f092f9828510011f812dd4158caab69
|
|
| BLAKE2b-256 |
f81d6831ff13898661e677e95aa45d00f6c057daf9b994df15ef091d201c2bd5
|