This page lists the commands in workrex --help, in the same groups. For a
command’s full options, run workrex <command> --help. “Window” means a Rex tab within a session. A terminal pane is a Rex block. In session mode, which
is the default under Rex, each worktree gets a session instead.
Configuration lives in .workrex.yaml and the Workrex global directory.
See Configuration.
| Command | Description |
|---|
add | Create a worktree and its window |
remove | Remove a worktree, its window, and its branch without merging |
rename | Rename a worktree, its window or session, and its branch |
merge | Merge a branch, then remove its worktree and window |
rebase | Rebase a worktree branch onto its base branch |
open | Open a window for an existing worktree |
close | Close a worktree’s window and keep the worktree and branch |
resurrect | Restore worktree windows after a crash |
| Command | Description |
|---|
dashboard | Show a TUI dashboard of every active agent |
sidebar | Control the live agent status sidebar in Rex |
list | List all worktrees |
path | Print the filesystem path of a worktree |
status | Query agent status for worktrees |
| Command | Description |
|---|
init | Write an example .workrex.yaml |
setup | Set up agent status tracking hooks and install skills |
config | Edit, locate, or print the global configuration |
sandbox | Manage sandbox settings |
remote | Manage SSH remotes that run agents |
sync-files | Copy and symlink configured files into worktrees again |
claude | Claude Code commands, such as claude prune |
| Command | Description |
|---|
send | Send a prompt or instruction to a running agent |
capture | Capture terminal output from a running agent |
wait | Wait for agents to reach a target status |
run | Run a command in a worktree’s window |
reap-agents | Exit tracked agent processes older than a set age |
| Command | Description |
|---|
docs | Show the README in the terminal |
changelog | Show the changelog (what’s new in each version) |
update | Update workrex to the latest release |
completions | Print shell completions |
workrex --help does not list these commands.
| Command | Description |
|---|
last-done | Switch to the agent that finished or asked for input most recently |
last-agent | Switch to the last visited agent (toggle between two) |
shell | Open a shell in a remote workspace |
uninstall | Remove status hooks, skills, and workrex’s state and update cache |
