AI/Run CodeMie CLI

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). Built-in LangGraph agent with file operations, command execution, and planning tools. Cross-platform support for Windows, Linux, and macOS.

Why CodeMie CLI?

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, and Enterprise SSO.
• 🚀 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 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.

Quick Start

# 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

Installation

Global Installation (Recommended)

For the best experience with all features and agent shortcuts:

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

Local/Project Installation

For project-specific usage:

npm install @codemieai/code

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

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

From Source

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

Verify Installation

codemie --help
codemie doctor

Usage

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

Built-in Agent (CodeMie Native)

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"

External Agents

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
codemie-opencode "Generate unit tests for my service"

# Install Claude Code ACP (for IDE integration)
codemie install claude-acp
# Configure in your IDE (see docs/AGENTS.md for details)

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.

Claude Code Built-in Commands

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.

OpenCode Session Metrics

When using OpenCode (codemie-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.

Commands

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.

Documentation

Comprehensive guides are available in the docs/ directory:

• Configuration - Setup wizard, environment variables, multi-provider profiles, manual configuration
• 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

Contributing

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

License

This project is licensed under the Apache-2.0 License.

Links

• GitHub Repository
• Issue Tracker
• NPM Package