Fix a problem
Find your problem, take the first step, and know what each recovery action keeps.
On this page
Start with the problem#
| Problem | First step |
|---|---|
| An agent will not connect | Refresh it in Settings > Providers. Details. |
| A reply was cut off | Check the files, then click Continue on that turn. |
| A reply failed | Read the error, fix the cause, then click Retry. |
| You changed agent settings, or the agent stopped responding | Type /restart. |
| The chat is very long | Ask for a handoff note, then /compact or start a new chat. |
| You want to try another direction | Fork the chat, or start a new task. |
| An agent’s file changes were wrong | Use Reset to this point. |
| A timeline edit was wrong | Use Undo in VideoDraft Editor. |
| A generation is still running | Check its status. Do not submit it again. |
| Media is missing | See missing media. |
An agent will not connect#
- 1Open Settings > Providers and refresh the agent.
- 2Use its sign-in button, or run claude auth login or codex login in Terminal.
- 3Return to ADE and refresh again.
- 4If an agent download fails, click Retry now on the banner in the chat.
What Reset to this point can undo#
Reset rolls the task’s files back to how they were at that turn and removes the later turns. It is not offered on the latest turn. In a folder without Git there is nothing to roll back to, and ADE tells you.
- Reset restores files Git tracks. Media files Git does not track stay as they are.
- It does not undo cloud generations, charges or anything the agent did outside your Mac.
- After a reset, some agents start a fresh conversation and do not remember the earlier turns.
- Later chat history is removed. Read the confirmation first.
Media is missing or moved#
- 1Look in the task’s media/ folder in All files.
- 2Ask the agent for the exact saved path.
- 3Check the generation finished and did not stop on an error.
- 4For media made in the web app, open the right AI Studio project or video project.
- 5If a linked .vdproject moved, the Editor tab shows Project not found. Click Link a project… and pick its new location.
A scheduled task did not run#
- Check the scheduled task is on and shows a next run time.
- Open its run history and look for skipped runs, stopped runs or sign-in errors.
- Check ADE was open and awake at run time. ADE cannot wake a Mac that is shut down.
VideoDraft mode or the editor is unavailable#
- Check your Mac has Apple silicon and macOS 15 or later.
- Open Command Center (Cmd + K) and choose Open VideoDraft Editor to show the window.
- If the Editor tab says No project linked yet, click Create project now or Link existing project….
- A closed editor window can still be running for agents.
Browser screenshots do not work#
- 1Open Settings > Experimental, turn on In-app browser preview and find Screen Recording below it.
- 2Allow VideoDraft in System Settings > Privacy & Security > Screen Recording.
- 3Quit and reopen ADE. macOS applies this permission only after a restart.
- 4Try the screenshot again.
Keep work safe and get help#
Back up important task files, media and editor projects. Chat history, Git checkpoints, editor autosave and web history each save different things. None of them is a full backup.
When you contact support, include the app version, agent, what you did, the exact error and whether files or jobs changed. Leave keys and passwords out of screenshots.