Skip to content

Files and settings

ket follows the XDG layout, so every path below moves if you set the matching XDG_ variable.

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.

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’s post_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/.

⌘, 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.

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.