Initializing in Your Project

Navigate to your project directory and run deciduous init:

$ cd my-project
$ deciduous init
Created .deciduous/deciduous.db (SQLite database)
Created .deciduous/config.toml (configuration)
Created .claude/commands/context.md (Claude slash command)
Created .claude/commands/decision.md (Claude slash command)
Created docs/ (web viewer, deployable to GitHub Pages)
Created CLAUDE.md (project instructions)
Added .deciduous/deciduous.db to .gitignore

Deciduous initialized! Next steps:
  1. Run 'deciduous serve' to start the web viewer
  2. Use 'deciduous add goal "Your goal" -c 90' to create nodes
  3. Tell Claude to use /context at session start

What Got Created

The Database is Local

Notice that .deciduous/deciduous.db was added to .gitignore. This is intentional.

This means:

• Your decision graph is local to your machine
• It won't cause merge conflicts
• Team members share decisions via exportable patches

Claude Code Integration

The .claude/commands/ directory contains slash commands that Claude Code will recognize:

• /context — Recover context from the decision graph at session start
• /decision — Manage the decision graph (add nodes, link, etc.)

The CLAUDE.md file contains instructions that Claude will follow, including the decision logging workflow. When you start a Claude Code session in this project, it will know how to use deciduous.

Web Viewer Setup

The docs/ directory contains a static web viewer. You have two options for viewing it:

Option 1: Local Server (Development)

$ deciduous serve
Starting graph viewer at http://localhost:3000
Auto-refresh enabled (30 second interval)
Press Ctrl+C to stop

This serves the graph with live updates as you add nodes.

Option 2: GitHub Pages (Sharing)

The docs/ folder is ready to deploy to GitHub Pages:

1. Push your repo to GitHub
2. Go to Settings > Pages
3. Set source to Deploy from a branch
4. Select the gh-pages branch (or main + /docs folder)

Before deploying, run deciduous sync to export your graph to JSON.