grafos dev

Local fabric lifecycle: dev up, dev down, dev doctor. Iterate without touching the hosted fabric.

grafos dev

Local dev fabric lifecycle: up, down, doctor

Usage: grafos dev [OPTIONS] <COMMAND>

Commands:
  up             Spin up a local scheduler + fabricbiosd for the current project
  down           Tear down the project-local fabric
  doctor         Probe the local fabric's health + auth mode + tenant state
  rotate-bearer  Mint a fresh loopback-helper bearer, restart the helper, and print the new bearer. Use when you suspect the old one leaked or after long-running sessions
  help           Print this message or the help of the given subcommand(s)

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos dev up

Spin up a local scheduler + fabricbiosd for the current project

Usage: grafos dev up [OPTIONS]

Options:
      --fabric <FABRIC>
          Fabric address (host:port). Overrides GRAFOS_FABRIC env var

          [env: GRAFOS_FABRIC=]

      --state-dir <STATE_DIR>
          Directory for local dev state. Defaults to `.grafos/dev` relative to the current project root

      --dashboard-origin <DASHBOARD_ORIGIN>
          Origin the dashboard will call the loopback helper from. The helper pins `Access-Control-Allow-Origin` to this value and rejects requests whose `Origin:` header doesn't match (CSRF defense). When omitted the helper accepts any `http://localhost:*` or `http://127.0.0.1:*` origin — the loopback-only fallback, still safer than the V1 wildcard

      --json
          Output in JSON format for scripting

      --tenant <TENANT>
          Override the tenant name. Defaults to `creds.scheduler_tenant_name` if signed in, else `dev-tenant`

      --wide
          Show additional columns in table output

      --mem-capacity <MEM_CAPACITY>
          Memory pool size advertised by the local fabricbiosd, in bytes. The tiny default (128 KiB) keeps the dev fabric from eating GBs of RSS on developer laptops. Bump this when you need larger leases, e.g. `grafos dev up --mem-capacity 67108864` for 64 MiB.

          Accepts suffixes k/m/g for convenience: `--mem-capacity 16m` == 16 MiB.

          [default: 131072]

      --no-color
          Disable color output

      --cpu-cores <CPU_CORES>
          CPU cores advertised by the local fabricbiosd. Native tasklet execution requires a CPU lease, so the dev fabric defaults to one advertised core

          [default: 1]

      --pool <POOL>
          Pool name (default: "default")

          [default: default]

      --skip-register
          Skip the tenant-register step. Useful when standing up the fabric against an existing state-dir whose tenant is already registered

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version

grafos dev down

Tear down the project-local fabric

Usage: grafos dev down [OPTIONS]

Options:
      --fabric <FABRIC>        Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --state-dir <STATE_DIR>  Directory containing dev.json. Defaults to `.grafos/dev` in the current project
      --clean                  After stopping processes, also delete the state dir. By default we leave it so logs remain inspectable
      --json                   Output in JSON format for scripting
      --wide                   Show additional columns in table output
      --no-color               Disable color output
      --pool <POOL>            Pool name (default: "default") [default: default]
  -h, --help                   Print help
  -V, --version                Print version

grafos dev doctor

Probe the local fabric's health + auth mode + tenant state

Usage: grafos dev doctor [OPTIONS]

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version

grafos dev rotate-bearer

Mint a fresh loopback-helper bearer, restart the helper, and print the new bearer. Use when you suspect the old one leaked or after long-running sessions

Usage: grafos dev rotate-bearer [OPTIONS]

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --json             Output in JSON format for scripting
      --wide             Show additional columns in table output
      --no-color         Disable color output
      --pool <POOL>      Pool name (default: "default") [default: default]
  -h, --help             Print help
  -V, --version          Print version