Subcommands69 subcommands
otty open
Launch a new Otty window
otty config
Manage configuration
otty config show
Show the normalized config file contents
otty config path
Print the config file path
otty config get
Get one config key
otty config set
Set one config key
otty config unset
Remove one or more keys from the config file
otty config edit
Open the config file in $EDITOR
otty config validate
Validate the config file
otty config reload
Reload config in the running app
otty font
List available fonts
otty font list
List available fonts
otty font apply
Apply a font family by writing it to user config
otty theme
List available color themes
otty theme list
List available color themes
otty keybind
List keybindings
otty keybind list
List keybindings
otty window
Manage windows (requires running app)
otty window show
Show one window
otty window list
List all windows
otty window new
Create a new window
otty window close
Close a window
otty window focus
Focus a window
otty window rename
Set a window title
otty tab
Manage tabs (requires running app)
otty tab show
Show one tab
otty tab new
Create a new tab
otty tab close
Close a tab
otty tab focus
Focus a tab
otty tab rename
Rename a tab
otty tab badge
Set or clear the tab's status badge
otty pane
Manage panes (requires running app)
otty pane show
Show one pane
otty pane split
Split a pane
otty pane close
Close a pane
otty pane focus
Focus a pane
otty pane zoom
Toggle zoom on a pane
otty pane resize
Resize a pane
otty pane send-keys
Send keys to a pane
otty pane capture
Capture pane text
otty pane badge
Set or clear the badge on the pane's tab
otty view
Open a file or URL inside an Otty pane, read-only by default
otty edit
Open a file inside an Otty pane in edit mode
otty watch
Run a command with progress badge (spinning → finish/error badge)
otty features
Try terminal feature samples (colors, emoji, OSC sequences, images, …)
otty features list
List all available feature demos
otty features try
Run one feature's demo sample
otty ipc
Send a raw IPC command (used by hooks and integrations)
otty version
Show version information
otty jump
Jump to a frecency-ranked directory (requires running app)
otty jump add
Add a directory to the jump database (omit path = CLI cwd)
otty jump remove
Delete a directory from the jump database (omit path = CLI cwd)
otty jump view
Show the top match for a keyword/path and its frecency score
otty jump ls
List the highest-scoring directories (default 100)
otty jump import
Import frecency entries from a local zoxide install
otty learn
Record a directory visit in the frecency database
otty ignore
Black-list a directory: remove from frecency + sync zoxide remove
otty import
Import data from external tools into Otty's databases / config
otty import zoxide
Import frecency entries from a local zoxide install
otty import ghostty
Import a Ghostty config (~/.config/ghostty/config)
otty import kitty
Import a Kitty config (~/.config/kitty/kitty.conf)
otty import alacritty
Import an Alacritty config (~/.config/alacritty/alacritty.toml)
otty export
Export the current Otty config to another terminal's format
otty export ghostty
Generate a Ghostty-format config from the current Otty config
otty export kitty
Generate a Kitty-format kitty.conf from the current Otty config
otty export alacritty
Generate an Alacritty-format alacritty.toml from the current Otty config
OptionsOn otty itself
--format
Output format <format>
--json
Shortcut for --format json
--no-headers
Suppress table headers in text list output
-q--quiet
Suppress non-essential success output
--socket
Override runtime control socket path <path>
--config-file
Override config file path <path>
--timeout
IPC timeout in milliseconds <ms>
-y--yes
Skip destructive-action confirmation prompts
-e
Run a command in a new window (xterm-style; consumes all remaining args) <cmd>
