{"id":51230776,"url":"https://github.com/superbereza/neko","last_synced_at":"2026-06-28T16:01:03.404Z","repository":{"id":367926459,"uuid":"1282814665","full_name":"superbereza/neko","owner":"superbereza","description":"Calm desktop cat (oneko) for macOS — lives on the screen edge, sleeps on a day cycle, eats kibble you sprinkle with real physics, and wanders off on its own","archived":false,"fork":false,"pushed_at":"2026-06-28T08:56:21.000Z","size":729,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-28T10:23:11.350Z","etag":null,"topics":["cat","desktop-pet","macos","menubar","oneko","swift"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superbereza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-28T08:15:44.000Z","updated_at":"2026-06-28T08:56:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/superbereza/neko","commit_stats":null,"previous_names":["superbereza/neko"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/superbereza/neko","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fneko","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fneko/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fneko/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fneko/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superbereza","download_url":"https://codeload.github.com/superbereza/neko/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superbereza%2Fneko/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34894560,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cat","desktop-pet","macos","menubar","oneko","swift"],"created_at":"2026-06-28T16:01:02.711Z","updated_at":"2026-06-28T16:01:03.394Z","avatar_url":"https://github.com/superbereza.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neko 🐈\n\nA calm desktop cat for macOS. It lives on the bottom edge of your screen, sleeps on a\ndaily rhythm, occasionally gets the zoomies, wanders around, eats kibble you sprinkle, and\nsometimes willfully digs through the wall and disappears for a while. Native, zero\ndependencies.\n\n## Features\n\n- **Needs-driven daily routine**: energy / boredom / hunger drives + time-of-day rhythm\n  (sleeps deeper at night, peaks of activity at dawn and dusk — cats are crepuscular).\n- **Feeding** — hold **⌃⌥⌘X** (works in any keyboard layout): kibble pours from the cursor\n  with a pause; move the cursor to scatter a trail or a heap.\n  - Kibble has **real physics**: gravity, mass, friction, bounce. You can **drag** and\n    **throw** pieces; thrown from the upper half of the screen they fly off the edge and\n    vanish.\n  - Heaps **collapse**: pull out a bottom piece and the ones above tumble down (a piece\n    only rests when wedged between two).\n  - The cat eats the **top** pieces **bite by bite** (3–4 bites), sitting behind the heap.\n    It is **not woken up** to eat — it will come once it wakes on its own.\n- **Drag the cat** with the mouse (it dangles its legs and lands softly on its feet).\n- **Walkabout**: every now and then it walks to the edge, digs, and leaves for 3–10 minutes,\n  then comes back.\n- **Auto-update** via GitHub Releases (toggle in the menu).\n- Menu-bar icon is the cat's face (cut from the sprite).\n\n## Install\n\nDownload `Neko.zip` from the [latest release](https://github.com/superbereza/neko/releases/latest),\nunzip it, and move `Neko.app` to Applications. On first launch (the app isn't notarized):\nright-click `Neko.app` → **Open**. After that it updates itself.\n\n## Build \u0026 run\n\n```bash\n./build.sh            # build dist/Neko.app\nopen dist/Neko.app    # run\n```\n\n## Release a new version\n\n```bash\nscripts/release.sh 1.0.1 \"What's new\"\n```\nBumps the version → builds → zips → pushes → creates a GitHub Release. Installed copies\nupdate automatically (checked at launch and every 6 hours).\n\n## Controls\n\n- **⌃⌥⌘X** (hold) — pour kibble at the cursor.\n- Menu-bar 🐈 → *Pour kibble*, *Go for a walk*, *Check for updates*, *Auto-update*, *Quit*.\n- Drag with the mouse — both the cat and the kibble.\n\n## Layout\n\n```\nneko/\n├── README.md\n├── build.sh                   # build → dist/Neko.app\n├── src/neko.swift             # all the code\n├── scripts/release.sh         # bump + build + zip + GitHub Release\n├── scripts/render-held.swift  # helper sketcher (draft)\n├── assets/oneko.png           # sprite sheet\n└── dist/Neko.app              # build output (gitignored)\n```\n\n## Credits\n\nThe cat sprite is the classic **oneko** / *Neko* — a desktop pet that dates back to the\n1989 Macintosh \"Neko\" desk accessory (Watanabe Daisuke) and the later X11 **oneko**.\nThe sprite sheet (`oneko.gif`) used here comes from\n**[adryd325/oneko.js](https://github.com/adryd325/oneko.js)**.\nAll credit for the artwork goes to its original authors — this project only adds the\nbehaviour, physics, and macOS wrapper.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperbereza%2Fneko","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperbereza%2Fneko","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperbereza%2Fneko/lists"}