keepkiwi install

pane pet habits your city

keep kiwi alive.
keep yourself alive.

a small pet that lives in the side panel of your terminal. it gets hungry for the dish you said you'd cook, restless until you walk, dim until you read your 2 hours. it knows the weather outside your window and what your watch saw, so it asks for the walk when the fog lifts and counts the steps you already took.

click the weather chips in the pane. kiwi reacts.

claude · ~/GitHub/tenor
add the credit memo export
Reading memo/export.ts
⎿ 3 edits · 1 test added
Done. The export writes a PDF and a JSON sidecar.
kiwi says walk. is it foggy
58°F, fog lifting by 3pm. Dolores is 12 min on foot. I'll hold the build.
>
KIWI · — HAPPY
pet habits outside
— · kiwi58°F · fog · SF
hi
outside
read
0:42 / 2:00 walk
not yet cook
shakshuka ✓ move
24 min track
4 / 5
life ♥♥♥♡streak 7dage 23d
pet log

how it stays alive

five meters. each one drains on its own clock. you refill them by doing the real thing, and you log it to kiwi the same way you talk to claude.

▰▰▱▱

read 2 hours

a reading timer in the pane. kiwi dims as the day goes on without pages. hit 2:00 and it glows.

log: "read 40 min of Dalio"
⇢ ⇢

take it for a walk

kiwi checks the sky. foggy at 9, clearing at 3? it asks at 3. rain all day? it asks for the gym instead.

log: "walked to Dolores" (or let your phone's steps do it)
◔◑◕

cook the dish

you give it a weekly menu. it gets hungry for shakshuka on wednesday, not "food". cooking something else counts half.

log: "cooked the shakshuka"
↑↓

exercise

30 minutes of anything that raises your heart rate. kiwi does little jumps in the pane for the rest of the day.

log: "ran 5k" / Apple Health sync
☐☑

daily habit list

your 5 daily checkboxes, kept in the pane. 4 of 5 keeps the streak. miss two days and kiwi gets sick.

log: tick them in the pane, or "did all five"
( )
egg
day one. three good days and it hatches
◕‿◕
happy
3 of 5 today. it grows: chick, young, grown
◔_◔
restless
walk overdue, sky is clear
-_-
dim
no reading by 6pm
◉︵◉
upset
the morning after a day you fell behind
x_x
sick
two days under 3 of 5. three and it's an egg again

it lives where you already look

kiwi is a Claude Code mod. it draws in the docked pane beside your transcript, shrinks to one status line when you want the room, and never leaves the terminal.

minimised · status line
kiwi ◕‿◕  read ▰▰▱▱ 0:42  walk ✗  cook ✓  streak 7d  58°F fog

one line under the prompt. the face changes first, so you catch it in the corner of your eye.

nudge · band above the prompt
kiwi fog's lifting. 12 min to Dolores. walk now after this turn snooze 1h

buttons are real. "after this turn" waits for claude to finish, then nags once.

talk to it
/kiwi feed shakshuka
/kiwi read 40
/kiwi walk
or just say it in your prompt. "walked to the park, back to the memo" counts.
what leaves your machine
weather: one call an hour to Open-Meteo, lat/lon rounded.
events: one call a morning to the sources you pick.
nothing else. no account. the pet is a file in your home folder.

it knows what's outside

weather and nearby events drive the asks. not "go outside", but "it's 64 and sunny at 3, and there's a thing at the park".

today · SF · 58°F now, 64°F at 15:00, fog clears 14:40
walk at 3?
sat 11:00 · Alemany farmers market · 1.8 mi
get the tomatoes for the shakshuka
thu 18:30 · run club · Marina Green · 2.4 mi
this counts as exercise and a walk
wed · menu · shakshuka
kiwi is hungry at 18:00

sources on day one: Open-Meteo for weather, your own calendar, and the "what's on" feeds we already parse for SF (funcheap, downtownsf). more cities when people ask.

install

it's a Claude Code mod. three lines in your terminal, then /kiwi inside Claude Code. first run shows the egg and asks three questions: your daily habits, a checkpoint, the now-and-then list.

terminal
claude plugin marketplace add bsssm/keepkiwi claude plugin install kiwi@keepkiwi claude # then, inside: /kiwi

needs Claude Code 2.1.287 or later. edits to the mod folder reload with /reload-plugins. uninstall with claude plugin uninstall kiwi@keepkiwi.

your watch · apple watch now, whoop next
a Shortcut on your iPhone writes one small file to iCloud twice a day: steps, sleep hours, workout minutes, resting heart rate. kiwi reads it. 6,000 steps marks the walk done; workout minutes fill the move meter; sleep shows in the pane.

the 2-minute Shortcut recipe is in the guide. whoop comes through its api in kiwi+.

pricing

the pet is yours either way. pick how you want to get it.

$9

build it yourself

one payment. you get the full prompt: every working api call, the lifecycle rules, the pane layout, the sprite technique, the setup flow, the watch and weather inputs, the tests, and the eight mistakes that cost us hours. paste it into Claude Code and make your own creature.

one time · the prompt is yours forever
get the prompt
$5/mo

kiwi+

plugged into us. weekly updates and upgrades: new creatures, your city's events feed, whoop sync, sync between machines, a phone companion for walks. cancel any time, the pet stays.

monthly · opens with the first update
tell me when it opens
free

the mod

the install above. everything on this page: the egg, the meters, the weather, the watch file, the pane. source on GitHub, MIT.

always · nothing leaves your machine
install

faq

what counts as a good day?

3 of 5 meters full: your reading hours, the walk, the menu dish, your exercise minutes, your habits (all but one ticked). three good days in a row hatch the egg. one bad day makes it upset the next morning. two in a row and it's sick, three and it's an egg again.

does it nag?

no. it asks once when the moment comes: the sky clears, a checkpoint passes, a now-and-then item is overdue. there's a snooze and a hide on every ask. it stays quiet while claude is working.

what leaves my machine?

one weather call an hour to open-meteo with your coordinates rounded. nothing else. the watch file is on your own icloud. there is no account.

does it cost tokens?

no. kiwi runs on timers and a tiny state file. it only asks claude for words when you talk to it, and that goes through your normal session.

what if i close the terminal?

the clock keeps running. kiwi remembers across sessions. it does not die while you sleep, only when you skip days.

can it be mean?

it can be honest. "you said 2 hours. it's 0:42 and it's 9pm." you pick the tone: soft, dry, or coach.

why a bird?

a kiwi can't fly. it has to walk. same as you.

contact

one person, one inbox. questions, a bug, your pet's screenshot.

email
hi@keepkiwi.com

or open an issue on github.com/bsssm/keepkiwi.