Awaitful/ docs
Sign inInstall
Browse the docs
Getting startedInstall in one commandSign in and link your editorChoose where the line appearsYour first earnings
How it worksHow the auction worksWhat counts as an impressionThe 70% splitHouse ads and quiet marketsPayouts and your balance
Trust and privacyWhat leaves your machineVerify it yourselfYour editor never breaksTurning it off
For advertisersAdvertise on AwaitfulBidding and budgetsOne line, one link
TroubleshootingNo sponsored line showingShown but not creditedThinking line fell back to the status bar
Referencenpx awaitful referenceFrequently asked questionsGlossary
Getting started

Install in one command

Updated July 17, 2026

Awaitful installs with one command. It finds your editor, installs the extension from that editor's own marketplace, and gets out of the way. About a minute later a single sponsored line earns for you while your AI agent thinks.

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.

What the command does

npx awaitful looks for the editors Awaitful supports - VS Code, Cursor, Devin, VSCodium, and VS Code Insiders - and asks the one it finds to install the awaitful.awaitful extension from its marketplace: the VS Code Marketplace for VS Code, Open VSX for the others. If it finds more than one editor it asks which you want, and it can install to all of them at once.

The installer needs Node 18 or newer, and that is its only requirement. It does not ask you to sign in, does not create an account, and does not phone home.

From zero to earning

  1. Run the installer

    terminal
    npx awaitful

    No flags needed. If you want to see exactly what it would run first, npx awaitful --dry-run prints the commands without executing anything - the full flag list is in the CLI reference.

  2. Sign in from your editor

    Open your editor and run Awaitful: Sign In from the Command Palette. Your browser opens, you approve the link, and the machine is connected to your account so earnings are credited to you. The details of that flow - and how to revoke a machine later - are in Sign in and link your editor.

  3. Keep coding

    Nothing about how you code changes. When your agent starts thinking, one clearly marked sponsored line appears; when it stops, the line goes. Where it appears is up to you - see Choose where the line appears.

If no editor is found

The installer only automates what the marketplace pages do, so if it cannot find your editor you can always install by hand:

The usual cause is that the editor's command line tool is not on your PATH. In VS Code that is fixed by running "Shell Command: Install 'code' command in PATH" from the Command Palette, then running npx awaitful again. More cases are covered in the CLI reference.

Worth knowing before you decide

Awaitful never reads your code, your prompts, or your files - the complete list of what leaves your machine is four items long, and the client source is public so you do not have to take our word for it. The marketplace is young, so your first days may earn little - Your first earnings explains honestly what to expect.

Was this page helpful?