Skip to content

An intelligent CLI assistant that helps developers manage and edit their software projects using natural language.

License

Notifications You must be signed in to change notification settings

Chafficui/CodaiCLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

An intelligent CLI assistant that helps developers manage and edit their software projects using natural language.

Topics

Resources

License

Stars

Watchers

Forks

Languages