Skip to main content

First commands

Run rt with no arguments for an interactive menu. All commands below also support direct invocation:

rt <command> [subcommand] [args]
  • rt cd ... fuzzy worktree/repo directory picker.
  • rt nav ... filesystem navigator; ctrl-o opens the selected folder in your preferred editor.
  • rtcd ... a shell alias added by install that cds into a picked worktree (wraps rt cd).

Editor​

  • rt code ... open a worktree in your preferred editor. Detects installed editors and picks one; set a default with rt settings set rt.workspacePrefs '{"defaultEditor":"zed"}' --scope machine.

Non-web links (e.g. vscode://file/...) opened from the console webview are handed off to the OS rather than loaded in the browser.

Run​

  • rt run ... interactive script runner that walks repo, then worktree, then package, then script.

Status​

  • rt port ... port scanner and killer, daemon-powered and zero-config.

Sync​

  • rt sync ... rebase the current worktree onto master and push.
  • rt sync all ... sync every worktree in the repo.

Git​

  • rt git rebase ... smart rebase onto origin/master with auto-resolve.
  • rt git commit ... interactive staging and commit with a live diff preview.

For flags and full detail on any of these, follow the link to its reference page.