{
  "uid": "cogitave.learn.docs.check-your-environment",
  "kind": "doc",
  "href": "/docs/check-your-environment/",
  "title": "Check your environment",
  "summary": "Use the namzu operator CLI to verify a machine before debugging an agent - runtime version, installed packages, and whether the provider you registered is actually reachable.",
  "type": "how-to",
  "products": [
    "namzu"
  ],
  "roles": [
    "developer",
    "platform-engineer"
  ],
  "levels": [
    "beginner"
  ],
  "subjects": [],
  "headings": [
    "Install the CLI",
    "Run the check",
    "Order of elimination",
    "Current scope",
    "Next steps"
  ],
  "source": "\n# Check your environment\n\nWhen an agent misbehaves, the first question is whether the problem is your code\nor the machine underneath it. `@namzu/cli` answers that question before you start\nreading your own logic.\n\n## Install the CLI\n\n```bash\npnpm add -D @namzu/cli\n```\n\nIt works as a project-local bin or as a library, so you can call the same checks\nfrom your own tooling instead of shelling out.\n\n## Run the check\n\n```bash\npnpm namzu doctor\n```\n\n`doctor` inspects the environment rather than your agent: the runtime version\nagainst the supported floor, which Namzu packages are present, and whether the\nprovider you have configured can actually be reached.\n\n> [!TIP]\n> Run `doctor` in CI as the first step of the job. A failure there tells you the\n> runner is wrong; a failure later tells you the change is wrong. Separating\n> those two saves the argument about whose fault a red build is.\n\n## Order of elimination\n\nWork down this list before opening your agent code:\n\n1. **Node version.** The floor is 20. A machine below it fails in ways that look\n   like library bugs.\n2. **Packages present.** The kernel installed without a provider driver falls back\n   to `MockLLMProvider` - which succeeds, and returns nothing you asked for. If\n   responses look synthetic, this is usually why.\n3. **Provider reachable.** For a local driver, that means Ollama or LM Studio is\n   actually running and has the model pulled. For a hosted driver, it means the\n   credential is present in the environment.\n4. **Then** your agent.\n\n## Current scope\n\n> [!NOTE]\n> `namzu doctor` is the command the operator CLI ships today. Other commands are\n> planned but not published, and this page will list them when they exist rather\n> than in advance.\n\n## Next steps\n\n- [Choose a provider](choose-a-provider.md) - which driver you should have installed.\n- [Packages](packages.md) - the supported runtime floor and install shapes.\n",
  "lastReviewed": "2026-07-26",
  "order": 2
}