Reference

Commands, update behavior, and quick fixes in one place.

Use this page as the practical reference when you need command reminders, local build steps, or the fastest route through a setup issue.

Command cheat sheet

Core commands.

raph init --path .
raph init --path . --no-embeddings
raph start
raph crawl --single https://example.com/docs/page

raph sync --path .
raph sync --status
raph sync --remove --path .
raph sync --stop
raph clear --yes
raph config init
raph config check
raph update
raph version

Updates

Stable release updates are built in.

Installed release builds update when you run raph update. To opt into automatic update attempts before normal commands, set this environment variable. Development builds do not self-update.

export RAPH_AUTO_UPDATE=1
raph update

Release updates are only trusted when the downloaded checksums.txt file passes minisign verification against the bundled public key and the selected archive matches that signed checksum.

Docs site

Public usage docs deploy from docs/ to raph.madebyknnls.com through the GitHub Pages workflow.

Release integrity

Verify published tags and assets with `gh`.

./scripts/check-immutable-releases.sh
./scripts/enable-immutable-releases.sh

Run once with repo-admin credentials before relying on immutable release verification.

gh release verify v0.1.1
./scripts/verify-release.sh v0.1.1 ./raph_linux_amd64.tar.gz ./checksums.txt ./checksums.txt.minisig

This checks GitHub release integrity attestations, local asset matches, and build attestations for the supplied files.

Troubleshooting

Common setup issues.

No embeddings

Run raph config init, then set OPENROUTER_API_KEY. Without it, raph falls back to keyword-oriented retrieval where possible.

Need a fresh MCP install

Use raph agents mcp setup --path . --dry-run first to preview target files, then rerun without --dry-run. Entries default to each agent's global (user-level) config; pass --scope local for project files.

Build locally

Verification before merging.

go test ./...
go build ./cmd/raph

raph studio --port 4545

Run the Studio smoke test as well for changes that touch the local UI. Studio binds to 127.0.0.1 by default.

License

Usage terms.

Raph is source-available for private, non-commercial, personal use only. Commercial use, business use, monetization, selling, and reselling require a separate written license.

Read the full license.