> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yocrow.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Check Companion status and resolve common errors.

## Check status

```bash theme={null}
yocrow status
yocrow source list
```

Add `--json` for machine-readable output.

## Common errors

| Code | Meaning | Fix |
| - | - | - |
| `protected_input_required` | The command needs an interactive terminal | Run it in a terminal without `--non-interactive` |
| `provider_limit_reached` | Every connection on your account is in use | Disconnect a provider or upgrade your plan |
| `provider_limit_unavailable` | The connection limit could not be checked | Retry when you are online |
| `connection_release_pending` | The token was removed but the connection was not released | Run the same command again |
| `confirmation_required` | A destructive command needs `--yes`, or an approval was declined | Add `--yes`, or approve the prompt |
| `invalid_source_id` | The source ID is not valid | Use a source ID from [Connect providers](https://docs.yocrow.dev/companion/connect-providers.md) |
| `companion_not_configured` | Only some `YOCROW_COMPANION_*` variables are set | Unset all of them, or set all three |
| `local_state_unavailable` | Local state failed a privacy check | Check that the state directory is owned by your user |
| `unknown_command` | The command is not recognized | Run `yocrow --help` |

## Exit codes

| Code | Meaning |
| - | - |
| `0` | Success |
| `1` | The command could not complete |
| `2` | Invalid arguments |
| `3` | The capability is not available in this build |
| `4` | Unsupported platform |
| `5` | Confirmation required |

## Local state location

| Platform | Directory |
| - | - |
| macOS | `~/Library/Application Support/yocrow-companion` |
| Linux | `~/.config/yocrow-companion` |
| Windows | `%LOCALAPPDATA%\yocrow-companion` |

## Command not found after install

The installer adds the install directory to PATH, but only new terminals pick up the change. Open a new terminal and run `yocrow --version`. If you installed with `YOCROW_NO_MODIFY_PATH=1`, add `~/.local/bin` or `%LOCALAPPDATA%\Yocrow\bin` to your PATH yourself.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.