Configuration
Where the app keeps its settings, layout and secrets, and what each Settings page configures.
Settings are persistent preferences: appearance, window material and tint, fonts, terminals, the editor and integrations. Open them with Cmd+, on macOS or Ctrl+, on Windows and Linux. Settings take the whole window, with their own sidebar and a way back.
The config folder
The app's files live in its config folder, the first of these that applies:
$XDG_CONFIG_HOME/krad-ade, whenXDG_CONFIG_HOMEis set;~/.config/krad-ade, whenHOMEis set;%APPDATA%\krad-ade.
~/.config/krad-ade| Entry | What it holds |
|---|---|
settings.json | Your settings |
layout.json | Environments, groups, sessions, panes, tabs, the work mode and toolchain choices |
themes/ | Themes you made, as JSON |
gateway-sessions/ | One session file per Gateway chat |
chat-images/ | Images pasted into chats |
arcade.json | Each Arcade game's best score |
install-id | A random id created once per installation, used to keep files apart on remote hosts |
extensions/ | Extensions added from a git address |
manifests/ | Language and server runtime manifests of your own |
Secrets
Logins and keys are kept in the system keyring: the GitLab and GitHub logins, the Gateway key and MCP server secrets. Without a keyring, as under WSL without Secret Service, they go in the config folder, readable only by you.
Settings pages
| Page | What it configures |
|---|---|
| General | Light, dark or system appearance, app updates, code tools for agents, performance mode |
| Appearance | Light and dark themes, the window material and tint, the interface font |
| Terminal | The font, copy and paste, and the colours of terminals |
| Editor | How files look, how they show their problems, and the minimap |
| Integrations | The GitLab and GitHub sign-ins that Review reads from |
| Gateway | The Gateway address, key and models |
| MCP | MCP servers for Gateway chats, and the folders whose .mcp.json you trusted or ignored |
| Languages | Server runtimes, extensions and the Java engine |
Integrations at a glance
| Integration | Configured through |
|---|---|
| GitLab | Host and OAuth application id in Settings › Integrations |
| GitHub | Device sign-in in Settings › Integrations |
| Gateway | Address, key and models in Settings › Gateway |
| MCP servers | Settings › MCP, or a project's .mcp.json you trust once per folder |
| Language servers | Settings › Languages |
What goes into your repository
The app writes into a group's repository only for notes: the vault in docs/notes/ and its Docs sources in docs/notes/sources.toml. Toolchain choices, layouts and settings stay in the config folder.
On a remote host
Files the app needs on a remote host live under ~/.krad-ade on that host, separated by app version and installation.