Installation

Choose the method that matches your setup.

macOS (Homebrew)

Fastest path on macOS, no Node or Bun runtime required:

brew tap saif-shines/tap
brew install doraval

Note for custom taps: On some systems, Homebrew will refuse formulas from third-party taps until you trust them once:

brew trust saif-shines/tap
# or
brew trust --formula saif-shines/tap/doraval

Verify:

doraval --help

npm / npx

Works anywhere Node.js is installed. No separate Bun install needed.

npx @hacksmith/doraval validate .
# if Bun is not installed: npm i -g bun

Or install globally once:

npm install -g @hacksmith/doraval
doraval validate .

The wrapper detects whether Bun is available and uses it automatically. If Bun is not installed, it will prompt you to install it.

Bun

Don’t have Bun? Install it first:

curl -fsSL https://bun.sh/install | bash   # macOS / Linux

For Windows, see bun.sh/docs/installation. Requires Bun v1.2+.

Then run doraval:

bunx @hacksmith/doraval validate .

Or install globally:

bun add -g @hacksmith/doraval
doraval validate .

Verify

doraval --help

Expected output shows the top-level help with commands including validate, init, providers, completion, update, claude/codex/cursor/copilot, skill, and journal.

After install, run doraval update --check to confirm you are on the latest version (see the update command).

JSR (library use only)

doraval is also published on JSR for importing as a module in Bun projects:

bunx jsr add @hacksmith/doraval

Note: jsr add installs a project dependency, not a global binary. It does not put doraval on your PATH. Use the npm or Homebrew paths above for CLI use.