Command Finder

List the actions a launcher can offer, and your own actions

tuios actions [flags]

List your actions, or show one

tuios actions list [NAME] [flags]

Run an action in the session's client

tuios actions run NAME [-w PANE] [--dry-run] [flags]

Report a harness hook event as the pane's agent state

tuios agent-hook <harness> [event] [payload] [flags]

Show what the agent in a pane has been doing

tuios agent-log [flags]

Run an agent headless over a structured protocol, as a pane

tuios agent-proto --protocol acp|codex -- <agent> [args...] [flags]

Feed a harness's status line to the pane's agent metadata

tuios agent-statusline <harness> [flags]

Ask another agent a question and wait for its answer

tuios ask-agent <text> [flags]

Ask the person a question and print their answer

tuios ask-human <question> -o <answer> [-o <answer>...] [flags]

Attach to a TUIOS session

tuios attach [session-name] [flags]

Send one verb to the daemon and print its reply as JSON

tuios call <verb> [params] [flags]

Capture the content of a pane

tuios capture-pane [window] [flags]

List, read and restore the checkpoints of an agent's turns

tuios checkpoint

Show what one turn changed

tuios checkpoint diff [N] [flags]

List the checkpoints of a pane, oldest first

tuios checkpoint list [flags]

Put a pane's work tree back to a checkpoint

tuios checkpoint restore N [flags]

Clear the scrollback of a pane

tuios clear-history [flags]

Close one pane

tuios close-window <window> [flags]

Close every pane on a workspace

tuios close-workspace [workspace] [flags]

Generate the autocompletion script for the specified shell

tuios completion

Generate the autocompletion script for bash

tuios completion bash

Generate the autocompletion script for fish

tuios completion fish [flags]

Generate the autocompletion script for powershell

tuios completion powershell [flags]

Generate the autocompletion script for zsh

tuios completion zsh [flags]

Manage TUIOS configuration

tuios config

Apply config.toml to the running daemon and clients now

tuios config apply

Search the settable options and set one, in an explorer

tuios config browse [flags]

Edit configuration in $EDITOR

tuios config edit

List the files the config is read from

tuios config files [flags]

Show which config file sets each key

tuios config origin [key] [flags]

Print configuration file path

tuios config path

Remove the keys of config.toml that have their default value

tuios config prune [flags]

Reset configuration to defaults

tuios config reset

Copy files and folders between this machine and its hosts

tuios cp SRC... DST [flags]

Run the TUIOS daemon in the foreground

tuios daemon [flags]

Start the daemon when you log in, or at boot on Linux

tuios daemon install-service [flags]

Show the daemon service and whether the daemon runs under it

tuios daemon service-status [flags]

Remove the daemon service

tuios daemon uninstall-service

Upgrade the running daemon to a new binary without ending any pane's program

tuios daemon upgrade [flags]

Run the daemon as a macOS app, so panes keep local network access

tuios daemon-app

Write and sign the TUIOS Daemon app

tuios daemon-app install [flags]

Show the TUIOS Daemon app, its login item, and how new daemons start

tuios daemon-app status

Remove the TUIOS Daemon app and its login item

tuios daemon-app uninstall [flags]

Hand a task to a child agent and get its answer back by mail

tuios delegate [flags] '<task>' [-- args...]

Delete a paste buffer

tuios delete-buffer [flags]

Detach clients from their sessions

tuios detach-client [flags]

Print the display of a session as export lines

tuios display-env [flags]

Check that parts of tuios are set up and working

tuios doctor

Report, per harness, whether its integration is installed and current

tuios doctor agents [flags]

Check that tuios can keep this machine awake

tuios doctor keep-awake

Report which panes' shells mark their commands, for tuios run

tuios doctor shell [flags]

Show what the agent detector sees in a pane

tuios explain-agent-detect [flags]

Show what a harness's screen rules make of a pane

tuios explain-agent-screen [flags]

Fan a prompt out across several agents, each in its own worktree

tuios fan <count> <prompt> [flags]

Compare the attempts of a fan-out side by side

tuios fan compare [[<host>:]<session>] [flags]

Show what one attempt of a fan-out did differently from another

tuios fan diff <session-a> <session-b> [flags]

Keep one session of a fan-out and remove the others

tuios fan keep <session> [flags]

Record a judge's pick among the attempts of a fan-out

tuios fan verdict <session> [flags]

Run one check in every attempt of a fan-out

tuios fan verify <session> -- <command>... [flags]

Move the focus to a pane

tuios focus-window [window] [flags]

Read a pane's reported agent state

tuios get-agent-state [flags]

Read a configuration option from a running TUIOS session

tuios get-config <path> [flags]

Get detailed info about a window

tuios get-window [id-or-name] [flags]

Help about any command

tuios help [command] [flags]

List the machines in the [hosts] config table and the state of each link

tuios hosts [flags]

Add a machine to the [hosts] config table

tuios hosts add <name> <addr> [flags]

Remove a machine from the [hosts] config table

tuios hosts remove <name>

Set up a machine: test ssh, install tuios, start it and add it

tuios hosts setup [DEST] [NAME] [flags]

Open the Tailscale sign-in page of each host that waits for one

tuios hosts signin [name] [flags]

Install the tuios version of this machine on the hosts in the [hosts] table

tuios hosts sync [host...] [flags]

List the machines on your tailnet and which are offered as addresses

tuios hosts tailnet [flags]

Open one link to a host and report what happened

tuios hosts test <name> [flags]

Convert a terminal colour scheme into a tuios theme

tuios import-theme <file> [flags]

Wire coding-agent harnesses' hooks to tuios agent state

tuios integration

Write tuios's hook entries into a harness's configuration

tuios integration install [harness...] [flags]

Say whether each harness's integration is installed and current

tuios integration status [harness...] [flags]

Remove the hook entries tuios wrote, and nothing else

tuios integration uninstall [harness...] [flags]

Keep the machine awake while agents work

tuios keep-awake [off|on|agents] [flags]

List, check and change keybindings

tuios keybinds

Search the keybindings in an explorer

tuios keybinds browse [search]

Show what a keybind preset keeps, moves and does not have

tuios keybinds cheatsheet [preset] [flags]

Report keybinding conflicts

tuios keybinds doctor [flags]

Say what tuios does with one key

tuios keybinds explain <key> [flags]

Hand a key back to the program in the pane

tuios keybinds free <key>

List every keybinding and the action it runs

tuios keybinds list [flags]

List the keybindings that differ from the defaults

tuios keybinds list-custom

Show or set the keybind preset: tuios, or the keys of tmux

tuios keybinds preset [name]

Take a key off one action

tuios keybinds unbind <action> [key]

Stop the TUIOS daemon

tuios kill-server [flags]

Kill a TUIOS session

tuios kill-session <session-name>

Manage layout templates

tuios layout

Delete a layout template

tuios layout delete <name>

Print layout templates directory path

tuios layout dir

Export a layout template as a tape script

tuios layout export <name>

List saved layout templates

tuios layout list [flags]

Load a layout into the workspace a session shows

tuios layout load <name> [flags]

Save the workspace a session shows as a layout

tuios layout save <name> [flags]

List the agent panes in a session and what each is doing

tuios list-agents [flags]

List what is waiting for you in every session: the Inbox

tuios list-attention [flags]

List the paste buffers, newest first

tuios list-buffers [flags]

List daemon client connections

tuios list-clients [flags]

List the dock's components and what each one last did

tuios list-dock-components [flags]

List the glyph sets, and describe one

tuios list-glyphs [set] [flags]

List the hooks and what each one last did

tuios list-hooks [flags]

List every settable configuration option

tuios list-options [prefix] [flags]

List the themes, and describe one

tuios list-themes [theme] [flags]

List the control-protocol verbs the daemon supports

tuios list-verbs [verb] [flags]

List all windows in the session

tuios list-windows [flags]

List the workspaces in a session

tuios list-workspaces [flags]

View daemon logs

tuios logs [flags]

Apply, show, export, share and remove a look

tuios look

Apply a look from the gallery, an https URL or a file

tuios look apply <source> [flags]

Print your look as a look file

tuios look export [flags]

List the keys a look can set

tuios look keys [flags]

List the looks in the tuios.dev gallery

tuios look list [flags]

Choose a look from the tuios.dev gallery and apply it

tuios look pick [flags]

Remove the look and the theme it installed

tuios look remove [flags]

Share your look in the setups discussion on GitHub

tuios look share [flags]

Show the look in use

tuios look show

List TUIOS sessions

tuios ls [flags]

Serve tuios to an agent harness as an MCP server over stdio

tuios mcp [flags]

Draw Mermaid diagrams in the terminal or to a file

tuios mermaid FILE [flags]

Move a window to another workspace or session

tuios move-window [workspace] [flags]

Create a new TUIOS session

tuios new [session-name] [flags]

Open a new window in a session

tuios new-window [name] [command...] [flags]

Set, read or clear the return note of a session or a pane

tuios note

Remove the note

tuios note clear [flags]

Print the note

tuios note get [flags]

Set the note

tuios note set TEXT... [flags]

Push notifications for the Inbox

tuios notify

Register, list and remove the phones that get Web Push

tuios notify push

List the registered phones and the VAPID public key

tuios notify push ls [flags]

Register a phone's push subscription

tuios notify push register [flags]

Remove a registered phone

tuios notify push rm <device> [flags]

Send a test notification through each provider

tuios notify test [flags]

Show a QR code that adds this machine to a phone

tuios pair [flags]

Show what this pane may do through tuios

tuios pane-grants [flags]

Show one pane in this terminal, with no tuios around it

tuios pane-view [flags]

Paste a paste buffer into a pane

tuios paste-buffer [flags]

Show the prompt an agent is blocked on, and how it may be answered

tuios peek-prompt [flags]

Pin a pane as the picture-in-picture view

tuios pip [window] [flags]

Set or clear a dock cell, from a plugin

tuios plugin-cell

Remove a cell

tuios plugin-cell clear ID

Set the text of a cell

tuios plugin-cell set ID TEXT [flags]

Show the person a notification, from a plugin

tuios plugin-notify TEXT [flags]

Install, list and run plugins

tuios plugins

Allow a tuios plugin to run on this machine, or deny it

tuios plugins approve ID [flags]

Run a plugin's build commands

tuios plugins build ID

Read a plugin folder as tuios would and say what is wrong

tuios plugins check [PATH]

Run a plugin folder and reload it when a file changes

tuios plugins dev PATH

Stop running a plugin

tuios plugins disable ID

Run a plugin: its startup, actions, panes and event hooks

tuios plugins enable ID

Show what a plugin contains and what tuios runs of it

tuios plugins info ID [flags]

Install, build and enable a plugin from git or a folder

tuios plugins install [SOURCE] [flags]

Add a plugin folder to [plugins] dirs

tuios plugins link DIR [flags]

List the plugins tuios finds

tuios plugins list [flags]

Show the last runs of plugin commands and their output

tuios plugins log [ID] [flags]

Make a plugin folder that works, with a manifest, a script, a README and CI

tuios plugins new NAME [flags]

Open a pane of an enabled plugin

tuios plugins open ID PANE [flags]

Run an action of an enabled plugin

tuios plugins run ID ACTION [flags]

Show what each plugin costs: processes, memory and runs

tuios plugins stats [flags]

Disable and remove a plugin that tuios plugins install installed

tuios plugins uninstall ID [flags]

Remove a linked plugin folder, disable the plugin and close its panes

tuios plugins unlink ID

Update installed plugins to the newest commit

tuios plugins update [ID...] [flags]

Run a command in a floating pane that closes when it exits

tuios popup -- <command> [args...] [flags]

Queue a message for an agent, typed when it comes to rest

tuios queue [flags] TEXT...

List the messages waiting for agents

tuios queue ls [flags]

Drop queued messages before they are typed

tuios queue rm [ID | --all] [flags]

Read the messages agents have left in this session

tuios read-agent-messages [flags]

Run a dock component again now

tuios refresh-dock [component] [flags]

Rename a session

tuios rename-session [session] <new-name> [flags]

Move a border of a pane

tuios resize-window <left|right|up|down> [percent] [flags]

Answer the prompt an agent is blocked on

tuios respond <action> [value] [flags]

Restart the TUIOS daemon with the newest tuios installed

tuios restart-server [flags]

Resume the agent conversation a pane ran before a daemon restart

tuios resume-agent [flags]

Restore a previously saved session

tuios resurrect [session-name] [flags]

Read what an agent changed, and leave it notes

tuios review [SESSION] [flags]

Leave a review note on a line of a pane's changes

tuios review note FILE:LINE TEXT... [flags]

List the review notes on a pane's changes

tuios review notes [flags]

Send the unsent review notes to the pane's agent

tuios review send [flags]

Run a command at a pane's shell prompt and exit with its status

tuios run -- <command line> [flags]

Execute a tape command in a running TUIOS session

tuios run-command <command> [args...] [flags]

Render a window to an image file

tuios screenshot [flags]

Show a workspace

tuios select-workspace <workspace> [flags]

Leave a message for another agent, or post a notice to the session

tuios send-agent-message <text> [flags]

Send keys (arrows, page keys, ctrl+c) to a window

tuios send-keys <keys> [flags]

Write text verbatim to a pane

tuios send-text <text> [flags]

Get current session information

tuios session-info [flags]

Record display metadata about a pane's agent

tuios set-agent-meta [key=value ...] [flags]

Keep a pane's finished turns and questions out of the Inbox

tuios set-agent-quiet [flags]

Record which conversation a pane's agent runs, without changing its state

tuios set-agent-session <agent-session-id> [flags]

Report a pane's agent state to the running TUIOS session

tuios set-agent-state <state> [flags]

Store text in a paste buffer

tuios set-buffer [text] [flags]

Set a configuration option in a running TUIOS session

tuios set-config <path> <value> [flags]

Turn tiling on or off, tidy the splits, and shape the master-stack layout

tuios set-layout [flags]

Give a pane grants, or the default back

tuios set-pane-grants [flags]

Set a session's accent

tuios set-session-accent [accent] [flags]

Set a session's display name

tuios set-session-name [name] [flags]

Put the sessions in an order every client lists

tuios set-session-order <session>...

File a session under a space

tuios set-session-space [space] [flags]

Rename a window or minimize it

tuios set-window [flags]

Name a workspace

tuios set-workspace-name <workspace> [name] [flags]

Commit, merge, push and open a pull request for a pane's worktree

tuios ship

Commit every change in a pane's work tree on its branch

tuios ship commit [flags]

Merge a worktree's branch into its base in the main checkout

tuios ship merge [flags]

Push a pane's branch and open a pull request with gh

tuios ship pr [flags]

Push a pane's branch to its remote

tuios ship push [flags]

Show the pull request of a pane's branch and its checks

tuios ship status [flags]

Print the text of a paste buffer

tuios show-buffer [flags]

Divide a pane and open a new one beside it

tuios split-window <left|right|up|down|horizontal|vertical> [command...] [flags]

Run TUIOS as SSH server

tuios ssh [flags]

Print the ssh agent link of a session

tuios ssh-agent-path [flags]

Start an agent in a new pane and return once it is ready

tuios start-agent [agent] [-- args...] [flags]

Store files for the session, so another agent can read them later

tuios stash

Copy a stashed file out of the session store, across a link

tuios stash get <stored-path> [file] [flags]

List the files in the session store

tuios stash list [flags]

Copy a file into the session store and print the stored path

tuios stash put <file> [flags]

Report what a program is doing with OSC 7501

tuios status [idle|working|done|blocked|error] [flags]

Print the daemon's event stream as JSON lines or readable lines

tuios subscribe [flags]

Swap two panes in the layout

tuios swap-window <other> [flags]

Switch an attached client to another session

tuios switch-session [HOST:]NAME [flags]

Manage and run .tape automation scripts

tuios tape

Delete a tape recording

tuios tape delete <name>

Show the tape recordings directory path

tuios tape dir

Execute a tape file in a running session

tuios tape exec <file.tape> [flags]

List all saved tape recordings

tuios tape list [flags]

Run a tape file in interactive mode

tuios tape play <file.tape> [flags]

Display the contents of a tape file

tuios tape show <name>

Validate a tape file without running it

tuios tape validate <file.tape>

Hand out work as task cards that panes claim and finish

tuios task

Add a task card

tuios task add [-p PROMPT] [--stage S] [--project URL] [--harness ID] [--machine M] [--ask-first] TITLE... [flags]

Put files or a link on a task card

tuios task attach ID [FILE... | --link URL | --screenshot -w PANE | --capture -w PANE] [--name N] [--note TEXT] [--replace] [flags]

Read one attachment of a task card

tuios task attachment

Save one attachment of a task card to a file

tuios task attachment get ID NAME -o FILE [flags]

List the files and links on a task card

tuios task attachments ID [flags]

Mark a task card stuck, or lift the mark

tuios task block ID [REASON...] [--clear] [flags]

Take a task card for a pane

tuios task claim [ID | --next] [-w PANE] [flags]

Take a file or a link off a task card

tuios task detach ID NAME [flags]

Show or change how task cards go to agents

tuios task dispatch [status | pause | resume | mode manual|pull|auto | preset | cap N | quiet SPAN|off | verify COMMAND|off] [flags]

Mark a task card done

tuios task done ID [flags]

Show one task card whole

tuios task get ID [flags]

List the task cards

tuios task ls [flags]

Let a task card go without finishing it

tuios task release ID [flags]

Remove a task card

tuios task rm ID [flags]

Move a task card to a stage

tuios task stage ID STAGE [flags]

Work with theme files

tuios theme

Print a theme as a theme file

tuios theme export <theme> [flags]

Read the theme and glyph files again in every client

tuios theme reload [flags]

Print a theme as one line to paste in a message

tuios theme share <theme>

Show TML documents: dashboards, results and forms

tuios tml

Close a TML surface

tuios tml close SURFACE [VALUE] [flags]

Print a TML surface: its document, state and version

tuios tml get SURFACE

List the open TML surfaces of a session

tuios tml list [flags]

Change a TML surface's state with a JSON Patch

tuios tml patch SURFACE OPS

Print a TML document drawn as text

tuios tml render FILE [flags]

Swap a TML surface's document

tuios tml replace SURFACE FILE [flags]

Show a TML document as a popup or a pane

tuios tml show FILE [flags]

Check a TML document

tuios tml validate FILE

Answer a tmux command in tuios (the tmux shim)

tuios tmux [tmux arguments]

Run a command that drives tmux against this tuios session instead

tuios tmux-shim [-- command [args...]] [flags]

List the copies the daemon runs, and pause, resume, cancel or wait for them

tuios transfers [flags]

Cancel copies and remove the part of the file in flight

tuios transfers cancel ID... [flags]

Remove the copies that ended from the list

tuios transfers clear [ID...] [flags]

Delete the copies that o in the rail made of files on other machines

tuios transfers clear-opened

Pause copies. What they copied stays

tuios transfers pause ID... [flags]

Go on with paused copies, try waiting ones now, or try failed ones again

tuios transfers resume ID... [flags]

Wait for copies to end, and exit as tuios cp does

tuios transfers wait [ID...] [flags]

Learn tuios in a few minutes, by doing it

tuios tutor [track] [flags]

Install the newest release over this binary

tuios update [flags]

Block until a condition matches

tuios wait-for <condition> [flags]

Show the pane, session and daemon this command runs in, as they are now

tuios whoami [flags]

Work in git worktrees, one session per worktree

tuios worktree

Show what a worktree session changed

tuios worktree diff <session> [flags]

List worktree sessions

tuios worktree ls [flags]

Create a worktree and a session in it

tuios worktree new <branch> [flags]

Bring a worktree session's work from another machine into a worktree here

tuios worktree pull <host:session> [flags]

Remove a worktree and kill its session

tuios worktree rm <session> [flags]

Open one pane per item in a new workspace, with multifocus on

tuios xpanes [flags] [items...]

Zoom a pane to fill its workspace, or end the zoom

tuios zoom-window [flags]