# Gt Nav

> Visualize your Graphite stack and navigate between its branches. Use when user says "show my stack", "where am I in the stack", "go up/down a branch", or "checkout the top of the stack". Not for restacking, syncing, or cleanup — use the gt-sync or gt-cleanup skill.

- Skill: `kinginyellows/gt-nav` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kinginyellows/gt-nav`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kinginyellows/gt-nav/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: kinginyellows (https://skillmd.com/u/kinginyellows)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kinginyellows/gt-nav

---


## What It Does

Visualizes your current Graphite stack and lets you navigate between
branches — jump to the top or bottom, move up/down, or check out a
specific branch by name. Optionally shows PR status for each branch in
the stack.

## When to Use

- User says "show my stack", "where am I in the stack", "go up/down a
  branch", or "checkout the top of the stack".
- Not for restacking, syncing, or cleanup — use the `gt-sync` or
  `gt-cleanup` skills instead.

## Usage

Optional arguments:

- `--pr` — Also show PR status for each branch
- `--top` — Jump directly to the top of the stack
- `--bottom` — Jump directly to the bottom of the stack

The argument text provided after the skill name (if any) is available as
context for this invocation.

### Phase 1: Visualize Stack

#### 1. Show Full Stack

```bash
gt log
```

#### 2. Show Current Position

```bash
echo "Current branch: $(git branch --show-current)"
```

#### 3. Show PR Status (if `--pr` is provided)

```bash
gt pr
```

#### 4. Handle Direct Navigation Arguments

If `--top` was passed:

```bash
gt top
echo "Jumped to top: $(git branch --show-current)"
gt log short
```

Then show the stack and exit.

If `--bottom` was passed:

```bash
gt bottom
gt log short
```

Then show the stack and exit.

### Phase 2: Interactive Navigation

If no direct navigation argument was given, present options using
AskUserQuestion. (`AskUserQuestion` is a Claude Code tool — on Codex, present
the same options as a numbered list in your reply and wait for the user's
answer; this applies to every AskUserQuestion mention in this skill.)

Ask: "Where do you want to go?"

Options:

- **Go up** — Move to the child branch (`gt up`)
- **Go down** — Move to the parent branch (`gt down`)
- **Jump to top** — Move to the top of the stack (`gt top`)
- **Jump to bottom** — Move to the bottom of the stack (`gt bottom`)

The user can also type a specific branch name via the "Other" option.

#### Execute Navigation

Based on the user's choice:

**Go up:**

```bash
gt up
```

**Go down:**

```bash
gt down
```

**Jump to top:**

```bash
gt top
```

**Jump to bottom:**

```bash
gt bottom
```

**Specific branch (from "Other" input):**

```bash
gt checkout -- "<branch-name>"
```

#### Show New Position

After navigating:

```bash
echo "Now on: $(git branch --show-current)"
gt log short
```

### Success Criteria

- Stack is clearly visualized with current position highlighted
- PR status shown for context
- User can navigate up/down/top/bottom or to a specific branch
- New position confirmed after navigation