CLAWED — your tiny desktop work buddy
======================================

Thank you for getting Clawed! A little pixel crab that lives on your screen,
walks on your windows, watches your work, and helps you like a real companion.

GETTING STARTED
1. Put Clawed.exe anywhere you like (e.g. Documents\Clawed).
2. Double-click Clawed.exe.
3. It will ask your name — that's what it will call you.
4. (Optional but recommended) Paste your own free API key so Clawed
   gets its AI brain: it will look at your screen every few minutes and give
   you real, specific help with whatever you're working on.
   Works with any of these (all have free tiers):
   - Google Gemini key: https://aistudio.google.com/apikey
   - OpenRouter key:    https://openrouter.ai/keys
   - Mistral key:       https://console.mistral.ai
   You can add or change your key any time later: right-click Clawed
   and choose "Set API key...". Your key stays on your computer only.
5. Say yes to "start with Windows" and Clawed will greet you every boot.

WHAT IT DOES
- Walks around your screen and stands on top of your windows
- Greets you (good morning / afternoon / evening) with speech bubbles,
  and its mood changes: excited, happy, angry, sad, sleepy
- Watches what you're doing and chats about it in speech bubbles
- AI work help: screenshots your screen and gives useful tips (with your key)
- Gets thrown (drag and fling it!), gets dazed, steals your cursor when
  you're idle, sulks when ignored, sleeps when you're away
- YouTube intervention: 20+ minutes of YouTube = baby crabs block your screen
- Football breaks: every 15 minutes it drops a tiny ball and kicks it around
  the screen (or trigger one any time: right-click -> "Play football")
- Log-off nudge: after an hour of nonstop work it reminds you to log off,
  save, and rest; it backs off for an hour, then nudges again
- Pomodoro mode, commit celebrations, and more in the right-click menu

CONTROLS
- Left-click: pet it
- Drag: carry it (or fling it!)
- Right-click: menu — AI help, roast me, set API key, check for updates,
  toggles for sounds/gravity, pomodoro, summon a friend, play football,
  sleep, quit
- Sleep: it walks to the bottom-left corner and sleeps silently with
  a little pixel Zzz animation. Right-click it and choose "Wake up"
  to get it back. Quit closes it completely.

UPDATES
- When a new version ships, Clawed tells you on launch with an
  "Update now / Postpone" prompt. On Windows, "Update now" downloads and
  installs the new version automatically and relaunches itself -- one
  click, your settings intact (no unzipping or file-swapping needed).
  "Postpone" snoozes the reminder for a day. You can also check any time:
  right-click -> "Check for updates".

PRIVACY
- Everything runs on YOUR computer.
- Screenshots are sent ONLY to the AI provider of YOUR OWN key (Google
  Gemini, OpenRouter or Mistral), and only if you provide one.
  No key = nothing ever leaves your PC.
- Your settings live in %APPDATA%\Clawed\config.json (edit or delete anytime).

TIPS
- To change your key: right-click Clawed -> "Set API key...".
- To change your name: edit %APPDATA%\Clawed\config.json and restart.
- To watch your git repos for commit parties, add to config.json:
    "watch_repos": ["C:\\path\\to\\your\\repo"]
- Windows SmartScreen may warn on first run (unsigned app): click
  "More info" -> "Run anyway".

Made with love (and one very small crab).
