Skip to content

stackit

Overview

getstackit/stackit

CLI¶

Complete command-line reference for stackit.

Quick links¶

Command Reference

Complete documentation for all stackit commands.

View reference →
Configuration

Customize stackit behavior with configuration options.

Configure stackit →
Git Hooks

Prevent commits and pushes to locked branches.

Setup hooks →

Command categories¶

Move around your stack efficiently.

stackit log - Display the branch tree
stackit checkout - Interactive branch switcher
stackit up / stackit down - Move between parent/child branches
stackit top / stackit bottom - Jump to extremes
stackit trunk - Return to main branch

Branch management¶

Create, modify, and organize branches.

stackit create - Create a new branch
stackit modify - Amend the current commit
stackit absorb - Intelligently amend changes
stackit delete - Delete a branch
stackit rename - Rename a branch

Stack operations¶

Manage your entire stack.

stackit submit - Create/update PRs
stackit sync - Update from trunk
stackit merge - Merge your stack
stackit restack - Rebase all branches
stackit flatten - Optimize stack structure

Worktrees¶

Work on multiple stacks simultaneously.

stackit create -w - Create branch with worktree
stackit worktree create - Create a standalone worktree
stackit worktree list - List all worktrees
stackit worktree open - Open worktree (auto-cd with shell integration)

Git hooks¶

Enforce branch restrictions locally.

stackit precommit install - Prevent commits to locked branches
stackit prepush install - Prevent pushes to locked branches

See Git Hooks for details.

Global flags¶

Available on all commands:

Flag	Description
`--cwd <path>`	Working directory for operations
`--debug`	Write debug output to terminal
`--interactive`	Enable interactive features (default: true)
`--no-interactive`	Disable all interactive features
`--verify`	Enable git hooks (default: true)
`--no-verify`	Disable git hooks
`--quiet`, `-q`	Minimize output (implies `--no-interactive`)

Next steps¶