░█▀█░█▀▀░█▀▀░
░█▀█░█░░░█▀▀░
░▀░▀░▀▀▀░▀▀▀░

English | 中文

A terminal-based AI coding agent built with C++17. It provides an interactive TUI (Terminal UI) powered by FTXUI, supporting tool-use workflows through OpenAI-compatible APIs or GitHub Copilot.

Features

• Interactive TUI -- FTXUI-based terminal interface with streaming responses, input history, and mouse support
• Agent Loop -- Multi-turn conversation with automatic tool calling and user confirmation
• Dual Provider
  • OpenAI-compatible -- Connect to any API that implements the OpenAI chat completions interface (local LLMs, cloud endpoints)
  • GitHub Copilot -- Device-flow OAuth authentication with token persistence
• Built-in Tools
  • Bash -- Execute shell commands
  • FileRead / FileWrite / FileEdit -- Read, create, and patch files
  • Grep -- Regex search across files
  • Glob -- Find files by glob pattern
• Cross-platform -- Windows and Linux/macOS support

Prerequisites

• CMake >= 3.20
• C++17 compiler (MSVC 2019+, GCC 9+, Clang 10+)
• vcpkg with the following packages installed:
  • cpr -- HTTP client
  • ftxui -- Terminal UI
  • nlohmann-json -- JSON library

Build

# Configure (adjust toolchain path as needed)
cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=<vcpkg-root>/scripts/buildsystems/vcpkg.cmake

# Build
cmake --build build --config Release

The executable will be output to build/Release/acecode (or build/Debug/acecode for Debug builds).

Configuration

Config file location: ~/.acecode/config.json (created automatically on first run).

{
  "provider": "copilot",
  "openai": {
    "base_url": "http://localhost:1234/v1",
    "api_key": "your-api-key",
    "model": "local-model"
  },
  "copilot": {
    "model": "gpt-4o"
  }
}

Field	Description
provider	"copilot" or "openai"
openai.base_url	API endpoint URL
openai.api_key	API key for the endpoint
openai.model	Model name to request
copilot.model	Copilot model name (default gpt-4o)

Usage

./build/Release/acecode

License

MIT