Root Use Cases

Safer alternative to Homebrew

Install CLI tools with a lockfile and an undo button. When a tool update breaks your workflow, roll back instead of debugging your global PATH.

root install jq
root verify jq
# something broke?
root rollback --last

Reproducible dev machines

Share root.lock across your team so everyone runs the same tool versions:

# On machine A
root install ripgrep fd bat
git add root.lock Rootfile

# On machine B
root restore --lock ./root.lock

AI coding agent tooling

Agents can install and verify tools without polluting global PATH. Use --json output for structured automation:

root plan install terraform --json
root install terraform --json
root verify terraform --json

Agent config portability

Transfer Codex, OpenCode, or Claude Code working configuration between machines — same agent, credential-free:

root agent-bundle export codex
root agent-bundle plan ./bundle.tar.gz
root agent-bundle apply ./bundle.tar.gz

Isolated task execution

Run tasks in Docker sandboxes without affecting your host environment:

root sandbox create my-task
root sandbox run my-task -- npm test
root sandbox destroy my-task

Local model management

Pull and verify Ollama models declared in your Rootfile:

root models list
root models pull llama3.2
root models verify llama3.2