CodeMate AI - Enterprise AI Coding Assistant 🤖

Your AI pair programmer in the terminal

CodeMate AI is an enterprise-grade AI coding assistant that brings the power of large language models directly to your terminal. Built with TypeScript and powered by OpenAI, Anthropic, and DeepSeek, it transforms natural language into working code.

✨ Features

• 🚀 Natural Language to Code - Describe what you want, get working code
• 🔧 Intelligent Code Editing - AST-based code modifications with context awareness
• 🧪 AI-Powered Testing - Automatic test generation and validation
• 📊 Performance Optimization - Prompt caching, context compression, intelligent pruning
• 🌐 HTTP Server Mode - Browser-based UI with WebSocket support
• 🔌 MCP Protocol Support - Extensible tool system via Model Context Protocol
• 🌍 Multiple AI Providers - OpenAI, Anthropic, DeepSeek, OpenRouter, and custom APIs
• 🎨 Multiple Output Styles - Customizable output formatting and themes
• 💾 Session Management - Resume conversations and track file changes
• 🔄 Multi-Agent System - Specialized agents for different tasks
• 🎯 Slash Commands - Quick actions with /help, /clear, /sessions, etc.

📦 Installation

npm install -g codemate-ai

Requirements:

• Node.js 18.0.0 or higher
• OpenAI, Anthropic, or DeepSeek API key

🚀 Quick Start

First Run

On first run, CodeMate AI will guide you through interactive setup:

$ codemate

欢迎使用 CodeMate AI! 🎉

检测到这是首次运行，需要进行初始配置。

请选择 AI 提供商:
  1. OpenAI (GPT-4, GPT-3.5)
  2. Anthropic (Claude)
  3. DeepSeek (国内可用，性价比高)
  4. OpenRouter (多模型聚合)
  5. 自定义 (OpenAI 兼容 API)

请输入选项 (1-5): 3

请输入 API Key: sk-...

请输入模型名称 (直接回车使用默认: deepseek-chat): 

✅ 配置已保存到: ~/.aiclirc.json

提供商: DeepSeek
模型: deepseek-chat
Base URL: https://api.deepseek.com

配置完成！现在可以开始使用了。

试试：codemate "创建一个 Hello World 程序"

Basic Usage

# One-shot command
codemate "create a REST API with Express and TypeScript"

# Interactive mode
codemate

# Server mode (browser UI)
codemate --server --port 3000

📖 Usage Examples

Create a New Project

codemate "create a React app with TypeScript and Tailwind CSS"

Refactor Code

codemate "refactor the UserService class to use dependency injection"

Generate Tests

codemate "write unit tests for the authentication module"

Debug Issues

codemate "fix the memory leak in the WebSocket server"

⚙️ Configuration

Configuration file: ~/.aiclirc.json

Supported AI Providers

Configuration Examples

OpenAI:

{
  "provider": "openai",
  "apiKey": "sk-...",
  "model": "gpt-4",
  "performance": {
    "enableCaching": true,
    "enableCompression": true
  }
}

DeepSeek:

{
  "provider": "deepseek",
  "apiKey": "sk-...",
  "model": "deepseek-chat",
  "baseURL": "https://api.deepseek.com",
  "performance": {
    "enableCaching": true,
    "enableCompression": true
  }
}

Custom API:

{
  "provider": "custom",
  "apiKey": "your-key",
  "model": "your-model",
  "baseURL": "https://api.example.com/v1",
  "performance": {
    "enableCaching": true,
    "enableCompression": true
  }
}

Supported Models

OpenAI:

• gpt-4
• gpt-4-turbo
• gpt-3.5-turbo

Anthropic:

• claude-3-5-sonnet-20241022
• claude-3-opus-20240229
• claude-3-sonnet-20240229

DeepSeek:

• deepseek-chat
• deepseek-coder

OpenRouter:

• anthropic/claude-3.5-sonnet
• openai/gpt-4
• And many more...

🎮 Commands

Slash Commands

• /help - Show available commands
• /clear - Clear current session
• /sessions - List all sessions
• /model - Change AI model
• /style - Change output style
• /snapshots - View file history
• /rewind - Revert file changes
• /exit - Exit AICLI

CLI Options

codemate [options] [prompt]

Options:
  -v, --version              Output version number
  -h, --help                 Display help
  -s, --server               Start HTTP server mode
  -p, --port <port>          Server port (default: 3000)
  -m, --model <model>        AI model to use
  --no-cache                 Disable prompt caching
  --no-compression           Disable context compression

🏗️ Architecture

CodeMate AI is built with a modular architecture:

• Application Layer - Dependency injection and lifecycle management
• Service Layer - Core services (Model, Config, Session, EventBus)
• Manager Layer - Tool, Plugin, Agent, Command managers
• Tool System - File operations, search, bash execution, code editing
• Agent System - General, Plan, and Explore agents
• UI Layer - Ink-based terminal UI with React components
• Server Layer - HTTP server with WebSocket for browser UI

🔌 Extensibility

Custom Plugins

Create custom plugins in ~/.codemate/plugins/:

import { Plugin } from 'codemate-ai';

export class MyPlugin extends Plugin {
  name = 'my-plugin';
  
  async onInit() {
    console.log('Plugin initialized');
  }
  
  async onToolCall(tool: string, args: any) {
    // Custom logic
  }
}

MCP Integration

CodeMate AI supports the Model Context Protocol for extending tool capabilities. Configure MCP servers in your config file.

📚 Documentation

• Complete Tutorial - 25-chapter tutorial series
• Architecture Design
• API Documentation
• Tool System
• Performance Optimization

🧪 Development

# Clone repository
git clone https://github.com/your-org/codemate-ai.git
cd codemate-ai

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Type checking
npm run typecheck

# Format code
npm run format

# Run full CI
npm run ci

# Build for production
npm run build

# Test local installation
npm run test:install

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

📝 License

MIT © Your Name

🙏 Acknowledgments

• Built with AI SDK
• UI powered by Ink
• Inspired by Neovate Code

📮 Support

• 🐛 Report Issues
• 💬 Discussions
• 📧 Email: support@codemate-ai.com

Made with ❤️ by developers, for developers