Advanced Topics

Power features for getting the most out of deciduous.

Branch-Based Grouping

Nodes are automatically tagged with the current git branch. This enables filtering by feature/PR.

Configuration

Configure which branches are "main" (not feature branches) in .deciduous/config.toml:

[branch]
main_branches = ["main", "master", "develop"]
auto_detect = true

Filtering by Branch

$ deciduous nodes --branch feature/auth
$ deciduous nodes -b main

Override Auto-Detection

# Force a specific branch
$ deciduous add goal "Feature work" -b feature-x

# Skip branch tagging entirely
$ deciduous add goal "Universal note" --no-branch

In the web UI, use the branch dropdown in the stats bar to filter all views.

Linking Commits to Decisions

Link nodes to git commits for traceability:

$ git commit -m "feat: add OAuth login"
$ deciduous add action "Implemented OAuth login" -c 90 --commit HEAD
Created node #53: action "Implemented OAuth login" [commit: abc123]

The --commit HEAD flag captures the current commit hash. You can also specify a specific hash:

$ deciduous add outcome "Feature deployed" -c 95 --commit abc123def456

In the TUI, press O to view commit details for a node with a linked commit.

Confidence Scores

Confidence scores (0-100) indicate certainty at decision time:

Confidence is displayed color-coded in the TUI and web viewer:

• Green: 90+
• Yellow: 70-89
• Red: Below 70

Capturing User Prompts

Use --prompt / -p to capture the user request that triggered a decision:

$ deciduous add goal "Add dark mode" -c 90 \
    -p "User asked: can we add a dark mode toggle to settings?"

When to Capture Prompts

Prompts are displayed in:

• TUI detail panel (under "Prompt" section)
• Web viewer node details
• deciduous writeup output

Associating Files

Link nodes to specific files:

$ deciduous add action "Implementing auth middleware" -c 85 \
    -f "src/auth/middleware.rs,src/auth/mod.rs"

In the TUI, press o to open associated files in your $EDITOR.