Skip to main content

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)
  • OpenRouterhttps://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


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)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

codecortex_ai-0.1.0-py3-none-any.whl (66.6 kB view details)

Uploaded Python 3

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

Hashes for codecortex_ai-0.1.0.tar.gz
Algorithm Hash digest
SHA256 3ae17ec64fd186c22a3fe3a86587adac029baa9f8606c83fd54bc17c409e428a
MD5 a896426f3e840f7905ce3eaed51fbe31
BLAKE2b-256 5f7bb04b8522aa9da6f240323005574a8b0ec040c3c4abe2f029df801e01b486

See more details on using hashes here.

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

Hashes for codecortex_ai-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 762d22a5c047363a66525bc6b41b2eb8f5a26245c747f640973383427871df07
MD5 3f092f9828510011f812dd4158caab69
BLAKE2b-256 f81d6831ff13898661e677e95aa45d00f6c057daf9b994df15ef091d201c2bd5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page