AI Integration
Commands for connecting deciduous to AI assistants – MCP server, Claude Code hooks, and shell completions.
deciduous mcp
MCP (Model Context Protocol) server and setup. Running deciduous mcp with no subcommand starts the server (backward-compatible with deciduous mcp serve).
deciduous mcp serve
Start the MCP server on stdin/stdout. Exposes the full deciduous API as MCP tools for AI assistants.
# Server starts on stdin/stdout (no visible output -- communicates via JSON-RPC)
Configure in your MCP client:
{"command": "deciduous", "args": ["mcp", "serve"]}
deciduous mcp setup
Set up MCP configuration for Claude Code or Claude Desktop.
Subcommands:
deciduous mcp setup claude-code– Configure MCP for Claude Code (writes.claude/settings.local.json)deciduous mcp setup claude-desktop– Configure MCP for Claude Desktop (platform-specific config file)
| Flag | Description |
|---|---|
--print | Print the config JSON to stdout without writing anything |
Updated .claude/settings.local.json with MCP server config
MCP configured for Claude Code
$ deciduous mcp setup claude-desktop --print
{
"mcpServers": {
"deciduous": {
"command": "deciduous",
"args": ["mcp", "serve"]
}
}
}
deciduous hooks
Manage Claude Code hooks – pre-edit blocks, post-commit reminders, and other automation configured in .deciduous/config.toml.
deciduous hooks install
Install Claude Code hooks from config. Generates shell scripts in .claude/hooks/ and updates settings.json.
Created .claude/hooks/pre-edit.sh
Created .claude/hooks/post-commit.sh
Updated .claude/settings.json
Hooks installed
deciduous hooks status
Show status of configured and installed hooks.
Hooks:
pre-edit installed .claude/hooks/pre-edit.sh
post-commit installed .claude/hooks/post-commit.sh
deciduous hooks uninstall
Remove hooks and clear hook configuration from settings.
Removed .claude/hooks/
Cleared hooks from .claude/settings.json
Hooks uninstalled
deciduous integration
Show Claude Code integration status – which hooks, commands, and skills are installed and active.
Claude Code Integration Status
==============================
Commands:
/decision .claude/commands/decision.md
/recover .claude/commands/recover.md
/work .claude/commands/work.md
/build-test .claude/commands/build-test.md
/serve-ui .claude/commands/serve-ui.md
/sync-graph .claude/commands/sync-graph.md
/decision-graph .claude/commands/decision-graph.md
/sync .claude/commands/sync.md
/document .claude/commands/document.md
Skills:
/pulse .claude/skills/pulse.md
/narratives .claude/skills/narratives.md
/archaeology .claude/skills/archaeology.md
Hooks:
pre-edit .claude/hooks/pre-edit.sh
post-commit .claude/hooks/post-commit.sh
CLAUDE.md: present
Database: .deciduous/deciduous.db
Version: 0.15.0
deciduous completion <shell>
Generate shell completions for tab completion of commands and flags.
Supported shells: bash, zsh, fish, powershell, elvish
$ deciduous completion zsh > ~/.zfunc/_deciduous
# Bash (add to ~/.bashrc)
$ deciduous completion bash > /etc/bash_completion.d/deciduous
# Fish
$ deciduous completion fish > ~/.config/fish/completions/deciduous.fish