PitFast
Get Started
developerscli

One CLI for the entire lifecycle.

The pit command-line interface provides complete control over project scaffolding, WASI compilation, CAS artifact storage, logical routing, and distributed cluster coordination.

PROJECT
pit init[--language <lang>] [--name <name>]

Scaffold a new PitFast service project template.

$pit init --language rust --name auth-service
pit build[--release] [--target <wit-world>]

Compile local source code into a WASI Component.

$pit build --release
pit inspect[<path-to-wasm>]

Inspect WIT exports, imports, and component metadata.

$pit inspect .pit/build/service.wasm
ARTIFACTS
pit push<tag-or-name>

Publish a compiled WASI Component to the Paddock registry.

$pit push auth-service:v1
pit pull<tag-or-digest>

Fetch a component artifact by tag or SHA-256 digest.

$pit pull auth-service:v1
pit paddock inspect<tag>

View remote artifact digest and manifest details.

$pit paddock inspect auth-service:v1
SERVICES
pit deploy<service-id> <artifact-tag>

Register or update a logical service route in PitLane.

$pit deploy auth auth-service:v1
pit rollback<service-id>

Revert service route to previous verified artifact digest.

$pit rollback auth
pit undeploy<service-id>

De-register logical service route from PitLane.

$pit undeploy auth
pit service list

List all deployed logical services and active digests.

$pit service list
EXECUTION
pit run<artifact>

Execute a component directly inside an ephemeral lane.

$pit run auth-service:v1
pit call<logical-uri> [flags]

Invoke a logical service endpoint through PitLane.

$pit call pit://auth/verify -X POST -d '{"token":"xyz"}'
pit bench<logical-uri> [--concurrency <n>]

Run high-throughput concurrent load tests on shared lanes.

$pit bench pit://auth/verify -c 50 -n 10000
INFRASTRUCTURE
pit circuit join--garage <id> [--token <token>]

Join a compute host Garage into an active Circuit.

$pit circuit join --garage edge-a --token secret123
pit circuit status

Display cluster-wide Garages, total lanes, and load.

$pit circuit status
pit garage start[--lanes <n>] [--port <p>]

Start local host compute daemon and execution grid.

$pit garage start --lanes 8 --port 7080
pit garage status

Check host lane status, active tasks, and local CAS cache.

$pit garage status
SYSTEM
pit doctor languages

Verify local toolchain compilers (Rust, Go, Node, Python).

$pit doctor languages
pit system info

Print architecture, OS kernel, Wasmtime version, and CLI build.

$pit system info