Forklings

Forklings

A pocket pet for developers. Raise it, dress it, coach it, and it battles on its own.

GitHub is used for your name only. Forklings never reads your repos or activity.

Pick any handle to play now. It isn't checked against GitHub, it's marked unverified on the leaderboard, and the pet lives in this browser's session.

An egg, just for you

Its seed comes from your handle, this exact second and a secret salt, so nobody can predict a hatch.

Wardrobe

Head, face and neck are cosmetic. A held item gives a small battle edge (at most +6% to one stat). Tap and hold an item to see it.

Coach, don't control

Battles run on their own, using the plan you set here. Your Forkling follows it even when you're away.

High: keeps attacking. Low: braces with Code Review more often, which halves the next hit and powers up its next attack.

Signature move
Style

Battle log

Other players can challenge your Forkling while you're away. Replays re-run from the battle seed.

    Leaderboard

    Ranked

    GitHub players whose account is at least 30 days old, plus the house NPCs. Rating moves fully between players and only a little against house bots.

      Unranked

      Demo players and newer GitHub accounts. They battle NPCs and house bots without a rating, so this list is by wins.

        API tokens

        For tools such as a future Claude Code, Pi or Codex integration. Send Authorization: Bearer fk_… to the JSON API.

          Endpoints

          GET  /api/me                 your Forkling, needs and wardrobe
POST /api/care      {"action":"feed"|"play"|"pat"|"nap"}
POST /api/equip     {"slot":"head","item":"beanie"|null}
POST /api/tactics   {"aggression":60,"special":"open","healAt":25,"style":"balanced"}
POST /api/battle               fight now, returns the outcome and replay seed
GET  /api/battles              your battle log
GET  /api/battles/:id          replay: seed + both snapshots
GET  /api/leaderboard
          Home Coach Battle Ranks API