---
title: "Troubleshooting"
description: "Use read-only checks first to distinguish configuration, local model, and support-bundle issues."
---

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

# Troubleshooting

Start with a local health check. Do not treat a model error as a policy decision.

## An agent was not configured

```sh title="Terminal"
aif configure --validate
```

Run configuration again and validate the selected integration. Compare the result with [supported agent boundaries](/integrations/agents).

## The model or protection service is unhealthy

```sh title="Terminal"
aif status
aif doctor
```

Status shows whether the protection service, local model, and activity history are ready. Doctor identifies the component that needs attention and its next repair.

## You need a support attachment

```sh title="Terminal"
aif doctor --bundle
```

Create the privacy-filtered diagnostics bundle, then attach its output to an issue or bring it to a support call. If documentation and diagnostics are not enough, [book a call](https://calendar.app.google/GdL3BvBuagny6Kh5A).

## The command is blocked

Read the related rule and use the suggested safe alternative. You can review the local record with `aif show`, and consult [decision labels](/reference/decisions) for the expected next action.

Source: https://docs.harden.run/operations/troubleshooting/index.mdx