# Troubleshooting

> One page for each symptom, with its cause, the solution and the version it applies from.

Find the page that matches what you see. Each page names the symptom in plain words and gives the cause, the solution and the version it applies from. If your problem is not here, check the [FAQ](/devhub/faq/index.md) and the **#known-issues** channel on [our Discord](https://discord.gg/Pymu69mVXv), and then [write to support](/support/index.md).

## Install and sign-in

- [macOS says it cannot verify DevHub and will not open it](/devhub/troubleshooting/gatekeeper-blocks-open/index.md)
- [DevHub says "The link expired" or "Signing in did not work"](/devhub/troubleshooting/sign-in-link-expired/index.md)
- [DevHub says "This account cannot use Vartari DevHub"](/devhub/troubleshooting/account-cannot-use-devhub/index.md)
- [After installing a new version, DevHub will not let me work offline](/devhub/troubleshooting/first-start-after-update-needs-network/index.md)

## Connection to AI clients

- [Agents cannot reach DevHub after I signed out, or the MCP server is off](/devhub/troubleshooting/mcp-stopped-after-sign-out/index.md)
- [My AI client cannot connect to DevHub, or a tool is missing](/devhub/troubleshooting/agent-cannot-connect/index.md)
- [DevHub says my AI client is not found, but it works in the terminal](/devhub/troubleshooting/client-not-found/index.md)
- [My AI client lists the DevHub skills but never uses them](/devhub/troubleshooting/skills-not-firing/index.md)

## Agents

- [Agent Intelligence is empty and nothing is captured](/devhub/troubleshooting/agent-intelligence-collects-nothing/index.md)
- [DevHub stops responding while an agent searches a large repository](/devhub/troubleshooting/app-freezes-on-many-searches/index.md)

## The application

- [DevHub says "Git is not available"](/devhub/troubleshooting/git-missing-banner/index.md)
- [macOS asks to access Documents, or DevHub says a folder cannot be opened](/devhub/troubleshooting/folder-access-prompt/index.md)
- [The Desktop Pet is not visible](/devhub/troubleshooting/pet-not-visible/index.md)
- [Some labels are in English in the Polish interface](/devhub/troubleshooting/untranslated-strings/index.md)

## Before you write to support

Note the DevHub version (Settings > General) and your macOS version. Do not paste your MCP address, tokens or passwords anywhere public. See [Support](/support/index.md) for what to include.