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

# Troubleshooting

> Fast checks for provider detection, managed reattach, SSH, diff review, and CLI channel problems.

## A provider is not detected

Run the provider command from your login shell. If it is missing, install or
sign in with the provider's official instructions. Restart Dure after changing
`PATH`; existing app processes do not inherit later shell changes.

## The agent did not survive an app restart

Confirm that the pane was a managed local agent. A CLI started manually in an
ordinary terminal can be recognized without being promoted to Hmux ownership.
Start it from an agent pane or use an offered managed-conversion action.

If the Hmux host or computer exited, use Session Recovery. That starts or
restores a process and is not uninterrupted survival.

## An SSH pane disconnected

Test the host from Settings and verify its authentication method. SSH projects
reconnect, but remote providers do not yet use managed-local Hmux semantics by
default. Check the remote process independently before retrying a command.

## Diff review is unavailable

The Diff pane currently supports local Git worktrees. Confirm that the agent
has a local worktree and that its changes differ from the recorded fork point.
SSH remote diffs are not supported yet.

## `dure orch` cannot find an app channel

Launch Dure once in the target channel to create its registry. Run the command
inside a Dure terminal, or set `DURE_APP_CHANNEL` when intentionally targeting
an isolated development build.

## macOS blocks the alpha app

The public alpha is unsigned. Re-run the quarantine removal command from the
[installation guide](/en/install) against the unchanged legacy bundle path.

For guarantee boundaries rather than a symptom, read
[Current limits](/en/current-limits).
