ns-flow-gt-autobranch

Creates a Graphite branch from dirty worktree changes via the ns flow CLI.

2|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/nseng-ai/ns --skill ns-flow-gt-autobranch-nseng-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ns-flow-gt-autobranch
Source: https://github.com/nseng-ai/ns/tree/main/skills/incubating/flow/ns-flow-gt-autobranch
Command: npx skills add https://github.com/nseng-ai/ns --skill ns-flow-gt-autobranch-nseng-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Moving uncommitted, dirty worktree changes onto a new Graphite branch normally requires manual stashing, branch creation, and stash restoration, which is error-prone and disrupts stacked-diff workflows. ## Core Features & Use Cases - Automated dirty-worktree branching: Delegates to ns flow gt autobranch, which stashes pending tracked and untracked changes, creates a Graphite branch with gt create, restores the stash, and creates a checkpoint commit. - Optional branch naming: Accepts an explicit branch slug via --slug <slug> for predictable branch names. - Safe failure handling: Surfaces CLI output and stops on failure, recovering only after an explicit user decision. - Use Case: You have half-finished changes in your working tree and realize they belong on their own stacked branch; invoke this skill to move them onto a new Graphite branch without losing work. ## Quick Start Ask the agent to move my current uncommitted changes onto a new Graphite branch using ns flow gt autobranch.

Frequently Asked Questions about ns-flow-gt-autobranch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I move uncommitted changes to a new Graphite branch?

Run ns flow gt autobranch, which stashes your pending tracked and untracked changes, creates a Graphite branch with gt create, restores the stash, and creates a checkpoint commit. Pass --slug <slug> to set an explicit branch name.

When should I use autobranch instead of branch-latest-commit?

Use autobranch when your worktree has dirty, uncommitted changes that need their own branch. For splitting a clean latest commit instead, use ns flow gt branch-latest-commit, which handles committed work rather than pending changes.

Does ns flow gt autobranch work with untracked files?

Yes, the underlying Flow CLI stashes both pending tracked and untracked changes before creating the Graphite branch, then restores the stash so no files are lost during the operation.

What happens if ns flow gt autobranch fails?

The skill surfaces the CLI's failure output and stops immediately. It does not attempt automatic recovery; any recovery action happens only after you explicitly choose how to proceed.

Does autobranch modify my Git or Graphite state?

Yes, this operation mutates repository state: it may create branches, stashes, and a checkpoint commit. It should only be invoked when you explicitly ask to branch pending worktree changes.