Troubleshooting

Fixes for the problems you're most likely to meet, from a missing agent to a send that seems stuck.

Claude Code or Codex shows "Not found"

Swiftbird looks for tools installed on your computer and in the usual Windows locations. Install the tool with the provider's instructions, open a new terminal to check it runs, then choose Check connection in Swiftbird.

Sign in with the tool's own login: the Sign in button starts it, or run it from a terminal. Then Check connection. Swiftbird doesn't hold your provider sign-in, so signing in to Swiftbird doesn't sign you in to Claude or OpenAI.

A model is greyed out or refuses requests

A model marked as needing a newer tool version can't be picked until you update the CLI. If a model is selectable but requests fail, your provider plan may not include it. Try another model.

"Warming up agent" doesn't finish

New conversations prepare your agent once before the first task. If it fails, use Retry. If it keeps failing, check the tool is connected, then start a new conversation.

A message seems stuck after Send

Don't send it again. Use Check send status; it reads the original request's receipt without sending it a second time. Your draft and any corrections are kept until the outcome is clear.

A file or shot shows as missing

Swiftbird shows files where your film's records say they are, and never moves them. If you moved or renamed a folder, put it back, or ask your agent in Chat to update the film's records.

The Scene editor is empty

The editor shows an empty grid until a saved Blender shot is imported. Use Import saved Blender shot on the shot's row. Unsaved changes in an open Blender window aren't included; save in Blender first, or pair a window with Live Blender.

Your plan shows Free after paying

Use Settings → Subscription → Refresh membership, and check that Payhip and Swiftbird use the same email. See Membership and billing.

Swiftbird won't open, or reports another server

If Swiftbird says its address is used by "a different or older server", an earlier Swiftbird process is still running. Close Swiftbird, end the leftover process in Task Manager, and open it again.

Asking for help

Copy your diagnostics with Settings → Help & about → Copy diagnostics and contact support. The diagnostics list versions and connection states, without emails, tokens, file paths or conversations.

Last reviewed 28 September 2026 against the Swiftbird prototype of 27 September 2026. Still stuck? Contact support.