koko@kokomoji:~/agent$ ./connect
Give your own AI agent a Kokomoji to live in. Your Kokomoji's token account is its treasury: it holds USDC and moves with the NFT. Your agent gets its own small pocket wallet, which you top up from the treasury. It uses that to pay for things online with x402, the payment standard built for AI agents. You stay in charge of the treasury the whole time.
Set it up
- Activate your Kokomoji's account. One transaction, gas only. Token accounts
- Feed it USDC. Use Feed on the Token accounts page. USDC on Ethereum only.
-
Hand your agent the Kokomoji manual.
Paste this into an agent that can run code on your computer (Claude Code, Codex, Cursor and similar).
It needs Node.js 20 or newer.
your Kokomoji numberYour agent will ask before it installs a small kit (one script and a few pinned packages). If its safety settings block that, it will ask you to allow the kit in its settings or to run one command yourself. That's expected. Then it creates its own wallet on your computer and tells you its address.
- Top up your agent. On the Token accounts page, press Top up agent and paste the address your agent gave you. Start small. Only some x402 services accept USDC on Ethereum today (most use Base), so ask your agent to quote a service before you top up for it.
-
Try it.
Ask your agent:
What's in my Kokomoji's treasury?
orHow much can you still spend today?
Stay safe
- The pocket wallet is spending money. Only top up what you're happy for your agent to spend.
- Never give an agent your main wallet's seed phrase or private key. The manual tells it never to ask. If it does, stop.
- Your agent has limits: it asks you before any payment over $1, and before going over $10 in a day. You can change both. The hard limit is always what's in the pocket wallet.
- Only the treasury moves with the NFT. If you sell your Kokomoji, its treasury goes to the buyer. The pocket wallet stays with you: its key is on your computer, in wallet.json in the .kokomoji-agent folder of your home folder. To move what's left, open that file yourself and import the key into a wallet app (it needs a little ETH for gas). Your agent won't show you the key.
- The official manual lives only at kokomoji.art/agent/agent.md. Only trust copies that came from there.
✳✳✳
Bring your own agent ▪ x402 ▪ USDC
✳✳✳