Skip to content
Browse all documentation

Reference · 9 min read

Troubleshooting

Recover from sign-in, response, terminal, permission, project, and browser problems.

On this page
  1. Unexpected 401 or login prompt
  2. A response stops early
  3. A terminal appears stuck
  4. No changes appear
  5. An approval blocks progress
  6. Before contacting support

Unexpected 401 or login prompt

Normal access expiration should refresh and retry once; it should not log out the desktop account. If Session expired repeats, check connectivity, reopen the app, and sign in once if prompted.

Record the time, model, task ID if visible, and whether the account menu still shows the user. Provider authentication failures should appear as service errors, not user logout.

A response stops early

Gyroscape requires a valid terminal stream event before accepting completion. Abrupt closure is retried or reported incomplete, and partial tool arguments are not executed.

Inspect Changes before retrying so you know what state continues.

A terminal appears stuck

Check whether the command waits for input, produces output, or runs in the background. Send input only when you understand the prompt. Stop or interrupt when it should not continue.

Development servers are intentionally long-running and belong in a background terminal.

No changes appear

Confirm the project and workspace, folder existence, and operating-system access. Then inspect Git status or Changes.

A diagnosis-only task can correctly make no edits. Ask to implement when you want files changed.

An approval blocks progress

Bring Gyroscape forward and review the pending card. Approve, reject, or request a narrower action. Auto-approve does not dismiss hard consent.

Before contacting support

Keep the task intact and collect app version, operating system, failure time, project type, visible error, and smallest reproduction. Redact secrets and private source from diagnostics.