grafos agent

Cell-agent runtime. Used by the cell host process, not by program authors.

grafos agent

Install agent skills and report agent-side readiness

Usage: grafos agent [OPTIONS] <COMMAND>

Commands:
  skill   Install or update the grafos-programmer skill into a supported coding agent's local config
  doctor  Report agent-side readiness: installed skill version, CLI version, tenant id, local dev fabric status, cloud target readiness
  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 agent skill

Install or update the grafos-programmer skill into a supported coding agent's local config

Usage: grafos agent skill [OPTIONS] <COMMAND>

Commands:
  install  Install into the target agent. The target's config path is computed from $HOME; set `GRAFOS_AGENT_SKILLS_ROOT` to override for dry runs
  show     Print the SKILL.md that would be installed. Useful for auditing before running `install`
  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 agent skill install

Install into the target agent. The target's config path is computed from $HOME; set `GRAFOS_AGENT_SKILLS_ROOT` to override for dry runs

Usage: grafos agent skill install [OPTIONS] <TARGET>

Arguments:
  <TARGET>  Agent to install into: `claude` (Claude Code) or `codex` (OpenAI Codex CLI) [possible values: claude, codex]

Options:
      --fabric <FABRIC>  Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --force            Overwrite an existing skill file. Without this flag, install refuses to touch a modified skill
      --dry-run          Print what would be installed (and where) without writing
      --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 agent skill show

Print the SKILL.md that would be installed. Useful for auditing before running `install`

Usage: grafos agent skill show [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 agent doctor

Report agent-side readiness: installed skill version, CLI version, tenant id, local dev fabric status, cloud target readiness

Usage: grafos agent doctor [OPTIONS]

Options:
      --fabric <FABRIC>        Fabric address (host:port). Overrides GRAFOS_FABRIC env var [env: GRAFOS_FABRIC=]
      --scheduler <SCHEDULER>  Scheduler URL used to check local dev fabric status. Defaults to `GRAFOS_SCHEDULER` env var if set; otherwise `http://127.0.0.1:9100` [env: GRAFOS_SCHEDULER=]
      --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