§ friends / bluetooth le · offline · no account

Gotchis make friends.

Take your gotchi to the office, a meetup or a conference. When two gotchis meet, they notice each other over Bluetooth, earn XP, and can become friends with two taps. Friends unlock badges and accessories, and working side by side pays a bonus.

Pixel's display: Mochi and I are friends now!Mochi's display: New friend: Pixel!
Fig. F1 — two displays, one friendshippixel ♥ mochi

v0.5.0Friends, XP for encounters, badges and accessories are built into the app. The Bluetooth radio has only been tested in the simulator so far, not yet on real hardware. The community site at the end of this page is a plan.

§ 01 / how it works

Meet, befriend, both sign.

Gotchis talk in tiny Bluetooth LE advertisements. No pairing, no connection, no app and no server: just two gadgets that hear each other.

  • Beacon. Every gotchi sends a short beacon with a random id that changes every 15 minutes, plus its level, mood and accessory. Strangers can't follow it around.
  • Encounter. Thirty seconds close to another gotchi count as a meeting. Both earn XP, and the critter waves.
  • Card. Only when you switch on Open for new friends does your gotchi also send its card: name, level and public key, signed.
  • Friendship. You press Befriend, the other owner presses Accept. Each gotchi signs the friendship, and the two signatures together are a proof no one can fake.
  • Friend tag. From then on the two recognise each other by a secret tag only friends can compute: the display shows ♥ instead of ●.
PIXELYOU · LV3MOCHINEXT DESK · LV4BEACONrandom id, new every 15 min · level · mood · accessoryopen for new friendsCARDname · level · public key, signed30 S CLOSE BY = ENCOUNTER+20 XP each · again on another day +5 · anonymous +2you press BefriendOFFERsignature over both keys and today · secret friend tag, encryptedscreen: Pixel wants to be friendsowner presses AcceptOFFERthe same, signed by MochiTWO SIGNATURES = FRIENDSHIP PROOF+30 XP each · badge First friend → bowBEACON + FRIEND TAGonly friends can read it: ♥ instead of ●BOTH WORKING, CLOSE BY+10 % XP while it lasts · badge Co-working → glassesonly game data on air: never prompts, code or folder names
Fig. F2 — an encounter, packet by packetbluetooth le advertising
§ 02 / try it

Two gotchis, one desk apart.

You are Pixel, level 3, busy in my-app. Mochi sits at the next desk. Play through what happens when they meet. The displays are rendered by the same code as the real device.

pixel · you
Pixel's display
Lv3270 / 300 xp
mochi · next desk
Mochi's display
Lv4420 / 500 xp
# nothing yet: Pixel and Mochi are out of range

In the demo time runs fast and the critters put on new accessories by themselves. On a real gotchi you pick the accessory on its social page.

§ 03 / the game

Where the XP comes from.

Most XP still comes from your work with Claude Code. Friends add to it, with a daily cap so nobody farms a conference hall.

WhatXP
finished reply10
pull request · push · commit15 · 8 · 5
completed task · new session · tool call5 · 3 · 1
meet a gotchi for the first time20
meet it again, on another day5
an anonymous gotchi passes by2
a new friend30
a friend nearby is working too+10 %

Encounter XP is capped at 100 a day; friendships are not.

Levels get further apart as the critter grows. Every day with at least one finished reply extends the streak.

Lv250
Lv3150
Lv4300
Lv5500
Lv6750
Lv71050
§ 04 / badges and accessories

Dress up the critter.

Badges come from meeting people, making friends and keeping at it. Some badges and levels unlock an accessory, which other gotchis see in your beacon.

critter with a cap
capreach level 3
critter with a bow
bowbadge First friend
critter with glasses
glassesbadge Co-working
critter with headphones
headphonesreach level 5
critter with a night cap
night capbadge Night owl
critter with a party hat
party hatbadge Conference
critter with a crown
crownbadge Popular
BadgeHow to get itUnlocks
Hello worldmeet another gotchi
First friendbecome friends with a gotchibow
Social butterflyhave 5 friends
Popularhave 10 friendscrown
Conference5 gotchis nearby at onceparty hat
Co-workingwork while a friend nearby works tooglasses
Night owlfinish a reply between midnight and 4 amnight cap
On a rolla 7-day streak
§ 05 / private by design

Social, but not tracked.

01 anonymous

Anonymous by default

The beacon carries a random id that changes every 15 minutes. Without your card, nobody knows whose gotchi it is or can follow it.

02 key

The key is the profile

On first start the gotchi creates its own key pair. No sign-up, no password, no account anywhere.

03 on air

Only game data

Level, mood, accessory, name and signatures. Never prompts, code, folder names or anything about your sessions.

04 backup

Yours to keep

Identity, friends and progress live on the SD card. A backup, encrypted with your passphrase, moves them to a new card or gotchi.

05 off

Off with one switch

Meet other gotchis on the settings page turns Bluetooth off completely.

06 proof

Proof without trust

A friendship is two signatures. Anyone can check it later, without trusting a server or the other person.

§ 06 / what's next

From the desk to a community.

Everything so far works offline. The friendship proofs are made so that a community site can build on them later.

  1. 01 identitykey pair, profile, backup
  2. 02 encountersbeacons, gotchis nearby
  3. 03 friendstwo taps, two signatures
  4. 04 gameXP, badges, accessories
  5. 05 community sitesign in with your gotchi, profile, friend list
  6. 06 chatend-to-end encrypted, only between friends you have met
  7. 07 communitygroups, events, opt-in leaderboards