Skip to content
grafOS docs

CLI reference

Generated from grafos --help at version 0.1.2. Every page text matches the binary’s --help exactly; regeneration runs as part of the docs build.

To check the version of grafos you have installed:

Terminal window
grafos --version

Subcommands

  • grafos account — Tenura-hosted account creation, verification, login, and admin (mint codes, list tenants).
  • grafos auth — Lower-level credential surface (grafos auth ...). Most users go through grafos login / grafos status instead.
  • grafos admin — Fabric-administrator surface (CA bootstrap, cert issuance, tenant management on the scheduler).
  • grafos new — Scaffold a fresh project with example tasklets and a grafos.toml manifest.
  • grafos validate — Run local checks (cargo test, source-hash) and emit .grafos/validation.json.
  • grafos tasklet — Build, inspect, and sign tasklets. The build subcommand compiles every declared tasklet to WASM and writes a SHA-256-named artifact under .grafos/tasklets/.
  • grafos publish — Sign + publish a tasklet to a registry. Ships the WASM module and its manifest.
  • grafos deploy — Push a project (or a single tasklet) onto the fabric. The bare deploy form is the customer-facing path; deploy run is the lower-level form that scripts call directly.
  • grafos run — Direct run subcommand. Most users go through grafos deploy run instead.
  • grafos runs — List, inspect, and download artifacts from previous runs. Tenant-scoped — you only see your own runs.
  • grafos logs — Print stdout/stderr-equivalent output from a finalized run.
  • grafos artifacts — List + download server-persisted tasklet output artifacts for a run, with SHA-256 verification.
  • grafos fabric — Fabric-wide views: cells, resources, dashboard. Operator-leaning.
  • grafos provider — Provider readiness + cell management. Operator surface.
  • grafos cloud — Connect AWS / GCP / Azure provider cells in customer-owned cloud mode.
  • grafos nodes — Inspect fabric nodes. Operator-leaning view of who’s announcing on the fabric.
  • grafos leases — Lease lifecycle inspection — list, query, fence.
  • grafos profile — Program-level resource profiler: flame graphs, lease timelines, data-flow diagrams, waste reports.
  • grafos dev — Local fabric lifecycle: dev up, dev down, dev doctor. Iterate without touching the hosted fabric.
  • grafos store — Object storage CLI on top of grafos-store.
  • grafos agent — Cell-agent runtime. Used by the cell host process, not by program authors.
  • grafos status — Show the current credential and fabric context.
  • grafos login — Browser-loopback or device-code login against the Tenura account API.
  • grafos logout — Clear local credentials.
  • grafos revoke — Revoke the current credential server-side.
  • grafos refresh — Refresh the current credential before it expires.
  • grafos self — Manage the grafos CLI itself. grafos self update re-runs the signed installer.
  • grafos doctor — Connectivity + version compatibility checks.
  • grafos health — Lightweight fabric health probe.
  • grafos completions — Generate shell completion scripts for bash/zsh/fish.