User Guide

This guide covers core concepts and troubleshooting for stackit. For practical usage patterns, see Workflows. For parallel development, see Worktrees.

Topics

• Core Concepts

  ---

  Learn about stacks, parents, children, and how stackit manages branch relationships.

  Learn concepts →

• Troubleshooting

  ---

  Solutions to common issues and error messages.

  Get help →

Quick Reference

Essential Commands

• stackit log - View your stack
• stackit create - Create a new branch
• stackit submit - Create/update PRs
• stackit sync - Update from trunk
• stackit merge - Merge your stack

Need Help Fast?

Run the doctor command to diagnose common issues:

stackit doctor

Or check the FAQ for frequently asked questions.

Related Sections

• Workflows → — Daily, advanced, and team collaboration patterns
• Worktrees → — Work on multiple stacks in parallel
• Integrations → — Claude Code, GitHub, git hooks, and shell