Multi-AI Project Configuration Tool

A CLI tool for managing AI provider configurations across different AI coding assistants (Claude Code, Gemini CLI, OpenAI Codex) in your projects.

Installation

Install from GitHub

# Install directly from GitHub using pip
pip install git+https://github.com/djliden/multi-ai-code-cli.git

# Or using uv (recommended)
uv tool install git+https://github.com/djliden/multi-ai-code-cli.git

Local Development Installation

git clone https://github.com/your-username/multi-ai-code-template.git
cd multi-ai-code-template
uv sync
uv run python app.py --help

Usage

The aiproj tool helps you manage AI provider configurations across different AI coding assistants:

Initialize AI Provider Configurations

# Initialize Claude Code configuration
aiproj init --claude

# Initialize multiple providers at once
aiproj init --claude --gemini --codex

# Initialize with specific components only
aiproj init --claude --config --commands

Add New Providers to Existing Project

# Add a new provider with content migration from existing providers
aiproj add gemini --migrate

# Add without migration (clean slate)
aiproj add codex --no-migrate

# Add specific components only
aiproj add claude --commands --prompts

List Provider Status

aiproj list

Clean Up Provider Configurations

# Remove specific provider
aiproj clean claude

# Remove all providers
aiproj clean all

# Remove specific components only
aiproj clean claude --commands --force

What It Does

This tool manages configuration files for different AI coding assistants in your projects:

Supported AI Providers

• Claude Code: Creates CLAUDE.md, .claude/commands/, agents.md
• Gemini CLI: Creates .gemini/config, .gemini/commands/, .gemini/prompts/
• OpenAI Codex: Creates AGENTS.md guidance and .codex/prompts/ templates to sync with ~/.codex/prompts/

Note: Codex only loads slash-command prompts from the global $CODEX_HOME/prompts/ directory. The generated .codex/prompts/ files are project-managed templates that you can copy or symlink into ~/.codex/prompts/.

Key Features

• 🔄 Content Migration: Automatically migrates existing commands and prompts between providers
• 🎯 Component Selection: Choose which components to initialize (config, commands, prompts, agents)
• 📊 Status Overview: See which providers are configured and what components exist
• 🧹 Smart Cleanup: Remove specific providers or components safely
• 🚀 Interactive Setup: Prompts guide you through configuration choices

Limitations

• OpenAI Codex slash commands stay global: Codex only loads prompts from ~/.codex/prompts/, so templates generated under .codex/prompts/ are not picked up automatically. Copy or symlink the files when you need them active:
  • Copy: cp .codex/prompts/*.md ~/.codex/prompts/
  • Symlink: ln -s "$PWD/.codex/prompts/code-review.md" ~/.codex/prompts/code-review.md
  • Automate: add a simple sync script or Git hook to keep the global directory up to date.

Example Workflow

# Start with Claude Code in your project
aiproj init --claude

# Later, add Gemini and migrate your existing Claude commands
aiproj add gemini --migrate

# Check status of all providers
aiproj list

# Clean up if needed
aiproj clean codex

Development

Built with:

• 🔧 Typer: Modern CLI framework
• 🎨 Rich: Beautiful terminal output
• ⚡ uv: Fast Python package management
• 🧪 pytest: Comprehensive test suite
• 🛠️ ruff: Code formatting and linting