deciduous: Command for Claude Code

Context Recovery

RUN THIS AT SESSION START. The decision graph is your persistent memory.

Step 1: Query the Graph

# The graph lives on the server; refresh this machine's cache first
deciduous remote pull
deciduous remote status

# See all decisions (look for recent ones and pending status)
deciduous nodes

# Filter by current branch (useful for feature work)
deciduous nodes --branch $(git rev-parse --abbrev-ref HEAD)

# See how decisions connect
deciduous edges

# What commands were recently run?
deciduous commands

# Check for attached documents
deciduous doc list

Branch-scoped context: If working on a feature branch, filter nodes to see only decisions relevant to this branch. Main branch nodes are tagged with [branch: main].

Step 1.5: Audit Graph Integrity

CRITICAL: Check that all nodes are logically connected.

# Find nodes with no incoming edges (potential missing connections)
deciduous edges | cut -d'>' -f2 | cut -d' ' -f2 | sort -u > /tmp/has_parent.txt
deciduous nodes | tail -n+3 | awk '{print $1}' | while read id; do
  grep -q "^$id$" /tmp/has_parent.txt || echo "CHECK: $id"
done

Review each flagged node (flow: goal -> options -> decision -> actions -> outcomes):

• Root goal nodes are VALID without parents
• option nodes MUST link to their parent goal
• decision nodes MUST link from the option(s) being chosen
• action nodes MUST link to their parent decision
• outcome nodes MUST link back to their action

Fix missing connections:

deciduous link <parent_id> <child_id> -r "Retroactive connection - <reason>"

Step 1.6: Import Sessions the Graph Does Not Have

A session that logged little still left a transcript. Import what is missing before reading the graph, so the graph is complete when you read it.

deciduous transcript list                 # "new" = not yet imported
deciduous transcript import <session-id>  # goals, actions, outcomes, each with its evidence

Derived nodes say in metadata.evidence.kind whether they are proven (a tool call and its result) or inferred (the assistant's own words). Trust the proven ones.