Skip to main content
The list-actions command displays all available keybind actions that can be assigned to key combinations in Ghostty.

​
Usage

ghostty +list-actions [options]

​
Description

This command lists all keybind actions available in Ghostty. These are the actions you can assign to keys in your configuration file using the keybind option.
These keybind actions are distinct from CLI actions (like +list-fonts, +show-config, etc.). To see CLI actions, use ghostty +help.

​
Options

​
--docs
boolean
Print documentation for each action, including a description of what the action does and any parameters it accepts.
​
-h, --help
flag
Display help information for this command.

​
Examples

​
List All Actions

ghostty +list-actions

cancel
clear_screen
close_all_windows
close_surface
close_tab
close_window
copy_to_clipboard
decrease_font_size
goto_split:...
goto_tab:...
ignore
increase_font_size
inspector:...
jump_to_prompt:...
new_split:...
new_tab
new_window
next_split
next_tab
open_config
open_url
paste_from_clipboard
paste_from_selection
previous_split
previous_tab
quit
reload_config
reset_font_size
resize_split:...
scroll_page_down
scroll_page_up
scroll_to_bottom
scroll_to_top
select_all
size_limit_disable
size_limit_enable
text_action:...
toggle_fullscreen
toggle_split_zoom
toggle_tab_overview
toggle_visibility
write_screen_file:...
write_scrollback_file:...

​
List Actions with Documentation

ghostty +list-actions --docs

cancel
  Cancel the current operation, such as closing a search or dismissing
  a dialog.

clear_screen
  Clear the terminal screen. The scrollback is preserved.

close_surface
  Close the current surface (terminal). If this is the last surface,
  the window will be closed.

copy_to_clipboard
  Copy the current selection to the system clipboard.

goto_tab:<n>
  Go to tab number <n>. Tabs are numbered starting from 1.
  
  Example: goto_tab:3

new_split:right
  Create a new split to the right of the current split.
  
  Arguments:
    - right: Split to the right
    - left: Split to the left
    - down: Split below
    - up: Split above
...

​
Search for Specific Actions

ghostty +list-actions | grep "split"

goto_split:...
new_split:...
next_split
previous_split
resize_split:...
toggle_split_zoom

​
Find Actions with Parameters

ghostty +list-actions | grep ":"
Lists only actions that accept parameters (indicated by :...).

​
Common Actions

Here are some commonly used actions:

​
Window & Tab Management

  • new_window - Open a new window
  • new_tab - Open a new tab
  • close_surface - Close current terminal
  • close_tab - Close current tab
  • close_window - Close current window
  • quit - Quit Ghostty
  • goto_tab:N - Go to tab number N
  • next_tab / previous_tab - Navigate between tabs
  • next_split / previous_split - Navigate between splits
  • jump_to_prompt:N - Jump to Nth prompt (requires shell integration)

​
Clipboard

  • copy_to_clipboard - Copy selection to clipboard
  • paste_from_clipboard - Paste from clipboard
  • paste_from_selection - Paste from selection (X11)

​
Display

  • increase_font_size / decrease_font_size - Adjust font size
  • reset_font_size - Reset font size to default
  • toggle_fullscreen - Toggle fullscreen mode
  • clear_screen - Clear the screen

​
Splits

  • new_split:right|left|up|down - Create new split
  • resize_split:direction,amount - Resize split
  • toggle_split_zoom - Zoom/unzoom current split

​
Configuration

  • reload_config - Reload configuration file
  • open_config - Open config in editor

​
Using Actions in Config

To use these actions in your configuration:
keybind Syntax
keybind = <key_combination>=<action>

​
Examples

Example Config
# Simple actions
keybind = ctrl+shift+c=copy_to_clipboard
keybind = ctrl+shift+v=paste_from_clipboard

# Actions with parameters
keybind = ctrl+1=goto_tab:1
keybind = ctrl+2=goto_tab:2
keybind = super+right=new_split:right
keybind = super+down=new_split:down

# Chained actions
keybind = ctrl+shift+t=new_tab,goto_tab:1

​
Notes

Actions marked with :... require parameters. Use --docs to see what parameters each action accepts.
Some actions may only work on certain platforms or require specific features to be enabled (like shell integration).

​
See Also