base on A friend for your desk, a dedicated terminal for numbers # DeskHog: A developer toy for sparking developer joy <img width="992" alt="Screenshot 2025-04-18 at 1 31 29 AM" src="https://github.com/user-attachments/assets/6e5d1fe6-1887-4d66-8497-4b582eb0391a" /> ## What is DeskHog? DeskHog is an open-source, 3D printed, palm-sized developer toy. It's a toy to tinker with, adapt, and to get curious with. We'll be folding in a library of simple example games and apps, including a pomodoro timer and versions of Pong, Rogue, Flappy Bird. You can see PRs for these in this repo now for inspiration! We think that sounds like fun and, if you do too, then DeskHog is for you. ## OK, but what is it? DeskHog packs an Adafruit ESP32-S3 Reverse TFT Feather in a custom-made 3D printed case. It comes complete with a 240x135 color TFT display, a 10-hour battery life, WiFi, and a cute little LED so you can find it in the dark. A [plug-and-play DeskHog hardware kit](https://posthog.com/merch) is coming soon (so you can get everything in one box). In the meantime, here’s what you’ll need if you want to make DeskHog yourself right now. - ESP32-S3 Reverse TFT Feather – [`Adafruit 5691`](https://learn.adafruit.com/esp32-s3-reverse-tft-feather) – buy: [Adafruit](https://www.adafruit.com/product/5691), [DigiKey](https://www.digikey.com/en/products/detail/adafruit-industries-llc/5691/18627502?s=N4IgjCBcoLQBxVAYygMwIYBsDOBTANCAPZQDa4ArAEwIC6AvvYVWSBQGwCcEDQA), [Mouser](https://www.mouser.com/ProductDetail/Adafruit/5691?qs=mELouGlnn3eeALy2e3r3sw%3D%3D), [Botland (EU)](https://botland.store/arduino-compatible-boards-adafruit/22891-feather-esp32-s3-reverse-with-tft-display-wifi-module-4mb-flash-2mb-psram-compatible-with-arduino-adafruit-5691.html), [Cool Components (UK)](https://coolcomponents.co.uk/products/esp32-s2-reverse-tft-feather?_pos=1&_psq=reverse+tft+fea&_ss=e&_v=1.0), [Electromaker](https://www.electromaker.io/shop/product/adafruit-esp32-s3-reverse-tft-feather-4mb-flash-2mb-psram-stemma-qt?srsltid=AfmBOorFfshQCLVi9EDKfmKFKMNC_cE3Ww0NaY0U0evm5ZU2OEM2Yn_B), [BerryBase (EU)](https://www.berrybase.de/en/adafruit-esp32-s3-reverse-tft-feather) - Optional: PKCell 552035 350mAh 3.7V LiPoly battery – buy: [Adafruit](https://www.adafruit.com/product/2750), [Tinytronics (EU)](https://www.tinytronics.nl/en/power/batteries/li-po/pkcell-li-po-battery-3.7v-350mah-jst-ph-lp552035), [BerryBase (EU)](https://www.berrybase.de/en/lp-552035-lithium-polymer-lipo-akku-3-7v-350mah-mit-2-pin-jst-stecker) - 3D printed enclosure – print: [3mf file](3d-printing) ## What can DeskHog do? DeskHog can do a couple of things by default, but the real joy lies in expanding the capabilities by adding them yourself. ### Out of the box functionality A couple of basic [cards](#card-stack) (screens) are included on the firmware and were built by [Danilo Campos](https://posthog.com/community/profiles/31731). - **ProvisioningCard**: Displays a QR code to connect to the device and shows connection stats. - **InsightCard**: Visualizes PostHog data. Still a bit of a WIP, so contributions welcome! - **FriendCard**: Lets Max the hedgehog visit with you and provide encouragement. ### Available games and apps We're working on adding some of the following games to an `/examples` folder which will include a selection of games and apps for you to play with. If you can't see them in the `/examples` folder it's probably because they exist as [unapproved PRs](https://github.com/PostHog/DeskHog/pulls) while we work on them. No problem, just checkout the branch! Example games include: - **Pog**: A Pong clone by [Leon Daly](https://posthog.com/community/profiles/30833) - **IdleHog**: An idle clicker by [Chris McNeill](https://posthog.com/community/profiles/33534) - **One Button Dungeon**: An idle Roguelike by [Joe Martin](https://posthog.com/community/profiles/29070) - **Dictator or Techbro: DeskHog Edition**: A quiz game by [Chris McNeill](https://posthog.com/community/profiles/33534) - **Notchagotchi**: A virtual pet by [Sophie Payne](https://posthog.com/community/profiles/33385) - **Flappy Hog**: A Flappy Bird clone by [Joe Martin](https://posthog.com/community/profiles/29070) - **Hog Speed**: A reaction game by [Chris McNeill](https://posthog.com/community/profiles/33534) - **Pineapple Reflex**: A pizza-based game by [Sophie Payne](https://posthog.com/community/profiles/33385) - **Three Button Dungeon**: An Ultima-like by [Joe Martin](https://posthog.com/community/profiles/29070) Example apps include: - **Awkwardness Avoider**: A smalltalk prompter by [Annika Schmid](https://posthog.com/community/profiles/28619) - **Pomodoro**: A productivity timer by [Annika Schmid](https://posthog.com/community/profiles/28619) All of the example apps were built in 24 hours at [a PostHog hackathon](https://posthog.com/handbook/company/offsites) by people who hadn't coded before at all. These example cards are a testament to [what's possible when vibe coding on DeskHog](#-vibe-coding-with-ai-agents), but some lack polish - so make sure you know [how to reset DeskHog](#buttons-and-reset-sequences). Just in case. ## Developing for DeskHog Review [tech-details.md](tech-details.md) for info on architecture, libraries and key components used in this project. ## Troubleshooting ### No matter what I do, flashing the board doesn't change anything! wtf?? We're actually cutting the storage space in half so that over the air updates can be loaded to the unused half of storage. You can end up in a place where the board just won't boot to the correct partition. To fix this, choose **Erase Flash and Upload** from the PlatformIO Project Tasks menu. ## 🤖 Vibe Coding with AI Agents We couldn't have built DeskHog without Cursor's help, and we encourage agent-driven development with a few caveats. LLMs often struggle with multi-threaded embedded systems. DeskHog’s firmware has strict rules for core/task roles; AI might overlook them unless you guide it. If you're looking to get started, we recommend using [Cursor](https://www.cursor.com/en) with the [PlatformIO extension](https://platformio.org/install/ide?install=vscode). They work well together and you can use Cursor's chat function to start building all sorts of things with natural language. Use `tech-details.md` to give your agent broad context on the device. Still, even with that you should bear in mind the following advice: - You should encourage AI to follow existing patterns: use`EventQueue` for cross-core messaging and update the UI only on the UI task. - Flag any AI suggestions that touch the UI from the wrong core. - Review and test thoroughly—watch for “LLM slop” (unused vars, odd delays) and clean it up. Think of your AI as a speedy junior dev: brilliant but prone to mistakes. You’re the senior dev keeping it on track. With that balance, AI can boost productivity while keeping DeskHog reliable. ## Power off If you want to turn the device off, hold ● + ▼ for two seconds. The device will enter deep sleep mode. To wake the device, press the reset tab on the left. ## UI progress - Status card: working - WiFi provisioning card with QR Code: working - Friend card to give you (mild) reassurance: working - Numeric card for Big Number insights: working - Funnel card: needs a redesign; probably should be horizontal layout instead, won't display more than three steps right now - Line graph card: broken, not properly scaling larger data sets, probably fine if you have an insight scoped between 7-30 days - Other insights: not yet supported ## Request for PRs The following PRs would be interesting, and may earn you a free DeskHog kit or other merch: - Additional insight parsing and visualizations for Insight Card - More games and apps! We think limiting things to one available button prompts creativity - Support for other boards and displays - Enhance the web UI and `ConfigManger` to allow re-ordering of insights, set custom titles per-insight - LLM slop mitigation: if you see anything obviously stupid in this code that hasn't yet been caught and cleaned up - DX improvements around task isolation: if your experience with embedded code says there's a better way to architect this, happy to follow your lead - Improved C++: not my preferred language, feel free to suggest idiomatic and architectural improvements - Desk utilities, like a pomodoro timer; also constrained: center button only. Be creative! - PlatformIO config improvements: flashing builds causes a reboot that seems unnecessary, maybe you know a better configuration - OTA update mechanisms ## Feedback PRs over issues, but if you've got any trouble, feel free to open an issue. You can also contact the maintainer, [email protected]. ", Assign "at most 3 tags" to the expected json: {"id":"14022","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"