This tutorial was AI-generated and is being fleshed out. Content may be incomplete or change.

Installing Deciduous

Deciduous is distributed as a Rust binary via crates.io.

Via Cargo

If you have Rust installed, run:

$ cargo install deciduous
    Updating crates.io index
  Downloaded deciduous v0.3.5
   Compiling deciduous v0.3.5
    Finished release [optimized] target(s) in 45.23s
  Installing ~/.cargo/bin/deciduous
   Installed package `deciduous v0.3.5`

Verify it's installed:

$ deciduous --version
deciduous 0.3.5

Don't Have Rust?

Install Rust first via rustup:

$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your terminal and run cargo install deciduous.

Optional: Graphviz

If you want to generate PNG visualizations of your decision graphs (for PRs, documentation, etc.), install graphviz:

# macOS
$ brew install graphviz

# Ubuntu/Debian
$ apt install graphviz

# Arch
$ pacman -S graphviz

This enables the --png flag on deciduous dot. If graphviz isn't installed, that flag will fail with a helpful error message.

Note

Graphviz is optional. All core deciduous functionality works without it. You only need it if you want to export graphs as PNG images.

Verify Installation

Let's make sure everything is working:

$ deciduous --help
Decision graph tooling for AI-assisted development

Usage: deciduous <COMMAND>

Commands:
  init      Initialize deciduous in current directory
  add       Add a new node to the decision graph
  link      Add an edge between nodes
  nodes     List all nodes
  edges     List all edges
  serve     Start the graph viewer server
  tui       Launch the terminal user interface
  ...

You should see a list of available commands. If you see this, you're ready to go!