# OpenCLI Agent Pack: zoxide-doctor

Use this when an AI agent needs to work with `zoxide-doctor`.

## What this CLI is for
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.

Best for: Diagnosing zoxide installation, PATH, and shell initialization problems locally.

## Agent readiness
Great for agents (85/100)
- 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.

## Install
```sh
npm install -g zoxide-doctor
```

## Verify before real work
```sh
zoxide-doctor --version
```
Expected signal: zoxide-doctor responds locally and is ready for the first real command.

## Safe starting commands
```sh
zoxide-doctor --version
```

```sh
zoxide-doctor --shell zsh --json
```

```sh
npm install -g zoxide-doctor
```

## Guardrails for agents
- Run the verify command first.
- Summarize findings before taking actions with side effects.

## Suggested agent instruction
You 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.

Source: OpenCLI