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
skillManage Claude Code skills
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