geni doctor

geni doctor

Walks every layer geni depends on and prints ✓ / ✗ per check. Designed as the first thing to run when something doesn't work, and the last thing to run after install to confirm everything's wired up.

Each check is independent — one failure doesn't short-circuit the rest, so a single run produces the full picture.

What it checks

• Runtime deps — bash, curl, jq are on the PATH. Prints the exact brew / apt install command for any missing.
• Session — ~/.config/geni/runner-session.json exists and is valid; the active workspace is set; the cloud accepts the session token.
• Network — the API base URL is reachable and the configured server responds.
• Skills — for every detected AI coding agent, the bundled geni skill is present and current.

Output

geni doctor

System
  ✓ bash    /bin/bash
  ✓ curl    /usr/bin/curl
  ✓ jq      /opt/homebrew/bin/jq

Session
  ✓ Authenticated as jack@generalinput.com
  ✓ Active workspace: acme (Acme Inc.)
  ✓ API reachable: https://cloud.generalinput.com

Skills
  ✓ Claude Code: ~/.claude/skills/geni.md
  ✗ Codex CLI: ~/.codex/skills/geni.md (not installed)
    Fix: run `geni skills install`

1 check failed.

Exit codes

Notes

• geni doctor skips the runtime-dep preflight that other commands run, so it can still report on missing dependencies instead of refusing to run.
• This is the right command to paste into a support thread — its output captures everything we'd ask about.