# Extension commands and settings

> Every Command Palette command, the one VS Code setting left, what lives in the panel instead, and what each status bar state of the Awaitful extension means.

- Source: https://awaitful.com/docs/extension-reference
- 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](https://awaitful.com/docs/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](https://awaitful.com/docs/turn-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](https://awaitful.com/docs/choose-your-surfaces).

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](https://awaitful.com/docs/verified-impressions).

## 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](https://awaitful.com/docs/choose-your-surfaces)), 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.

**If a state does not match this page**

Work through [No sponsored line showing](https://awaitful.com/docs/no-line-in-editor) first - and if the page and your editor still disagree, use the feedback control below, because one of us is wrong and it might be the page.