Files and settings
ket follows the XDG layout, so every path below moves if you set the matching XDG_ variable.
Configuration
Section titled “Configuration”In ~/.config/ket/ (or $XDG_CONFIG_HOME/ket/):
| File | What it holds |
|---|---|
config.toml |
Agents, provisioning, hooks, theme, merge behaviour, packs and more. A missing file means defaults. |
snippets.toml |
Snippets for the quick prompt and the row menu’s Send snippet. |
themes/<name>.toml |
Your own colour themes. |
If config.toml doesn’t parse, the app starts with defaults.
Per repository
Section titled “Per repository”A .ket.toml at the root of a repository applies to that project only:
- Its
[provision]section replaces the global one for that repository. See Provisioning. - Its hooks run before your global hooks, but only when the project’s Automation setting is on. Turn it on in Project Settings or with
ket project set <project> --automation trust. Until then ket also skips the file’spost_command.
In ~/.local/share/ket/ (or $XDG_DATA_HOME/ket/):
| Path | What it holds |
|---|---|
worktrees/ |
Every worktree ket creates. |
state.json |
ket’s saved state. |
usage.json |
The usage history behind the savings figures. |
events.jsonl |
An event log. |
host/ |
The background process that keeps terminals running. |
ket also keeps shell wrappers and fetched packs in ~/.cache/ket/.
The Settings window
Section titled “The Settings window”⌘, opens Settings, starting on Agents. The other sections are Economy, Snippets and Merge, then General, Appearance, Editor, Terminal, Keybindings and Devices.
Appearance sets Dark, Light or System, and the theme. ket ships 14: Desk (the default), Acid, Acqua, Coral, Dracula, Gruvbox, Kanagawa, Monokai, ms-dos, One Dark, Punk, Solarized Dark, Tokyo Night and Light.
Environment variables
Section titled “Environment variables”| Variable | Effect |
|---|---|
KET_LOG |
Log level for troubleshooting. |
KET_HOST=0 |
Close terminals when ket quits, instead of keeping them running. |
KET_RELAY_URL |
For development only: connect phones through an external relay instead of the one ket runs on your Mac. |