otty / dotfiles

All tools/Otty

Otty

otty

A native, beautiful terminal app.

Detected by otty | macOS, Linux, Windows |otty.sh

Sync it otty.toml

Sync rules

What travels, what stays, what never leaves

Synced9 paths, copied whole to your other machines

~/.config/otty/config.toml

~/.config/otty/themes/directory

~/.config/otty/recipes/directory

~/.config/otty/profiles/directory

~/.config/otty/views/directory

~/.config/otty/ssh_config

~/.config/otty/auto-approve-rules.md

~/.config/otty/auto-approve-provider.json

~/.config/otty/fonts/directory

Stays on this machineInside a file that otherwise syncs

~/.config/otty/config.tomllines starting with open-with-app , open-with-app=, global-hotkey-open-window , global-hotkey-open-window=, global-hotkey-toggle-visibility , global-hotkey-toggle-visibility=, sidebar-width , sidebar-width=, details-panel-width , details-panel-width=, window-columns , window-columns=, macos-option-as-alt , macos-option-as-alt=, shell-integration-disabled-shells , shell-integration-disabled-shells=, command , command=

…

font-family = "JetBrains Mono"

font-size = 14

command = /opt/homebrew/bin/fishmachine-local

open-with-app = "Visual Studio Code"machine-local

open-with-app = "Sublime Merge"machine-local

global-hotkey-open-window = ctrl+shift+spacemachine-local

global-hotkey-toggle-visibility = ctrl+gravemachine-local

sidebar-width = 260machine-local

details-panel-width = 320machine-local

window-columns = 140machine-local

macos-option-as-alt = leftmachine-local

shell-integration-disabled-shells = ["nu"]machine-local

# Edited by hand, without the spaces. Otty's reader takes both spellings.

command=/bin/zshmachine-local

open-with-app="Xcode"machine-local

global-hotkey-open-window=cmd+shift+spacemachine-local

global-hotkey-toggle-visibility=cmd+gravemachine-local

sidebar-width=240machine-local

details-panel-width=300machine-local

window-columns=120machine-local

macos-option-as-alt=truemachine-local

shell-integration-disabled-shells=["nu", "xonsh"]machine-local

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

~/.config/otty/profiles/login-shell.tomltoml fields at

launch.shelllaunch.cwdlaunch.env

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

~/.config/otty/ssh_configlines starting with IdentityFile, ProxyCommand, ProxyJump, Include

Include ~/.ssh/otty.d/*machine-local

Host bastion

HostName bastion.example.com

User deploy

IdentityFile ~/.ssh/id_ed25519_workmachine-local

Host db

HostName 10.0.4.12

User postgres

ProxyJump bastionmachine-local

Host legacy

HostName legacy.internal.example.com

ProxyCommand ssh -W %h:%p bastionmachine-local

ServerAliveInterval 30

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded1 path, state rather than configuration — never uploaded

~/.config/otty/fonts/font-*.pngpattern

Not a subtraction from the paths above: this is everything else Otty writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

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

…

font-family = "JetBrains Mono"

font-size = 14

command = /opt/homebrew/bin/fishmachine-local

open-with-app = "Visual Studio Code"machine-local

open-with-app = "Sublime Merge"machine-local

global-hotkey-open-window = ctrl+shift+spacemachine-local

global-hotkey-toggle-visibility = ctrl+gravemachine-local

sidebar-width = 260machine-local

details-panel-width = 320machine-local

window-columns = 140machine-local

macos-option-as-alt = leftmachine-local

shell-integration-disabled-shells = ["nu"]machine-local

# Edited by hand, without the spaces. Otty's reader takes both spellings.

command=/bin/zshmachine-local

open-with-app="Xcode"machine-local

global-hotkey-open-window=cmd+shift+spacemachine-local

global-hotkey-toggle-visibility=cmd+gravemachine-local

sidebar-width=240machine-local

details-panel-width=300machine-local

window-columns=120machine-local

macos-option-as-alt=truemachine-local

shell-integration-disabled-shells=["nu", "xonsh"]machine-local

Each machine keeps its own copy of these.

· themes/ Sync

· recipes/ Sync

· profiles/ Sync

· views/ Sync

Include ~/.ssh/otty.d/*machine-local

Host bastion

HostName bastion.example.com

User deploy

IdentityFile ~/.ssh/id_ed25519_workmachine-local

Host db

HostName 10.0.4.12

User postgres

ProxyJump bastionmachine-local

Host legacy

HostName legacy.internal.example.com

ProxyCommand ssh -W %h:%p bastionmachine-local

ServerAliveInterval 30

Each machine keeps its own copy of these.

· auto-approve-rules.md Sync

· auto-approve-provider.json Sync

· font-*.png Exclude

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

apps/otty.tomlThe file this page is generated from

id = "otty"

name = "Otty"

homepage = "https://otty.sh"

description = "A native, beautiful terminal app."

# Otty's own mark, as otty.sh publishes it — the same file this site already

# serves as its favicon (web/src/otty-face.svg, copied from the Otty repo's

# packages/homepage-web/public/otty-face.svg).

icon = "https://otty.sh/otty-face.svg"

# `otty` is the command-line tool (`otty ssh …`, `otty jump …`). On macOS the

# bundle's executables are Otty.app/Contents/MacOS/Otty and otty-cli, on this

# machine.

detect = ["otty"]

# No `platforms`: Otty ships for macOS, Linux and Windows.

# https://doc.otty.sh/customization/config-file — "Where it is:

# ~/.config/otty/config.toml". The directory is Config::config_dir() in the

# Otty repo (packages/config/src/lib.rs): `~/.config/otty` "on every platform",

# with `~` resolved through %USERPROFILE% on Windows — "deliberately NOT

# %APPDATA%" — and $XDG_CONFIG_HOME never consulted. So these are literal `~/`

# paths. [configHome] would have followed $XDG_CONFIG_HOME on macOS and Linux

# and meant %APPDATA%\otty on Windows, and Otty opens neither.

# The list is the one Otty's own Data Sync carries (otty_scope.rs in

# packages/sync-dotfiles):

# config.toml — the settings, flat `key = value`

# themes/ — "drop custom .toml themes into ~/.config/otty/themes/"

# (https://doc.otty.sh/reference/configuration)

# recipes/ — saved recipes, <id>.ottyrecipe

# (views/recipe/store.rs in packages/app-linux-gpui)

# profiles/ — one launch profile per file, <id>.toml

# (packages/config/src/profile.rs)

# views/ — "names the view's folder under ~/.config/otty/views/"

# (https://doc.otty.sh/reference/configuration)

# ssh_config — Otty's own SSH hosts, read by `otty ssh`

# (packages/cli/src/commands/ssh.rs)

# auto-approve-rules.md, auto-approve-provider.json

# — Auto Approve's rules and provider choice

# (AutoApproveFileStorage.swift in packages/app-macos)

# fonts/ — fonts added through Settings

paths = [

"~/.config/otty/config.toml",

"~/.config/otty/themes/",

"~/.config/otty/recipes/",

"~/.config/otty/profiles/",

"~/.config/otty/views/",

"~/.config/otty/ssh_config",

"~/.config/otty/auto-approve-rules.md",

"~/.config/otty/auto-approve-provider.json",

"~/.config/otty/fonts/",

]

# fonts/font-*.png are the Settings panel's preview renders of each font —

# regenerated on demand, so not worth a byte of sync. Otty's own sync leaves

# them out for the same reason. Machine state (state.db, logs) lives in a

# separate directory, never under ~/.config/otty.

exclude = ["~/.config/otty/fonts/font-*.png"]

# Nothing here is a credential. auto-approve-provider.json is the one file that

# names an AI service, and it holds the provider, model and optional endpoint

# (AutoApproveProviderConfig in packages/app-macos) — no key.

secret = []

# https://doc.otty.sh/customization/config-file, "Reloading": "Saving the file

# applies the changes immediately to every open window — no restart, no

# signal. Otty watches the file and hot-reloads it."

side_effect = false

# self_sync stays at its default, false: Otty's Data Sync is a consumer of this

# catalog, not a second copy of these files kept somewhere else.

# The config.toml keys that describe this machine rather than the user's taste

# — the nine Otty's own sync holds back (MACHINE_KEYS in otty_scope.rs): apps

# installed here, hotkeys registered here, panel and window sizes for this

# display, what this keyboard's Option key does, which local shells skip

# integration, and the shell binary to launch.

# prefix, not key_path. config.toml is TOML's flat subset but not strict TOML:

# open-with-app repeats, one line per app, and a strict parser rejects the

# duplicate key. Otty matches the whole key, though, and a bare "command"

# prefix would also catch any longer key that starts with it. So each key is

# written twice — followed by a space, and followed directly by `=` — which is

# exactly the lines that set that key, since Otty's reader takes either

# spelling (https://doc.otty.sh/reference/config-file-format: "Whitespace

# around `=` is optional"). Otty also holds back its own

# `# key = value (reset to default)` markers for these keys; those are

# comments, so they are left out.

# No scope: Otty keeps these lines in a local overlay and never uploads them,

# which is `local`, the default.

[[machine_lines]]

file = "~/.config/otty/config.toml"

match = { prefix = [

"open-with-app ", "open-with-app=",

"global-hotkey-open-window ", "global-hotkey-open-window=",

"global-hotkey-toggle-visibility ", "global-hotkey-toggle-visibility=",

"sidebar-width ", "sidebar-width=",

"details-panel-width ", "details-panel-width=",

"window-columns ", "window-columns=",

"macos-option-as-alt ", "macos-option-as-alt=",

"shell-integration-disabled-shells ", "shell-integration-disabled-shells=",

"command ", "command=",

] }

# A launch profile's shell, working directory and environment are the user's

# own choices, but they name paths on this disk. Worth keeping so the user can

# see and restore them, not worth applying to a machine whose disk differs:

# backup, as Otty's own rule has it.

# Two departures from Otty's rule, both forced:

# - Otty names profiles/*.toml. A rule here names a literal file (the fixture

# check does not expand globs, and no entry uses one), so this is the profile

# Otty seeds on macOS and Linux, profiles/login-shell.toml

# (platform_seeds() in packages/config/src/profile.rs). Profiles the user

# adds, and the ones Windows seeds per discovered shell, are not reached.

# - The keys sit under `[launch]` in the file Otty writes (LaunchSection in the

# same file), so the paths are launch.shell, launch.cwd and launch.env.

[[machine_lines]]

file = "~/.config/otty/profiles/login-shell.toml"

match = { key_path = ["launch.shell", "launch.cwd", "launch.env"] }

scope = "backup"

# ssh_config(5) syntax. IdentityFile, ProxyCommand, ProxyJump and Include name

# keys, commands, hosts and files that exist on this machine. Keep them

# readable, never push them onto another host: backup, as Otty's own rule has

# it.

[[machine_lines]]

file = "~/.config/otty/ssh_config"

match = { prefix = ["IdentityFile", "ProxyCommand", "ProxyJump", "Include"] }

scope = "backup"

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/otty. 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. None of them splits open-with-app and open-with-app= for you — that part is Otty’s own sync, or a template you write by hand.