Musketeer logo Musketeer

Build

git clone https://github.com/justynclarknetwork/musketeer.git
cd musketeer
cargo build

Quickstart (SMALL-native)

Initialize a workspace. This bootstraps .small/ if it does not exist and creates .musketeer/:

musketeer init

Create a new execution run:

musketeer run new

Generate a role packet from SMALL canonical state:

musketeer packet --role planner

Log execution progress:

musketeer log --role executor --kind note --message "completed initial setup"

Record an auditor verdict:

musketeer verdict --role auditor --value approve --reason "all checks passed"

Validate SMALL state and Musketeer execution state:

musketeer check

Check run status:

musketeer run status

JSON mode

All commands support --json for machine-readable output:

musketeer init --json
musketeer run new --json
musketeer check --json

In --json mode, stdout is exactly one JSON object.

Migrating legacy workspaces

If you have an existing workspace with artifacts under .musketeer/runs/, convert to SMALL-native layout:

musketeer migrate --dry-run    # preview changes
musketeer migrate              # convert in place

See migrate for details.

Feel test

Musketeer includes a deterministic feel test script:

PATH="$PWD/target/debug:$PATH" ./scripts/feeltest.sh

Expected success output:

MUSKETEER_FEELTEST_OK