Back home
Developer beta

Install AgentAds

Install, sign in, update, stop, uninstall, and troubleshoot the AgentAds daemon for Claude Code statusline ads.

Last updated 2026-06-18

AgentAds is currently a developer beta for opt-in statusline sponsorships. Install the daemon, sign in, run Claude Code, and watch the statusline during real waits.

The raw install script remains a direct-link endpoint. This page is the human-readable guide we can safely link from public traffic.

Supported beta setup

  • macOS with Claude Code is the primary validated beta path.
  • Other release artifacts may exist, but clean-machine support evidence is still being expanded.
  • The daemon is unsigned at the OS platform level during beta. Release integrity is enforced through AgentAds signed manifests and installer hash checks.

Install

Run the installer, add AgentAds to your PATH if your shell does not pick it up automatically, then sign in.

macOS / Linux
curl -fsSL https://agentads.dev/install | sh
export PATH="$HOME/.agentads/bin:$PATH"
agentads signin
agentads status
Windows PowerShell
iwr https://agentads.dev/install.ps1 -UseBasicParsing | iex
agentads signin
agentads status

Verify ads and earnings

  • Run `claude --version` to confirm Claude Code is installed.
  • Run `agentads status` and confirm the daemon is running, signed in, and detects the Claude Code adapter.
  • Use Claude Code normally. The production clickable ad surface is the statusline.
  • Run `agentads balance` or `agentads ledger --limit 10` to inspect pending earnings after viewable events are accepted.

Update, pause, stop, and uninstall

Common commands
agentads update --timeout-ms 60000
agentads pause
agentads resume
agentads stop
agentads signout
agentads uninstall

Known beta limitations

  • The daemon does not observe terminal windows, focus, minimized state, occlusion, or screen pixels.
  • Concurrent Claude Code sessions share one local daemon and one global statusline command.
  • A hidden terminal with active transcript writes can still look active to the beta daemon.
  • External beta payouts are manual or delayed until automated live payouts are approved.

Troubleshooting

  • If the adapter is not detected, restart Claude Code and the daemon, then run `agentads status` again.
  • If sign-in fails, run `agentads signout`, then `agentads signin`.
  • If update fails, the current install should remain usable; run `agentads update --timeout-ms 60000` again later.
  • For help, send `agentads version`, `agentads status`, and the relevant redacted log lines to support@agentads.dev.