Claude Code Integration

Deciduous is built for Claude Code. When you run deciduous init, it creates everything Claude Code needs to log decisions automatically.

What Gets Created

Running deciduous init sets up the full integration:

Initializing deciduous
deciduous init Initialized deciduous in /Users/alice/projects/snowflex Created .deciduous/ Created .deciduous/config.toml Created CLAUDE.md (decision graph workflow) Created .claude/commands/ (10 commands) Created .claude/skills/ (3 skills) Created docs/ (web viewer)
File Purpose
CLAUDE.md Behavioral instructions—tells Claude when and how to log decisions
.claude/commands/ Slash commands like /decision, /work, /recover
.claude/skills/ Skills like /pulse, /narratives, /archaeology
.claude/hooks/ Pre-tool-use hooks that enforce logging before code edits

Updating Integration Files

When you upgrade deciduous, update the integration files to match:

Updating integration
deciduous update Updated integration files to v0.13.2: Updated CLAUDE.md (decision graph workflow section) Updated .claude/commands/ (10 commands) Updated .claude/skills/ (3 skills)
Check before updating

Run deciduous check-update to see if your integration files are out of date without making any changes. This compares the version in .deciduous/.version with the current binary version.

How It Works

The decision graph is stored in a SQLite database (.deciduous/deciduous.db) and operated through the deciduous CLI. Claude Code reads the behavioral instructions in CLAUDE.md and uses the slash commands and skills to interact with the graph as you work.

The CLI is the interface—Claude Code calls commands like deciduous add goal and deciduous link to build the graph. This means the graph is always consistent regardless of how Claude Code's behavior evolves.