OneCode .NET

A production-grade AI coding assistant built on .NET 10, featuring a Terminal.Gui v2 full-screen TUI, a Blazor Server browser client that shares the same in-process event contract, the Microsoft Agent Framework (MAF) orchestration pipeline, and a Hyperlight sandbox.

Highlights

• Three working modes — BUILD / PLAN / GOAL, switchable with Tab
• 45 slash commands · 27 built-in tools — file ops, LSP, web, agents, cron, Git worktree, MCP
• Safety-first execution — 7 permission modes, command classifiers, hooks, editable transactions
• Cross-platform — self-contained single-file binaries for Windows / Linux / macOS (x64 + ARM64)

Install

Windows (PowerShell)

irm https://raw.githubusercontent.com/X2Agent/OneCode/main/scripts/install.ps1 | iex

Linux / macOS

curl -fsSL https://raw.githubusercontent.com/X2Agent/OneCode/main/scripts/install.sh | bash

Quick start

onecode                        # launch the interactive TUI (BUILD mode)
onecode --cwd /path/to/project # launch in a specific directory
onecode --version

Documentation

Full documentation is maintained in README_CN.md (Chinese) and the docs/ directory — commands reference, settings reference, skills guide, keybindings, ADRs, and design plans.

License

The contents of this repository are provided for technical research and educational purposes only. See README_CN.md for the full disclaimer.