Skip to content

CLI

All configuration options can also be set via CLI flags. Flags override the config file.

attyx [command | flags]
CommandDescription
daemonRun the session daemon in the foreground
kill-daemonKill the session daemon and remove its socket
loginAuthenticate with Attyx AI services
deviceShow device and account info
uninstallRemove config, auth tokens, and desktop entry

Commands are used without --. For example: attyx kill-daemon.

FlagDescription
--rows <N>Terminal rows (default: 24)
--cols <N>Terminal columns (default: 80)
--cmd <command...>Override shell command
-d, --working-directory <path>Set initial working directory
FlagDescription
--config <path>Load config from a specific file
--no-configSkip reading config file from disk
--print-configPrint merged config and exit
FlagDescription
--font-family <string>Font family
--font-size <int>Font size in points
--cell-width <value>Cell width: pixels (e.g. 10) or percent (e.g. "110%")
--cell-height <value>Cell height: pixels (e.g. 20) or percent (e.g. "115%")
FlagDescription
--theme <string>Theme name
--background-opacity <float>Background opacity 0.0–1.0
--background-blur <int>Blur radius when opacity < 1
--decorations / --no-decorationsShow/hide window title bar
--padding <int>Window padding on all sides
--padding-x <int>Left + right padding
--padding-y <int>Top + bottom padding
--padding-left <int>Left padding
--padding-right <int>Right padding
--padding-top <int>Top padding
--padding-bottom <int>Bottom padding
FlagDescription
--cursor-shape <shape>block, beam, or underline
--cursor-blink / --no-cursor-blinkEnable/disable cursor blinking
--cursor-trail / --no-cursor-trailEnable/disable cursor trail
FlagDescription
--shell <path>Shell program
--scrollback-lines <int>Scrollback buffer lines
--reflow / --no-reflowEnable/disable reflow on resize
--log-level <level>err, warn, info, debug, trace
--log-file <path>Append logs to file
FlagDescription
--help, -hShow help
ShortcutAction
Ctrl+Shift+RReload config
Cmd+, / Ctrl+,Open config file
Cmd+F / Ctrl+FOpen in-terminal search
Cmd+Shift+P / Ctrl+Shift+PCommand palette
Ctrl+Shift+SpaceVisual mode (copy mode)
Cmd+K / Ctrl+Shift+KClear screen and scrollback
Ctrl+Shift+NNew session
Ctrl+Shift+SSession picker
Cmd+T / Ctrl+Shift+TNew tab
Cmd+W / Ctrl+Shift+WClose tab
Ctrl+TabNext tab
Ctrl+Shift+TabPrevious tab
Cmd+D / Ctrl+Shift+DSplit vertically
Cmd+Shift+D / Ctrl+Shift+ESplit horizontally
Cmd+= / Ctrl+=Increase font size
Cmd+- / Ctrl+-Decrease font size
Cmd+0 / Ctrl+0Reset font size