Unified AI Coding Assistant CLI - Manage Claude Code, Google Gemini, OpenCode, and custom AI agents from one powerful command-line interface. Multi-provider support (OpenAI, Azure OpenAI, AWS Bedrock, LiteLLM, Ollama, Enterprise SSO, JWT Bearer Auth). Built-in LangGraph agent with file operations, command execution, and planning tools. Cross-platform support for Windows, Linux, and macOS.

CodeMie CLI is the all-in-one AI coding assistant for developers.

• ✨ One CLI, Multiple AI Agents - Switch between Claude Code, Gemini, OpenCode, and built-in agent.
• 🔄 Multi-Provider Support - OpenAI, Azure OpenAI, AWS Bedrock, LiteLLM, Ollama, Enterprise SSO, and JWT Bearer Auth.
• 🚀 Built-in Agent - A powerful LangGraph-based assistant with file operations, command execution, and planning tools.
• 🖥️ Cross-Platform - Full support for Windows, Linux, and macOS with platform-specific optimizations.
• 🔐 Enterprise Ready - SSO and JWT authentication, audit logging, and role-based access.
• ⚡ Productivity Boost - Code review, refactoring, test generation, and bug fixing.
• 🎯 Profile Management - Manage work, personal, and team configurations separately.
• 📊 Usage Analytics - Track and analyze AI usage across all agents with detailed insights.
• 🔧 CI/CD Workflows - Automated code review, fixes, and feature implementation.

Perfect for developers seeking a powerful alternative to GitHub Copilot or Cursor.

# Install globally for best experience npm install -g @codemieai/code # 1. Setup (interactive wizard) codemie setup # 2. Check system health codemie doctor # 3. Install an external agent (e.g., Claude Code - latest supported version) codemie install claude --supported # 4. Use the installed agent codemie-claude "Review my API code" # 5. Use the built-in agent codemie-code "Analyze this codebase" # 6. Execute a single task and exit codemie --task "Generate unit tests"

Prefer not to install globally? Use npx with the full package name:

npx @codemieai/code setup npx @codemieai/code doctor npx @codemieai/code install claude --supported # Note: Agent shortcuts require global installation

For the best experience with all features and agent shortcuts:

npm install -g @codemieai/code codemie --help

For project-specific usage:

npm install @codemieai/code # Use with npx npx @codemieai/code --help

Note: Agent shortcuts (codemie-claude, codemie-code, codemie-opencode, etc.) require global installation.

git clone https://github.com/codemie-ai/codemie-code.git cd codemie-code npm install npm run build && npm link

codemie --help codemie doctor

The CodeMie CLI provides two ways to interact with AI agents:

The built-in agent is ready to use immediately and is great for a wide range of coding tasks.

Available Tools:

• read_file - Read file contents
• write_file - Write content to files
• list_directory - List files with intelligent filtering (auto-filters node_modules, .git, etc.)
• execute_command - Execute shell commands with progress tracking
• write_todos / update_todo_status / append_todo / clear_todos / show_todos - Planning and progress tracking tools

# Start an interactive conversation codemie-code # Start with an initial message codemie-code "Help me refactor this component"

You can also install and use external agents like Claude Code and Gemini.

Available Agents:

• Claude Code (codemie-claude) - Anthropic's official CLI with advanced code understanding
• Claude Code ACP (codemie-claude-acp) - Claude Code for IDE integration via ACP protocol (Zed, JetBrains, Emacs)
• Gemini CLI (codemie-gemini) - Google's Gemini for coding tasks
• OpenCode (codemie-opencode) - Open-source AI coding assistant with session analytics

# Install an agent (latest supported version) codemie install claude --supported # Use the agent codemie-claude "Review my API code" # Install Gemini codemie install gemini codemie-gemini "Implement a REST API" # Install OpenCode codemie install opencode # Install Claude Code ACP (for IDE integration) codemie install claude-acp # Configure in your IDE (see docs/AGENTS.md for details)

Zed (~/.config/zed/settings.json):

{ "agent_servers": { "claude": { "command": "codemie-claude-acp", "args": ["--profile", "work"] } } }

IntelliJ IDEA (~/.jetbrains/acp.json):

{ "default_mcp_settings": {}, "agent_servers": { "Claude Code via CodeMie": { "command": "codemie-claude-acp" } } }

Emacs (with acp.el):

(setq acp-claude-command "codemie-claude-acp") (setq acp-claude-args '("--profile" "work"))

Version Management:

CodeMie manages agent versions to ensure compatibility. For Claude Code:

# Install latest supported version (recommended) codemie install claude --supported # Install specific version codemie install claude 2.1.22 # Install latest available version codemie install claude

Auto-updates are automatically disabled to maintain version control. CodeMie notifies you when running a different version than supported.

For more detailed information on the available agents, see the Agents Documentation.

When using Claude Code (codemie-claude), you get access to powerful built-in commands for project documentation:

Project Documentation:

# Generate AI-optimized docs (CLAUDE.md + guides). Can be added optional details after command as well /codemie:codemie-init # Generate project-specific subagents. Can be added optional details after command as well /codemie:codemie-subagents

Memory Management:

# Capture important learnings /memory-add # Audit and update documentation /memory-refresh

These commands analyze your actual codebase to create tailored documentation and specialized agents. See Claude Plugin Documentation for details.

When using OpenCode, CodeMie automatically extracts and tracks session metrics:

Manual Metrics Processing:

# Process a specific OpenCode session codemie opencode-metrics --session <session-id> # Discover and process all recent sessions codemie opencode-metrics --discover # Verbose output with details codemie opencode-metrics --discover --verbose

Metrics are automatically extracted at session end and synced to the analytics system. Use codemie analytics to view comprehensive usage statistics across all agents.

The CodeMie CLI has a rich set of commands for managing agents, configuration, and more.

codemie setup # Interactive configuration wizard codemie list # List all available agents codemie install <agent> # Install an agent codemie update <agent> # Update installed agents codemie self-update # Update CodeMie CLI itself codemie profile # Manage provider profiles codemie analytics # View usage analytics (sessions, tokens, costs, tools) codemie workflow <cmd> # Manage CI/CD workflows codemie doctor # Health check and diagnostics

For a full command reference, see the Commands Documentation.

Comprehensive guides are available in the docs/ directory:

• Configuration - Setup wizard, environment variables, multi-provider profiles, manual configuration
  • CODEMIE_INSECURE=1 — disable SSL verification for self-signed certs or local dev environments (SSL is on by default)
• Commands - Complete command reference including analytics and workflow commands
• Agents - Detailed information about each agent (Claude Code, Gemini, built-in)
• Authentication - SSO setup, token management, enterprise authentication
• Examples - Common workflows, multi-provider examples, CI/CD integration
• Configuration Architecture - How configuration flows through the system from CLI to proxy plugins
• Claude Code Plugin - Built-in commands, hooks system, and plugin architecture

Contributions are welcome! Please read our Contributing Guidelines to get started.

This project is licensed under the Apache-2.0 License.

• GitHub Repository
• Issue Tracker
• NPM Package