Unified AI coding assistant CLI - Manage Claude Code, Gemini & custom agents. Multi-provider support (OpenAI, Azure, LiteLLM, SSO). Built-in LangGraph agent with file operations & git integration.
npm install @codemieai/code








> 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.
---
---
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.
``bashInstall globally for best experience
npm install -g @codemieai/code
Prefer not to install globally? Use npx with the full package name:
`bash
npx @codemieai/code setup
npx @codemieai/code doctor
npx @codemieai/code install claude --supported
Note: Agent shortcuts require global installation
`Installation
$3
For the best experience with all features and agent shortcuts:
`bash
npm install -g @codemieai/code
codemie --help
`$3
For project-specific usage:
`bash
npm install @codemieai/codeUse with npx
npx @codemieai/code --help
`Note: Agent shortcuts (
codemie-claude, codemie-code, etc.) require global installation.$3
`bash
git clone https://github.com/codemie-ai/codemie-code.git
cd codemie-code
npm install
npm run build && npm link
`$3
`bash
codemie --help
codemie doctor
`Usage
The CodeMie CLI provides two ways to interact with AI agents:
$3
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`bash
Start an interactive conversation
codemie-codeStart with an initial message
codemie-code "Help me refactor this component"
`$3
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`bash
Install an agent (latest supported version)
codemie install claude --supportedUse 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)
`#### ACP Agent usage in IDEs and Editors
Zed (
~/.config/zed/settings.json):
`json
{
"agent_servers": {
"claude": {
"command": "codemie-claude-acp",
"args": ["--profile", "work"]
}
}
}
`IntelliJ IDEA (
~/.jetbrains/acp.json):
`json
{
"default_mcp_settings": {},
"agent_servers": {
"Claude Code via CodeMie": {
"command": "codemie-claude-acp"
}
}
}
`Emacs (with acp.el):
`elisp
(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:
`bash
Install latest supported version (recommended)
codemie install claude --supportedInstall specific version
codemie install claude 2.1.22Install 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.
$3
When using Claude Code (
codemie-claude), you get access to powerful built-in commands for project documentation:Project Documentation:
`bash
Generate AI-optimized docs (CLAUDE.md + guides). Can be added optional details after command as well
/codemie:codemie-initGenerate project-specific subagents. Can be added optional details after command as well
/codemie:codemie-subagents
`Memory Management:
`bash
Capture important learnings
/memory-addAudit and update documentation
/memory-refresh
`These commands analyze your actual codebase to create tailored documentation and specialized agents. See Claude Plugin Documentation for details.
$3
When using OpenCode (
codemie-opencode), CodeMie automatically extracts and tracks session metrics:Manual Metrics Processing:
`bash
Process a specific OpenCode session
codemie opencode-metrics --session Discover and process all recent sessions
codemie opencode-metrics --discoverVerbose 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.
`bash
codemie setup # Interactive configuration wizard
codemie list # List all available agents
codemie install # Install an agent
codemie update # 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 # 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
Contributions are welcome! Please read our Contributing Guidelines to get started.
This project is licensed under the Apache-2.0 License.