Skip to main content

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

Metadata

Release files for codaicli 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for codaicli 1.0.0
File Size Uploaded
codaicli-1.0.0.tar.gz 24.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for codaicli 1.0.0
File Interpreter ABI Platform
codaicli-1.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 41.5 kB

Release files / codaicli-1.0.0.tar.gz

Download URL codaicli-1.0.0.tar.gz
Size 24.1 kB
Tags Source
SHA-256 checksum
How to use checksums
343791cae93c9e1d6f8e6e30227f8957c6bd4fcf3212a3103d19d7226ded4a76
BLAKE2b-256 checksum
How to use checksums
ecce0f9d738b433f6db9a16d9dda389beabc50a6be5a5d58402790fcbb833538
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 8, 2025.

Transparency log

Release files / codaicli-1.0.0-py3-none-any.whl

Download URL codaicli-1.0.0-py3-none-any.whl
Size 17.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f2fe0be807d9fb17307eb1034a5832e239436f23a8527b46cc0a283c5b1986c5
BLAKE2b-256 checksum
How to use checksums
3827270d80f25ca9538dd8bd817510866d87f0de9238a8d8638d434cb3e5e0cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 8, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page