Reference
The Guide is the how — how to run an agent, wire up a channel, build a document. This section is the what: a screen-by-screen tour of Codeg's Settings, how the app is built, how it treats your data, and how to build it from source. Reach for it when you're staring at a specific toggle and want to know exactly what it does.
Some of Codeg's settings screens are big enough to have their own how-to in the Guide — MCP, Skills, Agents. The rest are configuration you set once and forget. The map below covers all of them, so you can always find where a screen is documented, then jump to it.
The Settings surface
Codeg gathers every preference into one Settings window (its sidebar is headed Preferences). Here's the whole surface, in the order the app lists it, and where each screen is documented:
| Settings screen | What it controls | Documented in |
|---|---|---|
| Appearance | Theme mode & color, window zoom, fonts, desktop pet | Appearance |
| General | Default terminal, rendering, and the collaboration & feedback toggles | General |
| MCP | Model Context Protocol servers — add, scan, enable per agent | Guide → MCP Servers |
| Skills | Write and edit your own agent skills | Guide → Skills |
| Skill Packs | Curated bundles — Experts, Science, Office | Guide → Skills |
| Agents | The agent CLIs — connect, configure, run preflight | Guide → Working with Agents |
| Model Providers | API provider credentials for agents | Guide → Authentication & Models |
| Quick Messages | Reusable message snippets for the composer | Quick Messages |
| Shortcuts | Keyboard shortcuts | Shortcuts |
| Version Control | Git executable, GitHub and other Git accounts | Version Control |
| Chat Channels | IM bots for notifications and remote control | Guide → Chat Channels |
| Web Service | Expose Codeg to a browser — port, token, QR (desktop only) | Web Service |
| Runtime Logs | Diagnostic logs — level, live viewer, files | Runtime Logs |
| System | Updates, network proxy, language, backup & restore | System |
Opening Settings lands you on Appearance. Every screen is identical whether you run the desktop app or reach Codeg through a browser — with one exception: Web Service appears only in the desktop app, because it's the screen that turns on browser access in the first place.
Six screens have a full how-to in the Guide
MCP, Skills, Skill Packs, Agents, Model Providers, and Chat Channels are features you use, not just settings you tweak — so they're written up as task guides. The eight remaining screens are covered here, in reference form.
Architecture & Security
How Codeg is built, and how it handles what you give it.
- Architecture — one Rust core, three binaries: the
codegdesktop app, the standalonecodeg-server, and thecodeg-mcpcompanion that powers delegation. How the pieces fit, and how they drive external agent CLIs over ACP. - Privacy & Security — what stays on your machine, when the network is actually touched, and how agent credentials and web-service tokens are handled.
Contributing
- Development — requirements, the build commands for each binary, and the dev loop for building Codeg from source.
Everything here describes the app you actually run — desktop or server. For the project itself — the people behind Codeg, the community, and the license — see About.