{"schemaVersion":"opencli.cli.v1","slug":"zoxide-doctor","name":"zoxide-doctor","shortName":"zoxide-doctor","binaryName":"zoxide-doctor","maker":{"slug":"jiankn","name":"LTD Atlas","type":"individual","url":"https://github.com/jiankn","officialPlatformMaker":false,"featuredBuilder":false},"category":"Shell Utilities","description":"zoxide setup diagnostics, shell initialization checks, and path and profile troubleshooting from the terminal. Built by LTD Atlas. Start with `npm install -g zoxide-doctor` and go from there. Supports structured output — good for scripts and agents. Runs entirely on your machine.","tagline":"zoxide setup diagnostics, shell initialization checks, and path and profile troubleshooting from the terminal.","install":{"packageManager":"npm","command":"npm install -g zoxide-doctor","packageName":null,"npmPackage":"zoxide-doctor","brewFormula":null,"brewCask":null,"crateName":null,"pypiPackage":null,"goPackage":null,"dockerImage":null},"verify":{"command":"zoxide-doctor --version","signal":"zoxide-doctor responds locally and is ready for the first real command."},"quickStart":"zoxide-doctor --shell zsh --json","exampleWorkflow":["npm install -g zoxide-doctor","zoxide-doctor --shell zsh --json"],"agent":{"readiness":{"label":"Great for agents","score":85,"reasons":["Structured output is available for parsing.","Supports non-interactive/scripted use.","Works well in CI or repeatable automation.","Can run locally with less credential exposure."],"guardrails":[]},"packUrl":"https://opencli.co/cli/zoxide-doctor/agent.md","packMarkdown":"# OpenCLI Agent Pack: zoxide-doctor\n\nUse this when an AI agent needs to work with `zoxide-doctor`.\n\n## What this CLI is for\nzoxide setup diagnostics, shell initialization checks, and path and profile troubleshooting from the terminal. Built by LTD Atlas. Start with `npm install -g zoxide-doctor` and go from there. Supports structured output — good for scripts and agents. Runs entirely on your machine.\n\nBest for: Diagnosing zoxide installation, PATH, and shell initialization problems locally.\n\n## Agent readiness\nGreat for agents (85/100)\n- Structured output is available for parsing.\n- Supports non-interactive/scripted use.\n- Works well in CI or repeatable automation.\n- Can run locally with less credential exposure.\n\n## Install\n```sh\nnpm install -g zoxide-doctor\n```\n\n## Verify before real work\n```sh\nzoxide-doctor --version\n```\nExpected signal: zoxide-doctor responds locally and is ready for the first real command.\n\n## Safe starting commands\n```sh\nzoxide-doctor --version\n```\n\n```sh\nzoxide-doctor --shell zsh --json\n```\n\n```sh\nnpm install -g zoxide-doctor\n```\n\n## Guardrails for agents\n- Run the verify command first.\n- Summarize findings before taking actions with side effects.\n\n## Suggested agent instruction\nYou may use zoxide-doctor (`zoxide-doctor`) for diagnosing zoxide installation, path, and shell initialization problems locally.. First install it if missing, then run the verify command. Start with read-only or inspection commands. Summarize what you found before changing anything. Ask for confirmation before commands that mutate remote state, spend money, deploy, delete data, merge code, or expose secrets.\n\nSource: OpenCLI\n"},"fit":{"bestFor":"Diagnosing zoxide installation, PATH, and shell initialization problems locally.","useThisIf":"zoxide is installed but its z command is missing, initialization fails, or shell configuration is unclear.","skipIf":"You need the zoxide binary itself; install the official zoxide project instead.","whatHappensNext":"Run `zoxide-doctor --shell zsh --json` to see it in action."},"capabilities":{"agentFriendly":true,"supportsJsonOutput":true,"supportsNonInteractive":true,"supportsDryRun":false,"requiresAuth":false,"requiresNetwork":false,"ciFriendly":true,"localFirst":true,"destructivePotential":"low"},"taxonomy":{"useCases":["zoxide setup diagnostics","Shell initialization checks","PATH and profile troubleshooting"],"aliases":["zoxide doctor","zoxide diagnostic","zoxide setup checker"],"keywords":["zoxide","shell","path","diagnostics","command not found"],"tags":["agent-friendly","shell","diagnostics"]},"links":{"website":"https://zoxide.org/tools/zoxide-doctor/","github":"https://github.com/jiankn/zoxide-doctor","docs":"https://zoxide.org/tools/zoxide-doctor/","opencli":"https://opencli.co/cli/zoxide-doctor","markdown":"https://opencli.co/cli/zoxide-doctor/agent.md","json":"https://opencli.co/cli/zoxide-doctor.json"},"metrics":{"githubStars":0,"latestRelease":"2026-08-08T14:14:46Z","license":"MIT","metricLabel":"npm weekly downloads","metricValue":9,"metricSource":"npm","metricAsOf":"2026-09-14T09:00:22.192Z"}}