Extension commands and settings
Updated August 7, 2026
The canonical reference for the extension itself: every Command Palette command, every setting, what lives in the panel instead, and what each status bar state means.
Commands
All under the Awaitful category in the Command Palette:
| Command | What it does |
|---|---|
| Open Panel | The control center: surfaces, consents, patch state, earnings. |
| Sign In | Links this machine to your account via the browser - see Sign in and link your editor. |
| Sign Out | Disconnects the machine; nothing earns to you from it until you sign in again. |
| Pause Earning | Stops all earning immediately and restores Claude Code to its original files - see Turning it off. |
| Resume Earning | Undoes the pause. |
| Open Dashboard | Opens your earnings dashboard in the browser. |
| Visit Sponsor | Opens the current sponsored line's link, exactly like clicking it. |
| About | Version and links. |
Settings
How each ad format looks is set on that format's own page in the panel, not in VS Code's settings: a format only offers what it can actually draw, and each keeps its own choices, so one flat list of settings could not express it. See Choosing where ads appear.
One VS Code setting remains, and it roams with Settings Sync:
awaitful.apiBaseUrl- a server override for local development; leave it empty otherwise.
Two older settings, awaitful.adSpinner and awaitful.adBrandLogo, have been removed. They set one spinner and one logo choice for everything, which stopped making sense once each format kept its own. Pick per format in the panel instead. If either is still sitting in your settings.json, it does nothing and is safe to delete.
Changing how a format looks restyles a live line in place - it never resets the visibility clock in What counts as an impression.
The panel, not settings
Everything stateful lives in the panel rather than settings, per machine: which surface you chose and each surface's consent (see Choose where the line appears), the chat banner's style, the terminal status line's on/off toggle, pause state, and the eye toggle that hides the earned amount from the status bar.
Status bar states
- A key icon - not signed in yet; run Sign In.
- A spinner and a line - your agent is thinking and a sponsored line is showing.
- A quiet marker with an amount - idle, with your unredeemed earnings shown (hide them with the panel's eye toggle).
- Paused - earning is off and your editor is restored; Resume Earning turns it back on.
- Reload to activate - one editor reload is needed after install.
- Offline - the client cannot reach the server; it keeps checking and resumes on its own.
- No agent found - Claude Code is not installed on this machine, so nothing can produce a thinking signal to earn from. Click through for setup.
What a surface card can say
A card never says a surface is working just because the file was patched. Alongside the chosen surface it shows what is actually true right now:
- Paused - something is holding Claude Code's files, or this build is not verified yet. The card names the tool when it is installed, quotes the marker it left when it is not, and offers the fix.
- Unavailable - this machine cannot run the surface at all, for example Claude Code's extension is not installed in this window.
- Not confirmed - applied, and nothing has reported a line on screen yet. Normal until the next time Claude Code thinks with the panel in view.
- Not showing - applied, but nothing appeared across several thinking turns. Earning moves back to the status bar on its own.
- Reload - the panel is running an older copy of Awaitful's change.