Skip to main content

​
Task won’t start

Task containers usually start within 60 seconds (up to 3 minutes for custom workspace images). If a task is stuck:
  1. Check your CU balance — you can’t start tasks with a depleted balance
  2. Check your active task limit — Free and Pro plans allow 20 active tasks; archive or complete old tasks to free up slots
  3. Try again — transient infrastructure issues occasionally delay container creation. Create a new task with the same prompt
  4. If the issue persists, check the Whim status page or contact support
This usually indicates a problem with the workspace image or environment:
  • Custom workspace image build failure — check the image build logs in Settings → Workspace Images for errors
  • Missing dependencies — ensure your workspace image includes the tools your task needs
  • Repository access — verify the GitHub App is installed and has access to the repository

​
Terminal issues

If the terminal pane appears blank or shows a connection error:
  1. Refresh the page — this re-establishes the terminal connection
  2. Check your internet connection — the terminal requires a stable WebSocket connection
  3. Try a different browser — some browser extensions can interfere with WebSocket connections
  4. Disable VPN — some VPNs block WebSocket traffic
Brief disconnections are normal when switching tabs (especially on Safari). Whim automatically reconnects when you return. If disconnections are persistent:
  • Check your network stability
  • Ensure your browser tab isn’t being aggressively suspended (disable tab sleeping/discarding in browser settings)
  • Try a wired connection instead of Wi-Fi

​
Git issues

Git operations require the GitHub App to be installed with the correct repository permissions:
  1. Go to Settings → GitHub and verify the GitHub App installation is active
  2. Ensure the app has access to the specific repository you’re working with
  3. If you recently changed repository permissions on GitHub, reconnect the integration in Whim settings
If the issue persists, the GitHub App installation token may have expired — try removing and re-adding the GitHub integration.
Each task runs on its own isolated branch. If you see merge conflicts when the task tries to push:
  • The base branch may have been updated since the task started
  • Fork the task to retry with a fresh branch based on the latest code
  • Use the terminal to manually resolve conflicts if needed

​
AI provider issues

If an AI provider is unreachable:
  • Check provider status — Anthropic, OpenAI, and OpenRouter each have their own status pages
  • Try a different model — create a new task with an alternative provider
  • Check CU balance — some provider errors occur when the CU balance is too low to cover the request
If the AI agent isn’t making progress:
  • Send a follow-up prompt — sometimes the agent needs guidance to continue
  • Check the terminal — the agent may be waiting for input or confirmation
  • Fork the task — create a fresh attempt with a more specific prompt
  • Whim detects stuck agents (idle for over 2 minutes) and can alert you via browser notifications

​
CU balance issues

Check your usage breakdown in Settings → Usage to see exactly which tasks consumed CUs. Remember:
  • CUs combine container runtime and token usage — a task that ran for 10 minutes but processed many tokens can consume more CUs than expected
  • Reserved machines consume 3 CU/week each
  • CU periods reset weekly from your subscription anchor date, not on a fixed day
Check if you’ve hit your active task limit (20 for Free/Pro, 40+ for Max). Complete or archive finished tasks to free up slots.

​
Browser notifications

  1. Check Settings → Notifications — ensure the master toggle and relevant type toggles are on
  2. Check your browser permissions — you may have blocked notifications for whim.run
  3. Remember that notifications only fire when the Whim tab is not in focus
  4. On macOS, ensure notifications are enabled for your browser in System Settings → Notifications
Whim can’t re-prompt for notification permission once denied. To reset:
  • Chrome: Click the lock icon in the address bar → Site settings → Notifications → Allow
  • Firefox: Click the lock icon → Clear permission for notifications
  • Safari: Safari → Settings → Websites → Notifications → find whim.run → Allow

​
Mobile

Whim is optimized for desktop browsers. On mobile devices:
  • The terminal view may be difficult to interact with on small screens
  • File drag-and-drop is not available — use the file picker instead
  • Browser notifications may behave differently depending on your mobile OS
For the best experience, use Whim on a desktop or laptop browser.