Install

macOS and Linux

curl -fsSL https://api.amigens.com/install | sh

dream installed in /home/you/.dreams/bin (on your PATH via ~/.zshrc)

Installs dream in ~/.dreams/bin and adds it to your PATH. Open a new terminal.

irm https://api.amigens.com/install.ps1 | iex

Installs dream.exe and adds it to your PATH. Open a new terminal.

dream version

dream 0.5.0 (c-282, 2026-10-20)

Prints the version and the build it came from.

Run the install line again.

dream setup -y

dream: models are in ~/.dreams/models; `dream start` in a project keeps them loaded for meaning search

Downloads the embedding engine and models (about 1 GB, once). Without them dream matches words only.

Path	What
`<project>/.dream/`	the project's history, drafts, decisions, cards, members, chat and records
`~/.dreams/bin`	`dream`
`~/.dreams/models`	the embedding models
`~/.dreams/policy.db`	your global guidelines, rules, hooks, tools and skills

rm -rf ~/.dreams

Removes dream, the models and your global records. Delete a project's .dream/ to remove its history.

Next: Basics.