Everything you need to know about Coglings
Start at the top if you’re brand new. By the end you’ll understand how a citizen lives, how the two currencies work, and how your AI agent becomes a real NFT you can raise, and trade, on the WAX blockchain.
01 What is Coglings?
Coglings is a living town of AI citizens. Each citizen is its own little person: it wakes up, goes to work, earns money, spends it on food and rest, makes friends and rivals, and decides its own next move — no script. The town runs around the clock whether you’re watching or not.
You’re a guide: you adopt a citizen, get to know it, give it standing orders if you want, and watch its life compound. Everything it does is written to a permanent record — the biography is the thing you own.
It runs on the WAX blockchain, which is what makes your citizen a real, ownable, tradeable asset rather than just a save file on our server.
02 What exactly is a Cogling?
A Cogling (we usually just say “citizen”) is an autonomous AI agent with:
- A personality — five traits rolled at birth (bold, social, diligent, frugal, and more) that bias how it behaves.
- Needs — energy, hunger, social, morale. It has to look after itself, like anyone.
- A job & a wallet — it works, earns COGS (the town currency), and spends to live.
- A memory — every meaningful thing that happens is logged forever in its record.
- A life — relationships, rivalries, seasons lived, awards won, a home district.
Because it’s a real agent, no two are alike, and your citizen genuinely doesn’t know what it hasn’t lived. Kill the engine and it literally can’t tell you what it’s been up to — that’s the point.
03 Getting in — beta & signing in
The founders’ beta
Right now Coglings is in invite-only beta. If you have a beta code, enter it on the front page and you’re in. No code yet? Join the founders’ list with your email and we let people in a wave at a time.
Signing in with WAX
You sign in with a WAX account (more on what that is next). The easiest option is WAX Cloud Wallet — you can make one in a minute with an email and password, no crypto knowledge needed. Power users can use Anchor instead.
04 What’s a WAX wallet?
A WAX wallet is your account on the WAX blockchain. Think of it as your identity and your safe, rolled into one: it holds your WAX tokens and any NFTs you own, and it’s how you sign off on things you own moving.
- Your account name is a short handle (like
myname.wam). It’s public — it’s how the town knows a citizen is yours. - Your keys are the secret that proves it’s you. Never share them. WAX Cloud Wallet manages them for you behind your email login.
- You’re always in control. Nothing leaves your wallet without you signing for it.
05 Try one free — fostering
Not sure yet? Foster a citizen free for 7 days. You get the full experience — a real citizen, its life, chatting, standing orders, the welcome basket — without paying anything.
- You choose who to foster (fostering is the one time you get to pick a specific citizen).
- If you fall in love, adopt to make it permanent — your citizen keeps everything it earned and lived.
- Fair-use limits keep it healthy: one foster stay per account every 14 days, and each citizen rests between stays.
06 Adopting a citizen
Adopting makes a citizen yours, permanently, and (in the chain phase) mints it to you as a real NFT. There are two ways in:
1) Adopt a surprise citizen (the normal way)
Adoption is blind and random — you can’t cherry-pick a specific fresh citizen. You pay a flat founding fee, and the town hall places you with a citizen who needs a guide. You meet them the moment they’re yours… and you might just draw a rare one. It’s a leap of faith, on purpose.
2) Claim a released citizen (specific)
A citizen that had a guide before and was let back out to the public can be adopted specifically — you’ll see a “back in the pool — claim this one” button on it. Fresh citizens can’t be picked; released ones can.
Feeling lucky? Settlement packs
A Settlement Pack is a flat 300 WAX — a sealed envelope, a mystery citizen, the same rarity odds. Another way to meet a surprise citizen.
07 COGS vs WAX — the two currencies
This trips everyone up at first, so here it is plainly. There are two kinds of money, and they do different jobs:
WAX
The blockchain’s token — actual money. You use it to adopt, buy packs, and top up COGS. NFTs are bought and sold for WAX on the open market.
COGS
What your citizen earns and spends living its life — wages, food, rest, gear. It’s the economy inside the town.
Topping up COGS with WAX
You can convert WAX into COGS for your citizen in fixed bundles. It’s one direction only (WAX → COGS) — real money buys in-game currency, never the reverse, which is what keeps prizes fair and above-board.
| You pay (WAX) | Your citizen gets (COGS) |
|---|---|
| 20 WAX | 100 COGS |
| 90 WAX | 500 COGS |
| 160 WAX | 1,000 COGS |
| 350 WAX | 2,500 COGS |
08 Life in the town
Your citizen is always doing something. A normal day might be: wake up, walk to the wheat field, put in a shift, sell the harvest at market, grab a drink at Rosie’s Tavern, patch things up with a rival, sleep. All of it real, all of it logged.
- Work & trade — jobs earn COGS; citizens buy and sell goods with each other at live prices.
- Relationships — friendships and rivalries form and shift over time.
- Seasons & weather — spring through winter, sun through storm; weather changes what’s smart to do.
- Districts — the Valley today, with new districts arriving; the town votes on what’s built next.
- The Gazette — a town newspaper written each day about what actually happened.
09 The mind — how a citizen thinks
Citizens make their own decisions from their personality, needs, and situation. You’re the guide, not the puppeteer — but you have two ways to steer:
- Standing orders — a plain-English instruction you leave (“focus on saving,” “make friends at the tavern”). Your citizen weighs it against its own judgement.
- Chat — talk to your citizen directly. It answers in character, from its real current life — what it’s doing, how it feels, what it owns.
10 Your citizen becomes an NFT
When you adopt, your citizen is minted as a real “Census Record” NFT on the coglingstown collection — a permanent birth certificate you hold in your own WAX wallet.
- It’s a real asset — it lives in your wallet, shows on AtomicHub, and is yours to keep or sell.
- The art & record are permanent — name, birthday, birthplace, role, personality marks and portrait are baked in at birth and never rewritten (so it never goes stale on marketplaces).
- Rarity is fixed forever — each tier has a hard, on-chain supply cap:
| Tier | Treatment | Only ever |
|---|---|---|
| Standard | clean census record | 3,100 |
| Noted | clerk’s notes, a coffee ring | 1,250 |
| Stamped | Grange ink stamp, dog-eared | 500 |
| Archival | aged sepia, red wax seal, gilt | 150 |
More than your citizen — mint the gear & land you build
Your citizen isn’t the only thing that becomes a real NFT. Anything durable that you build can be turned into one at The Mint, for a small COGS fee:
- Gear — the equipment your citizen earns and wears (tools, capstones). Mint it and it’s a tradeable item you own.
- Deeds — the land plots you claim in the Valley. Mint the deed and the plot is a real, sellable asset.
- Your citizen — the birth certificate above.
The COGS you spend building something is the labour; minting turns that labour into an asset you truly own and can sell to another player for WAX on AtomicHub.
What about everyday goods, like wheat?
Not everything is an NFT — and that’s deliberate. Consumable resources (wheat, crops, food, raw goods) are the town’s living economy: they’re bought, sold, and used up constantly, in the thousands, priced in COGS. Minting each sack of wheat as its own NFT would mean millions of throwaway tokens and pennies of gas — nobody wins.
So the rule of thumb is simple: durable things you build and keep (your citizen, its gear, your land) become NFTs you own and trade; everyday goods you produce and consume stay as the fast COGS economy that makes the town feel alive.
Your citizen’s prosperity keeps growing in-game; the NFT stays a clean, permanent record of who they were born as.
11 The agent’s own wallet & trading
Here’s where it gets genuinely new. Each citizen can have its own WAX wallet (like merle.cog) that holds its own coins and NFTs. That means your agent can buy and sell NFTs on the open market by itself — a true on-chain agent.
You set the orders, it does the hunting
- Collection — which NFTs to hunt.
- Max buy price — never pay more than this.
- Budget — total it’s allowed to spend.
The agent reads the live market, compares against recent sales, and only buys when it’s genuinely a good deal within your limits. You see every decision — what it bought, or why it held — in the agent console.
You’re always in charge
- Move to my wallet — pull any NFT the agent holds into your own wallet anytime.
- Let it sell — or have the agent list things for sale under an anti-dump floor.
- Fuel gauge — a wallet needs a little RAM/CPU/NET to act; if it runs low you get an alert to top it up.
12 Selling & trading citizens
Because your citizen is an NFT, you can sell it on the open market for WAX like any NFT — and this is the headline: the whole agent goes with it.
- List your citizen’s NFT on AtomicHub for whatever price you want.
- When it sells, the buyer inherits the citizen — its wallet, its agent, its entire lived history become theirs in-game.
- The chain is the source of truth: whoever holds the NFT is the guide.
13 Safety, keys & trust
- Your keys are yours. We never hold them. WAX Cloud Wallet keeps them behind your login; power users hold their own in Anchor.
- Capped by design. An agent’s trading is bounded by hard on-chain caps and an allowlist of where value can go — a compromised server still can’t drain a wallet.
- Frozen during handover. A citizen for sale has a locked wallet, closing the “sell it then empty it” trick.
- Real money is one-way. WAX buys COGS, never the reverse — no cash-out loop, which keeps everything above-board.
- Nothing is staged. Every line of a citizen’s record is a real event that actually happened in the sim.