Command

See also: Configuration

Browse the full list of rimba commands below. Each command has its own page with synopsis, examples, common workflows, flags, and related commands.

Global Flags

These flags are available on every command:

Flag	Description
`--json`	Output in JSON format (supported by `list`, `status`, `deps status`, `conflict-check`, `exec`, `log`)
`--no-color`	Disable colored output (also respects `NO_COLOR` env var)
`--debug`	Log git commands and timings to stderr (also respects `RIMBA_DEBUG=1`)
`--yes`	Approve committed shell commands without prompting (see `rimba trust`; also respects `RIMBA_TRUST_YES=1`)

Setup

Initialize rimba config, worktree directory, and optional AI agent files

Worktree Lifecycle

Create a new worktree (supports monorepo scoping, PR checkout, branch promotion)

Remove a worktree and delete the local branch

Rename a worktree's task, branch, and directory

rimba duplicate

Create a new worktree from an existing one, inheriting its branch prefix

Archive a worktree (remove directory, keep branch)

Restore an archived worktree from its preserved branch

Inspection

List all worktrees with task, type, and status

Show a worktree dashboard with summary stats and age information

Show the most recent commit from each worktree

Open a worktree path or run a command inside it

Merging & Syncing

Merge a worktree's branch into main or another worktree

Sync worktree(s) with the main branch via rebase or merge

rimba merge-plan

Analyze file overlaps and recommend an optimal merge order

rimba conflict-check

Scan branches for files modified in multiple worktrees

Bulk Operations

Run a shell command in parallel across matching worktrees

Hooks

Manage Git hooks for worktree workflow automation

Dependencies

Detect, clone, and install worktree dependencies

AI Integration

Start an MCP server exposing rimba tools to AI coding agents

Maintenance

Prune stale references or remove merged/stale worktrees

Diagnose and remove stale git index.lock files left by killed worktree operations

Review and approve committed shell commands for this repo

Check for and install the latest rimba release

Print version, commit, build date, and platform info

rimba completion

Generate shell completion scripts

Table of contents