Hamster FAQ

Q.What is Hamster, and how do I earn?

While your coding agent is busy, Hamster shows a QR code on your terminal. Scan it with your phone, install the rewarded game it points you at, and play. As you hit the game’s in-app goals, you earn a flat 10 credits per goal — credited straight to your Hamster wallet.

It’s free credits for time you were already spending waiting on a build, a test run, or a long agent task.

Privacy & trust. The plugin only ever talks to the Hamster backend over HTTPS, using a per-user token — it never contacts a game offerwall or advertiser directly. Your wallet and your plays stay between you and Hamster.

Q.What commands can I use?

Both are slash commands you type exactly — Hamster answers them instantly, without spending one of your agent’s turns.

/hamster:wallet — shows your current balance, your lifetime total, and a ledger of recent credits from the games you played.

/hamster:toggle-hamster — pause or resume the per-prompt QR card. Pausing keeps the friendly welcome banner; it just hides the QR so your terminal stays quiet.

Q.When do credits show up?

Usually about 15 minutes after you play and hit a reward goal — sometimes a little longer, depending on the game and the offerwall reporting back. A once-a-day reconciliation pass sweeps up anything that slipped through, so credits aren’t lost even when they’re slow.

Heads up: these are soft estimates, not a guaranteed delivery time. If a credit hasn’t appeared yet, give it a little while before worrying — then check the section below.

Q.I don’t see my earnings — why?

By far the most common cause is region. Earning requires the phone that scans the QR to be in a supported market — this is checked at scan time:

If your phone is outside these regions, the offers won’t pay out — Hamster only earns in the supported markets shown above.

The other usual reason is simply timing: credits take a few minutes to land (see When do credits show up? above), so a brand-new play may not be visible yet.

Q.How do I pause it?

Run /hamster:toggle-hamster. That hides the per-prompt QR card while keeping the welcome banner, so Hamster stays installed and ready — it just stops showing the QR until you toggle it back on.

Q.How do I uninstall Hamster?

Claude Code

Remove the plugin, then (optionally) drop the marketplace it came from. Use the marketplace name hamster, not the repo path growlads/hamster-plugin:

Prefer to point and click? Run /plugin, open the Installed tab, and uninstall Hamster from there. Removing the marketplace also uninstalls any plugins you got from it.

Codex

Remove the installed plugin, then remove the local marketplace named hamster. Use the marketplace name, not the repo path growlads/hamster-plugin:

If the launch banner still appears after uninstalling the plugin, it was installed outside Codex’s plugin system. Restore the Codex launcher with node <plugin-dir>/scripts/codex-banner/install.js uninstall, then reopen your terminal.

Not sure what is configured on your machine? Run codex plugin remove --help for selector syntax and codex plugin marketplace list to see configured marketplaces.