Commands
dub log
Visualize your stack as an ASCII tree, tree-aware with current-path highlighting and PR/CI annotations.
Usage
dub log
dub ls
dub l
# Show only current stack
dub log --stack
# Show all stacks explicitly
dub log --all
# Reverse branch ordering for quick top-down scan
dub log --reverse
# Return structured JSON
dub log --jsonFlags
| Flag | Description |
|---|---|
--stack | Show only current stack |
--all | Show all stacks explicitly |
--reverse | Reverse branch ordering |
--json | Output the stack tree as JSON |
Aliases: dub ls, dub l
Tree-shaped stacks
dub log renders the full tracked tree, not just a linear chain. On
tree-shaped stacks:
- The current branch's ancestor path is shown in bold.
- Sibling sub-trees are dimmed so the focus stays on the current path.
- The current branch is highlighted in bright cyan.
- Frozen branches (see
dub freeze) are marked so it's clear whyrestack/sync/post-mergeskipped them. - PR/CI/commit annotations come from a 30-second cached batch
gh pr list, so re-runningdub logis cheap.
Example Output
A typical linear stack:
(main)
└─ feat/auth-types
└─ feat/auth-login
└─ feat/auth-tests ← you are hereA tree-shaped stack:
(main)
└─ feat/auth-types
├─ feat/auth-login ← you are here
│ └─ feat/auth-tests
└─ feat/auth-googleBranch Info
For detailed metadata about a specific branch:
# Current branch
dub info
# Current branch with parent-relative diff
dub info --diff
# Explicit branch
dub info feat/auth-login