Browse the docs

Documentation

Everything about earning while your AI agent thinks - and the receipts behind every claim. Start with one command:

npx awaitfulLooking for a supported editor...Found VS Code.Installing the Awaitful extension...Done. One step left:Open your editor and run "Awaitful: Sign In"from the Command Palette.

Getting started

Install in one commandInstall Awaitful with npx awaitful. One command finds your editor, installs the extension, and you earn while your AI coding agent thinks.Sign in and link your editorLink your editor to your Awaitful account so earnings are credited to you. One sign-in from the Command Palette, approved in your browser.Choose where the line appearsAwaitful shows one sponsored line while your agent thinks: in the status bar, the thinking line, a chat banner, or your terminal. You choose.Your first earningsWhat to expect in your first days on Awaitful: how earnings accrue per verified impression, what a quiet market looks like, and where to watch it.

How it works

How the auction worksAwaitful runs a weighted-share, first-price auction. Every advertiser bid buys a share of voice, and a winner pays its own bid on a verified view.What counts as an impressionAn impression bills only after the sponsored line was visibly on screen while your agent was genuinely thinking. Here is the exact rule, and why.The 70% splitYou keep 70% of what an advertiser pays for a line shown on your machine, credited the moment the impression is verified. Here is where it goes.House ads and quiet marketsWhen no advertiser is bidding, Awaitful serves its own house line. It bills nobody and pays nothing, and it always says so. Here is why it exists.Payouts and your balanceHow Awaitful earnings become withdrawable money: the clearing period, the minimum, United States payouts first, and what happens to your balance meanwhile.

Trust and privacy

What leaves your machineThe complete list of what Awaitful sends: a device token, that an agent is thinking, for how long, and which surface showed the line. Nothing else.Verify it yourselfDo not take our word for anything. The client source, the egress manifest, and the CI test that enforces it are public. Here is how to check each one.Your editor never breaksHow Awaitful patches the thinking line safely: byte-exact backups, atomic writes, verification, and a fail-safe that quietly falls back to the status bar.Turning it offPause earning, restore your editor to its original files, revoke a machine from the dashboard, or remove Awaitful entirely. Every off switch, in one place.

For advertisers

Advertise on AwaitfulReach developers in the one moment they are watching and waiting. One sponsored line, a live auction, and billing only on verified attention.Bidding and budgetsYour bid buys share of voice, not a rank. Your daily budget is a hard cap per UTC day. How Awaitful bidding actually works, with the exact rules.One line, one linkAn Awaitful ad is a sentence and a link, reviewed by a human before it serves. No images, no scripts, and nothing loaded from a third party into an editor.

Troubleshooting

No sponsored line showingThe line only appears while your agent is thinking and the window is focused. Work through the checks: enabled, signed in, surface on, market state.Shown but not creditedA line can render without billing: under the visibility threshold, an unfocused window, a house ad, or a duplicate event. The exact reasons, in order.Thinking line fell back to the status barWhen the thinking-line patch cannot be applied safely, Awaitful leaves your editor untouched and keeps earning in the status bar. What happened and why.

Reference

npx awaitful referenceEvery command and flag of the Awaitful installer: install, status, --editor, --all, --dry-run. Zero dependencies, no network calls of its own.Frequently asked questionsDoes Awaitful read my code? Will it break my editor? How much will I make? What counts as an impression? Straight answers, with receipts.GlossaryThe words Awaitful uses, defined precisely: sponsored line, surface, slate, share of voice, the pot, verified impression, house ad, still clearing.