Skip to main content

AI-powered CLI assistant for code projects

Project description

Codaicli

PyPI version Python Versions Tests codecov

An AI-powered CLI assistant for managing and editing software projects using natural language.

Features

  • 🤖 Multi-provider AI support:
    • OpenAI
    • Google Gemini
    • Anthropic Claude
  • ⚙️ Interactive configuration system
  • 🔒 Command confirmation for safety
  • 📁 Smart file analysis
  • 🎯 Natural language project management

Installation

# Basic installation
pip install codaicli

# Install with all dependencies
pip install "codaicli[all]"

Quick Start

  1. Navigate to your project directory:
cd your-project
  1. Run Codaicli:
codaicli
  1. Start interacting with your project using natural language!

Configuration

Run the configuration wizard:

codaicli configure

API Keys

You'll need API keys for the AI providers you want to use:

Interactive Configuration

The configuration wizard will guide you through:

  1. Setting up API keys
  2. Selecting default AI provider
  3. Choosing models for each provider
  4. Managing configuration profiles

Commands

Within Codaicli:

  • use openai/gemini/claude - Switch AI provider
  • help - Show help information
  • clear - Clear screen
  • exit (or quit, q) - Exit CodaiCLI

Ignored Files

Create a .codaiignore file to specify files and directories to ignore:

# Ignore specific files
secrets.txt
*.env

# Ignore directories
node_modules/
venv/

Troubleshooting

Common Issues

  1. API Key Errors

  2. Model Not Found

    • Ensure you have access to the selected model
    • Check model availability in your region
  3. Installation Issues

    • Ensure Python 3.8+ is installed
    • Try installing in a virtual environment
  4. Permission Errors

    • Check file permissions
    • Run with appropriate privileges

Security Note

  • All changes and command executions require user confirmation
  • API keys are stored locally in your user directory
  • Use .codaiignore to protect sensitive files
  • No sensitive data is collected or transmitted

Dependencies

  • Python 3.7+
  • OpenAI Python SDK
  • Google Generative AI SDK
  • Anthropic Python SDK
  • Rich (for terminal formatting)
  • Typer (for CLI interface)
  • PyYAML (for configuration)

License

MIT License - See LICENSE file for details

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

codaicli-1.0.0.tar.gz (24.1 kB view details)

Uploaded Source

Built Distribution

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

codaicli-1.0.0-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

File details

Details for the file codaicli-1.0.0.tar.gz.

File metadata

  • Download URL: codaicli-1.0.0.tar.gz
  • Upload date:
  • Size: 24.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for codaicli-1.0.0.tar.gz
Algorithm Hash digest
SHA256 343791cae93c9e1d6f8e6e30227f8957c6bd4fcf3212a3103d19d7226ded4a76
MD5 f469bfcbbc7c923d3b280ee0bc42718a
BLAKE2b-256 ecce0f9d738b433f6db9a16d9dda389beabc50a6be5a5d58402790fcbb833538

See more details on using hashes here.

Provenance

The following attestation bundles were made for codaicli-1.0.0.tar.gz:

Publisher: publish.yml on Chafficui/CodaiCLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file codaicli-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: codaicli-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 17.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for codaicli-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f2fe0be807d9fb17307eb1034a5832e239436f23a8527b46cc0a283c5b1986c5
MD5 362792d20a24f9d5c1330eb635cb3e31
BLAKE2b-256 3827270d80f25ca9538dd8bd817510866d87f0de9238a8d8638d434cb3e5e0cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for codaicli-1.0.0-py3-none-any.whl:

Publisher: publish.yml on Chafficui/CodaiCLI

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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