Documentation Index Fetch the complete documentation index at: https://mintlify.com/Gaurav-Gosain/tuios/llms.txt
Use this file to discover all available pages before exploring further.
tuios config edit
Edit configuration in your default editor.
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
With Custom Editor
# 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.
Print the path to the TUIOS configuration file.
Examples
Show Path
Open in Editor
Copy to Backup
# Display config file location
tuios config path
Example Output
/home/user/.config/tuios/config.toml
tuios config reset
Reset configuration to defaults.
Reset the TUIOS configuration file to default settings. This will overwrite your existing configuration after confirmation.
Examples
# 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.
Display all configured keybindings in a formatted table.
Aliases
tuios keys list
tuios kb list
Examples
List All Keybindings
Search Keybindings
Save to File
# 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
# 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.
Generate the autocompletion script for TUIOS for the specified shell.
Supported Shells
Examples
# 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)
Generate completion script
tuios completion bash > /tmp/tuios-completion.bash
Install system-wide (requires sudo)
sudo cp /tmp/tuios-completion.bash /usr/local/etc/bash_completion.d/tuios
Or install for current user
mkdir -p ~/.local/share/bash-completion/completions
cp /tmp/tuios-completion.bash ~/.local/share/bash-completion/completions/tuios
Reload shell
source ~/.bashrc
# Or open a new terminal
Zsh Installation (Detailed)
Find completion directory
echo $fpath [1]
# Usually /usr/local/share/zsh/site-functions or ~/.zsh/completions
Generate and install completion
tuios completion zsh > "${ fpath [1]}/_tuios"
Rebuild completion cache
rm -f ~/.zcompdump
compinit
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 < Ta b > # Shows all available commands
tuios tape < Ta b > # Shows tape subcommands
tuios -- < Tab > # Shows all flags
Configuration File Reference
For detailed information about all configuration options, see: