GemmaPoddocs
Referencegemmapod CLI

gemmapod status

Probe the running Host, Ollama, and signaling broker. Returns a runtime health table.

Synopsis

gemmapod status

Description

Reads the discovery file at ~/.gemmapod/host.json, hits the Host's HTTP API, and probes Ollama and the signaling broker. Prints a colored ✓/✗ table:

✓  Host       running (pid 12345, port 57447)
✓  Discovery file   ~/.gemmapod/host.json
✓  Ollama           http://localhost:11434 (3 models)
✓  Signal broker    https://signal.gemmapod.com (200, 240ms)
✓  Pods             2 registered, 2 running

If the Host is not running, every row reports not probed (Host down) and the command exits non-zero.

Use it from shell scripts to gate work on a healthy daemon, or as a first stop when something feels off.

Exit codes

CodeMeaning
0Everything green.
1At least one probe failed (table shows which).
  • gemmapod doctor — static validation of pod.toml without touching the network. Different command — status checks runtime, doctor checks the manifest.

gemmapod run

Register a pod with the Host (starting one if needed). Lets you override the Ollama model at runtime.

GemmaPodRuntime

The runtime handle returned by mount / mountPod / create / boot.

On this page

SynopsisDescriptionExit codesRelated