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, JWT Bearer Auth). 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, 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.

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, codemie-opencode, 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

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

ACP Agent usage in IDEs and Editors

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.

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 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