wk42worldworld/cybercode

CyberCode – A locally‑run, Claude‑style coding assistant

What it is – CyberCode is an open‑source AI‑agent platform built around the Claude Code interaction model. It runs entirely on your machine, can talk to any Anthropic‑compatible API (MiniMax, OpenRouter, etc.), and adds a suite of capabilities that go far beyond a simple chat:

Capability	What you get
Permanent memory & self‑evolution	The agent remembers past projects, extracts stable “skills” and lets you edit or delete that knowledge.
Multi‑modal UI	Full‑screen TUI (Ink), a cross‑platform desktop GUI (Tauri + React), and remote control via Telegram, Feishu (and Discord).
Computer Use	The agent can drive macOS or Windows GUIs, run terminal commands, edit files, and manage Git worktrees.
Model‑agnostic	Plug any Anthropic‑compatible endpoint, OpenAI‑compatible service, or local model. Model routing, health‑checks and automatic fallback to a local WebSearch are built‑in.
Context optimisation	Automatic token‑budget management (clean‑up, smart clipping, compression layers) with a transparent UI showing estimated savings.
Local code graph	Indexes symbols, imports, call relationships and lets the agent query this graph to give concise, relevant code context.
Scheduling & background tasks	One‑off or recurring jobs that run while you’re away, plus a “headless” --print mode for CI pipelines.
Extensible	Plugins, Skills, multi‑Agent orchestration, and an MCP server for custom tooling.

---

Quick start (CLI)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/wk42worldworld/cybercode/main/scripts/install-cli.ps1 | iex

The installer pulls the latest stable binary, installs Bun if needed, and adds a cybercode command to your PATH (no admin rights required).

Typical commands:

Command	Purpose
cybercode	Start an interactive session in the current project folder
cybercode "Explain this repo"	One‑shot task, then exit
cybercode -p "Fix failing test"	Headless mode, output JSON‑friendly result
cybercode -c	Continue the most recent session
cybercode -r	Pick and restore a saved session
cybercode --model <model>	Choose a specific model for this run
cybercode -w <feature‑name>	Create an isolated Git worktree for the session
cybercode plugin …	Manage plugins
cybercode doctor	Diagnose environment issues

---

Desktop application

Built with Tauri 2 + React. Download the appropriate installer from the Releases page (macOS Apple Silicon, macOS Intel, Windows x64, Linux x64). The GUI gives you:

• Project picker & multi‑session tabs
• Provider & model selector panels
• Code‑graph explorer (symbol search, architecture view, file indexing)
• Token‑optimisation dashboard
• Scheduled‑task manager
• Real‑time permission prompts for file edits or command execution

---

Remote control

Telegram and Feishu adapters let the same agent run headlessly on a server and be driven from a chat client. This is useful for long‑running refactors or CI‑style automation when you’re away from your workstation.

---

Extensibility

• Skills – reusable, user‑defined toolkits that the agent can invoke.
• Plugins – drop‑in packages that add new commands or UI panels.
• MCP server – expose the local agent as an OpenAI/Anthropic‑compatible endpoint (cc_… node key) for other tools to call.
• Agent Teams – orchestrate multiple sub‑agents to work in parallel.

---

Getting started with source

If you prefer to run from source (e.g., to develop the desktop UI):

# Install Bun (runtime & package manager)
curl -fsSL https://bun.sh/install | bash   # macOS/Linux
# or Homebrew: brew install bun
# Windows PowerShell: powershell -c "irm bun.sh/install.ps1 | iex"

bun install               # install deps
cp .env.example .env      # add your API keys
./bin/cybercode           # TUI mode
# or start the server + desktop UI for development
SERVER_PORT=3456 bun run src/server/index.ts
cd desktop && bun run dev --host 127.0.0.1 --port 2024

The docs (linked throughout the README) walk you through each feature, environment‑variable setup, and migration/portable‑USB workflow.

---

Who might use CyberCode?

• Solo developers who want an AI partner that remembers their codebase across sessions.
• Teams that need a self‑hosted, vendor‑agnostic assistant (no lock‑in to Anthropic).
• Researchers exploring memory, self‑evolution, or multi‑agent orchestration in a real coding workflow.
• Automation engineers looking to schedule code‑maintenance tasks or integrate AI into CI pipelines.

---

Where to find more

• Full documentation site: https://wk42worldworld.github.io/cybercode/
• Community QQ group (ID 463169230) for Chinese‑language support.
• Contribution guide, roadmap, and launch‑kit are all in the repo for newcomers.

---

Bottom line – CyberCode is a comprehensive, open‑source coding assistant that combines a Claude‑style chat interface with persistent memory, cross‑platform GUI, model‑agnostic back‑ends, and a rich extensibility layer, all runnable locally.