Troubleshooting
Fix common problems with agents, tasks, media, and schedules.
On this page
An agent will not connect#
- 1Open Settings > Providers and refresh the provider status.
- 2Use the provider sign-in action, or run claude auth login or codex login in Terminal.
- 3Return to VideoDraft and refresh again.
- 4If the binary is missing, use Install or Re-download in provider settings.
Generated media is missing#
- Check the current task media/ folder.
- Ask the agent for the exact saved path, and to show the file as a Markdown link.
- Confirm the generation job finished and did not stop at a tool error.
- Ask the agent to check the live VideoDraft tool catalog if a model or tool name failed.
A chat is stuck or interrupted#
- Use Continue on an interrupted turn.
- Use /restart after you change agent settings, or when the local agent process goes stale.
- Start a new chat to switch to another agent.
- Move unrelated work to another task if two agents are competing for the same folder.
A scheduled task did not run on time#
- Keep VideoDraft open at the scheduled time.
- Enable Keep computer awake from Scheduled or Settings > General.
- Check that the task is enabled and has a future next-run time.
- Open the task run history and look for skipped runs, interrupted runs, or sign-in errors.
- Overdue tasks catch up after launch, but ADE cannot wake a Mac that is powered off.
VideoDraft mode or the editor is unavailable#
- Confirm your Mac uses Apple silicon with macOS 15 or later.
- Open Command Center and choose Open VideoDraft Editor to reveal the editor window.
- If a task has no editor project, open its Editor tab and create or link a .vdproject.
- If a linked project moved, use Link a project to select its new location.
- A hidden editor window can still be running and available to agents.
Browser screenshots do not work#
- 1Open Settings > General and find Screen Recording under Notifications & Permissions.
- 2Grant VideoDraft access in System Settings > Privacy & Security > Screen Recording.
- 3Quit and reopen VideoDraft. macOS does not apply this permission to an app that is already running.
- 4Try the browser screenshot again.