Codaicli
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
- Navigate to your project directory:
cd your-project
- Run Codaicli:
codaicli
- 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:
- Setting up API keys
- Selecting default AI provider
- Choosing models for each provider
- Managing configuration profiles
Commands
Within Codaicli:
use openai/gemini/claude- Switch AI providerhelp- Show help informationclear- Clear screenexit(orquit,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
-
API Key Errors
- Verify your API keys are correctly configured
- Check provider status pages:
-
Model Not Found
- Ensure you have access to the selected model
- Check model availability in your region
-
Installation Issues
- Ensure Python 3.8+ is installed
- Try installing in a virtual environment
-
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
.codaiignoreto 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)
| File | Size | Uploaded | |
|---|---|---|---|
| codaicli-1.0.0.tar.gz | 24.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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