Codg

The next easy code and work AI agents harness system, auto and asynchronous, concurrency and high performance, Efficiently and High accuracy.

English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Français | Deutsch | Español | Português | Русский | العربية

Installation

Mac and Linux:

# Homebrew
brew install vcaesar/tap/codg

# NPM
# npm install -g @vcaesar/codg

Windows:

# Winget
# winget install vcaesar.codg

# YOLO
curl -fsSL https://raw.githubusercontent.com/vcaesar/codg/main/demo/boot.sh | bash

Or click Releases directly to download and run it.

Go to your project directory, run codg. Use "/yolo" to toggle the auto and ask mode, and you can set permissions by codg.toml.

Features

• Auto and asynchronous, concurrency and high performance agents system, and low memory use
• Multi models providers (API and Pro) and local models via by openai-compat or claude-compat, Support Openrouter free models, "/connect" "/models" or "codg auth"
• Any terminal and OS support, also web terminal support
• Easy use: The TUI in everywhere like GUI and Easy, Desktop and Web in the BETA
• Click or "/xxx" to switch sessions, Click to everywhere in TUI
• Clcik "Modified Files" or "/diff" and "/diff git" to view the diff files in TUI same the vscode
• Autocomplete the English letters and short sentences

Desktop App (BETA), Web (BETA), Claw (BETA), Some features need wait for the test and fix bugs

Reporting Bugs:

Open a Github Issues

How we use your data:

Currently no any data and telemetry is collected here, and 100% local model supported, use the API you can see they providers' policies.

CLI Commands

Use: codg -h or "/help" in TUI

codg auth/login               # Authenticate (Atom, OpenAI, GitHub...)
codg web                      # Start web UI on port 4096
codg desktop                  # Launch the desktop app (Wails)
codg claw                     # Start messaging agent (Telegram/Discord/Slack)
codg gateway --private-only   # Start secured gateway
codg models claude            # List models matching "claude"
codg runm start Qwen/Qwen3-8B-GGUF   # Start a local model
codg runm download user/model # Download a GGUF model
codg plugin install repo/name # Install a plugin
codg plugin list              # List installed plugins
codg install repo/name        # Shorthand for plugin install
codg mcp add myserver cmd     # Add an MCP server
codg mcp list                 # List configured MCP servers
codg skill url add <url>      # Add a skill source URL
codg themes set catppuccin    # Switch theme
# codg logs -f                # Tail application logs
codg toml                     # show the all config
codg stats/s                  # Show usage statistics
codg dirs                     # Print data/config directory paths
codg projects                 # List tracked project directories
codg lite 2                   # Set lite mode level (0-4)
codg merge origin main        # Safe git merge with v1/ backup
codg migrate                  # Migrate config from .claude/.opencode
codg vm build                 # Build on remote VM
codg vm run -- make test      # Execute command on VM
codg sandbox run -- ./test.sh # Run in sandbox
codg sandbox status           # Check sandbox availability
codg update                   # Update provider definitions

Usage Examples

Non-Interactive (codg run)

# Pipe input from another command.
cat errors.log | codg run "What's causing these errors?"
# Verbose mode (debug output to stderr).
codg run -v "Debug this function"

Web UI

# Start the web UI on default port 4096; (Wait done for the test, build it).
codg web
# Custom port.
codg web -p 8080

# API-only mode (no frontend, no browser).
codg web 0

Plugin Management

# Install a plugin from a Git repository.
codg install github.com/user/codg-xxx-auth

Custom Agents and Skills:

Copy xx_agent.md (.codg/agents/templates) or SKILL.md (.codg/skills) to the directory

Configuration System

Create a codg.toml in your project root (or ~/.codg/config/codg.toml for global settings):

# codg.toml — Minimal project config.
[options]
lite_mode = 0          # 0 = all agents, 2 = default lean set, 4 = single agent
locale    = "en"       # UI language: en, zh-CN, ja

[options.tui]
theme     = "catppuccin"
dark_mode = true
compact_mode = false

Provider Setup

# Use an API key (supports $ENV_VAR expansion).
[providers.anthropic]
api_key = "$ANTHROPIC_API_KEY"

# Use OAuth (set via `codg auth`).
[providers.openai]
oauth = true

# Custom / self-hosted provider.
[providers.local]
name     = "My Local LLM"
type     = "openai-compat"
base_url = "http://localhost:8080/v1"
api_key  = "not-needed"

Agent Customization

# Shorthand: assign a model type.
agents.coder = "large"
agents.task  = "small"

# Full form: fine-tune an agent.
[agents.advisor]
model           = "large"
temperature     = 0.3
thinking_budget = 32000

MCP Servers

# HTTP MCP server.
[mcp.websearch]
type = "http"
url  = "https://mcp.exa.ai/mcp?tools=web_search_exa"

Skills

# Auto load and download in TUI or codg skill
[option]
skill_urls = ["https://github.com/user/skills"]

Local Models (llama.cpp)

[llama]
port     = 8090
host     = "127.0.0.1"
ctx_size = 32000
gpu      = "auto"          # auto, cuda, off

Messaging Channels

[channels.telegram]
enabled     = true
token       = "$TELEGRAM_BOT_TOKEN"
allowed_ids = ["123456789"]

[channels.discord]
enabled  = true
token    = "$DISCORD_BOT_TOKEN"

Permissions

[permissions]
allowed_tools = ["bash", "edit", "view", "glob", "grep"]
allowed_dirs = ["**x"] # all directories