Viewing the Graph
Deciduous provides three interfaces for exploring your decision graph, each suited to different needs.
Three Ways to View
| Interface | Best For | Command |
|---|---|---|
| Terminal UI (TUI) | Keyboard-driven exploration, file jumping | deciduous tui |
| Web Viewer | Visual exploration, sharing, GitHub Pages | deciduous serve |
| CLI | Quick queries, scripting, piping | deciduous nodes, etc. |
When to Use Each
Use the TUI when:
- You're already in the terminal
- You want vim-style navigation
- You need to jump to files associated with nodes
- You want syntax-highlighted file previews
Use the Web Viewer when:
- You want visual graph representations
- You're sharing with others (GitHub Pages)
- You want to explore interactively with mouse
- You need multiple visualization modes
Use the CLI when:
- You need quick answers
- You're scripting or piping output
- Claude is querying the graph
- You want to filter by branch/type