This tutorial was AI-generated and is being fleshed out. Content may be incomplete or change.

How to Read This Tutorial

This tutorial is structured progressively, with each section building on the previous ones.

Tutorial Structure

  1. Hello, World! gets you from zero to a working decision graph in about five minutes.
  2. Real-World Workflows shows how deciduous actually gets used with Claude Code, including realistic terminal sessions.
  3. Viewing the Graph covers the three ways to explore your decisions: TUI, web viewer, and CLI.
  4. Sharing with Others explains the multi-user sync system for teams.
  5. Advanced Topics covers branch grouping, commit linking, and other power features.
  6. Plumbing Reference documents every command in detail.

You can read straight through, or jump to the section you need. The Hello, World! section is recommended for everyone to establish the basics.

Conventions

Terminal Commands

Commands you type are shown with a $ prefix:

$ deciduous add goal "Add user authentication" -c 90
Created node #1: goal "Add user authentication"

Lines without the $ are output from the command.

Claude Code Sessions

When showing Claude Code sessions, I use a terminal-style box:

Claude Code Session
> Add a rate limiter to the API I'll add rate limiting to protect your API endpoints. Let me first log this goal to the decision graph. deciduous add goal "Add rate limiting" -c 90 Created node #47: goal "Add rate limiting" Now let me explore the options...

The > indicates your input to Claude. The rest is Claude's response and actions.

Screenshots

Screenshots are indicated with placeholders:

[SCREENSHOT: tui-timeline-view.png]
The TUI timeline view showing nodes filtered by branch

These placeholders mark where actual screenshots should be added.

Info Boxes

Note

Blue boxes contain additional information or context.

Warning

Yellow boxes indicate important warnings or gotchas.

Tip

Green boxes contain helpful tips and best practices.

Keyboard Shortcuts

Keyboard shortcuts are shown in boxes: j k Enter

Node Types

Node types are color-coded throughout:

Prerequisites

This tutorial assumes you:

No prior knowledge of decision graphs or graph databases is needed.

Getting Help

If you get stuck:

Let's get started! Hello, World! →