otty / apps

All apps/kitty

kitty

kitty - the fast, feature-rich, cross-platform, GPU based terminal.

Runs as kitty, kitten|macOS, Linux|sw.kovidgoyal.net

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

kitty in your home directory Every rule on this page, by file

· ~/.config/kitty/ Sync

· ~/Library/Preferences/kitty/ Sync

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/kitty/otty.tomlThe file this page is generated from

id = "kitty"

name = "kitty"

homepage = "https://sw.kovidgoyal.net/kitty/"

description = "kitty - the fast, feature-rich, cross-platform, GPU based terminal."

icon = "https://sw.kovidgoyal.net/kitty/_static/kitty.svg"

executables = ["kitty", "kitten"]

platforms = ["macos", "linux"]

[dotfiles]

# https://sw.kovidgoyal.net/kitty/conf/ — "kitty looks for a config file in the

# OS config directories (usually ~/.config/kitty/kitty.conf) but you can pass a

# specific path via the kitty --config option or use the KITTY_CONFIG_DIRECTORY

# environment variable". kitty/launcher/utils.h, get_config_dir(): after

# KITTY_CONFIG_DIRECTORY it tries $XDG_CONFIG_HOME, then ~/.config, and on

# Apple builds ~/Library/Preferences as well, taking the first whose

# <dir>/kitty/kitty.conf exists. That first search is [configHome] — the XDG

# variable when it is set and ~/.config otherwise, on macOS as well as Linux —

# and the Apple-only fallback is [preferences]. The directory also holds the

# other files kitty reads from the same place — ssh.conf, open-actions.conf,

# diff.conf and session files — so it is listed whole.

paths = ["[configHome]/kitty/", "[preferences]/kitty/"]

# kitty keeps its caches under KITTY_CACHE_DIRECTORY, ~/Library/Caches/kitty on

# macOS and $XDG_CACHE_HOME/kitty elsewhere, so the config directory has nothing

# to carve out.

# Nothing kitty writes here is a credential. ssh.conf names hosts and kittens,

# not keys.

secret = []

# No machine_lines: a kitty.conf is fonts, colours, keymaps and layouts, which

# is what the user wants carried. `shell` and `editor` can name an absolute

# path, but they are just as often a bare command, so a rule on them would

# strip a preference as often as it caught a machine detail.

[commands]

format = 1

label = "Launch kitty"

description = "Open a kitty window with title, directory, config and start options. Remote control and kittens are left out."

quality = "ai-draft"

base = "fig:kitty"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/kitty.ts"

license = "MIT"

[[commands.field]]

id = "title"

label = "Window title"

type = "string"

option = ["-T", "--title"]

sources = ["fig"]

[[commands.field]]

id = "directory"

label = "Working directory"

type = "path"

option = ["-d", "--directory", "--working-directory"]

path = { kind = "directory", role = "input" }

sources = ["fig"]

[[commands.field]]

id = "config"

label = "Config file"

type = "path"

option = ["-C", "--config"]

path = { kind = "file", role = "input" }

sources = ["fig"]

[[commands.field]]

id = "session"

label = "Session file"

type = "path"

option = ["--session"]

path = { kind = "file", role = "input" }

sources = ["fig"]

[[commands.field]]

id = "start_as"

label = "Start as"

type = "string"

option = ["--start-as"]

suggestions = [{ value = "normal", label = "Normal" }, { value = "fullscreen", label = "Fullscreen" }, { value = "maximized", label = "Maximized" }, { value = "minimized", label = "Minimized" }]

sources = ["fig"]

[[commands.field]]

id = "hold"

label = "Stay open after exit"

type = "boolean"

option = ["--hold"]

sources = ["fig"]

[[commands.field]]

id = "single_instance"

label = "Single instance"

type = "boolean"

option = ["-1", "--single-instance"]

sources = ["fig"]

[[commands.field]]

id = "command"

label = "Program and arguments"

type = "string"

position = 0

multiple = true

sources = ["fig"]

[[commands.task]]

id = "run"

label = "Run a program"

set = { hold = [true] }

fields = ["command", "directory", "title", "hold"]

required = ["command"]

[[commands.group]]

id = "basic"

label = "Basic"

fields = ["title", "directory", "command", "hold"]

[[commands.group]]

id = "advanced"

label = "Advanced"

fields = ["config", "session", "start_as", "single_instance"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/kitty. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.