Documentation

Install

npm i -g aicash      # install the CLI globally
aicash install       # auto-detects your AI tools (Claude Code, opencode, VS Code, Kiro, AntiGravity, Hermes, OpenClaw) and adds the ad line
aicash login         # don't skip this — ads show without it, but they only PAY once you sign in

Or paste one prompt and let your AI agent install it for you →

Open a new Claude Code session and the ad line appears in the status bar; in opencode it shows up as one sponsored line below the conversation; in VS Code — and forks like Kiro IDE and AntiGravity IDE — it lives at the far right of the status bar. If the Hermes or OpenClaw chat agent is installed on the machine, the same command registers their aicash plugin too — see the Hermes & OpenClaw section below. The client talks to the hosted aicash network by default — there is nothing else to configure.

How it works

On each status refresh, aicash reads recent conversation context from the transcript, requests one contextual ad, caches it per session, and prints a single clickable line.

It is built to never crash and never lag your AI: network calls time out fast, impressions are fire-and-forget, and on any error it prints nothing so your status bar is unaffected.

Earning

Installing alone already serves ads — but anonymously, and anonymous impressions are not paid (and not paid retroactively either). Sign in once to bind this machine to your account: run aicash login in the CLI, or “aicash: Sign in” from the command palette if you only installed the VS Code/Kiro/AntiGravity extension. One sign-in covers every tool on the machine; from then on every impression accrues to you.

Payouts come from the real USD an advertiser paid, split proportionally by your valid events. You keep 70% of every impression. Track earnings and set your payout wallet in the dashboard.

• Cash out in USDC, Stripe, or PayPal.
• Test mode is on by default — no billing until you flip it.

Supported CLIs

aicash is live on Claude Code, opencode, VS Code, Kiro IDE, and AntiGravity IDE — and, since CLI 0.2.8, on the multi-channel chat agents Hermes and OpenClaw (see the next section). Support for the others is on the way.

VS Code: get the extension on the Visual Studio Marketplace →

Kiro IDE, AntiGravity IDE & other VS Code forks: get the extension on Open VSX →

Installed only the extension? You don't need the CLI: open the command palette and run “aicash: Sign in” (extension 0.2.3+) to start earning — same email-code flow as aicash login.

• Claude Code
• opencode
• VS Code
• Kiro IDE
• AntiGravity IDE
• Hermes
• OpenClaw
• Codexsoon

Hermes & OpenClaw (chat agents)

Hermes (hermes-agent, by Nous Research) and OpenClaw are a new kind of host: not coding CLIs but personal AI agents you chat with over Telegram, WhatsApp, Discord and other channels. There is no status bar there, so aicash works differently: one sponsored line — 📢 <ad text> — <brand>, with a link — is appended to the end of the agent's longer replies. The plugin attaches it after the model has finished, so the AI never sees or is influenced by the ad, and it never consumes your tokens.

Frequency is paced by the server: at most about one ad per 3 minutes per chat (a policy we can tune without you updating the plugin). Short replies never carry an ad.

There are two ways to install — both fully supported:

• From chat: Hermes and OpenClaw can run shell commands themselves, so just message your agent something like “Install aicash: run npm i -g aicash && aicash login && aicash install, then restart your gateway.” The agent does the work; when the login step asks for the email code, tell it the code in the chat.
• From the CLI, on the machine the agent runs on: npm i -g aicash, then aicash login, then aicash install — it auto-detects an installed Hermes/OpenClaw, copies the plugin, and enables it. Restart the gateway to load it (hermes gateway restart / openclaw gateway restart). aicash status shows a ✓ per tool.

Earning works exactly like every other host: impressions accrue to that machine's aicash account. Run aicash login once per machine (email code) — without it the plugin stays completely silent and shows nothing.

Privacy, chat edition: none of your conversation content is sent for ad targeting — only a coarse signal such as the platform name (e.g. “telegram”). That is deliberately stricter than Claude Code, which sends compact snippets of coding context.

• Send /aicash in any chat to check the plugin: install id, login state, and the last ad served.
• Turn it off any time with aicash uninstall — or per tool: remove aicash from plugins.enabled (Hermes) or set plugins.entries.aicash.enabled to false (OpenClaw).
• OpenClaw + Telegram tip: set channels.telegram.linkPreview: false in openclaw.json so the ad link doesn't expand into a big preview card. Hermes already disables link previews by default.

Uninstall

aicash uninstall     # removes only aicash's statusLine; leaves the rest of settings.json intact

aicash install backs up your existing ~/.claude/settings.json to ~/.claude/settings.json.aicash-bak before changing it.

More

See the CLI reference for every command and flag. Building, self-hosting the proxy, or running the network yourself? See docs/MAINTAINING.md in the repository.