Config Commands

Manage TUIOS configuration, keybindings, and shell completion

tuios config edit

Edit configuration in your default editor.

tuios config edit

Open the TUIOS configuration file in your default editor. The editor is determined by checking $EDITOR, $VISUAL, or common editors like vim, vi, nano, and emacs in that order.

Examples

Edit Config

# Open config in default editor
tuios config edit

The configuration file is in TOML format. Changes take effect the next time you start TUIOS.

---

tuios config path

Print configuration file path.

tuios config path

Print the path to the TUIOS configuration file.

Examples

Show Path

# Display config file location
tuios config path

Example Output

/home/user/.config/tuios/config.toml

---

tuios config reset

Reset configuration to defaults.

tuios config reset

Reset the TUIOS configuration file to default settings. This will overwrite your existing configuration after confirmation.

Examples

Reset Config

# Reset to default configuration
tuios config reset

This will permanently overwrite your existing configuration. Make sure to back up your config file before resetting if you want to preserve custom settings.

Before resetting, save a backup:

cp $(tuios config path) ~/tuios-config-backup.toml
tuios config reset

---

tuios keybinds list

List all keybindings.

tuios keybinds list

Display all configured keybindings in a formatted table.

Aliases

• tuios keys list
• tuios kb list

Examples

List All Keybindings

# Display all keybindings
tuios keybinds list
tuios keys list
tuios kb list

Example Output

KEY BINDING          ACTION                    MODE                      DESCRIPTION
ctrl+b               PrefixKey                 WindowManagement          Activate prefix mode
ctrl+b,n             NewWindow                 WindowManagement          Create new window
ctrl+b,q             Quit                      WindowManagement          Quit TUIOS
i                    EnterTerminalMode         WindowManagement          Enter terminal mode
Escape               EnterWindowMgmtMode       Terminal                  Enter window management mode
alt+1                SwitchWorkspace1          WindowManagement/Terminal Switch to workspace 1
alt+2                SwitchWorkspace2          WindowManagement/Terminal Switch to workspace 2
t                    ToggleTiling              WindowManagement          Toggle tiling mode
...

---

tuios keybinds list-custom

List customized keybindings.

tuios keybinds list-custom

Display only keybindings that differ from defaults. Shows a comparison of default and custom keybindings.

Aliases

• tuios keys list-custom
• tuios kb list-custom

Examples

List Custom Keybindings

# Show only customized keybindings
tuios keybinds list-custom
tuios keys list-custom
tuios kb list-custom

Example Output

CUSTOMIZED KEYBINDINGS

ACTION               DEFAULT KEY          CUSTOM KEY
NewWindow            ctrl+b,n             ctrl+t
CloseWindow          ctrl+b,x             ctrl+w
ToggleTiling         t                    ctrl+b,t

No other customizations found.

Use this command to quickly see which keybindings you’ve customized in your config file.

---

tuios completion

Generate shell completion scripts.

tuios completion <shell>

Generate the autocompletion script for TUIOS for the specified shell.

Supported Shells

• bash
• zsh
• fish
• powershell

Examples

Bash

# Generate bash completion
tuios completion bash > /usr/local/etc/bash_completion.d/tuios

# Or for user install
tuios completion bash > ~/.local/share/bash-completion/completions/tuios

# Source in current shell
source <(tuios completion bash)

Bash Installation (Detailed)

1. Generate completion script

   tuios completion bash > /tmp/tuios-completion.bash
   
2. Install system-wide (requires sudo)

   sudo cp /tmp/tuios-completion.bash /usr/local/etc/bash_completion.d/tuios
   
3. Or install for current user

   mkdir -p ~/.local/share/bash-completion/completions
   cp /tmp/tuios-completion.bash ~/.local/share/bash-completion/completions/tuios
   
4. Reload shell

   source ~/.bashrc
   # Or open a new terminal
   

Zsh Installation (Detailed)

1. Find completion directory

   echo $fpath[1]
   # Usually /usr/local/share/zsh/site-functions or ~/.zsh/completions
   
2. Generate and install completion

   tuios completion zsh > "${fpath[1]}/_tuios"
   
3. Rebuild completion cache

   rm -f ~/.zcompdump
   compinit
   
4. Or add to .zshrc for automatic loading

   echo 'autoload -Uz compinit && compinit' >> ~/.zshrc
   echo 'source <(tuios completion zsh)' >> ~/.zshrc
   source ~/.zshrc
   

After installing shell completion, you can press Tab to autocomplete TUIOS commands, flags, and arguments:

tuios <Tab>          # Shows all available commands
tuios tape <Tab>     # Shows tape subcommands
tuios --<Tab>        # Shows all flags

---

Configuration File Reference

For detailed information about all configuration options, see:

• Configuration Guide - Complete TOML configuration reference
• Keybindings Reference - All available actions and default keybindings
• Themes - Color theme configuration