[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81456":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":27,"readmeContent":28,"aiSummary":29,"trendingCount":16,"starSnapshotCount":16,"syncStatus":30,"lastSyncTime":31,"discoverSource":32},81456,"PawPause","angziii\u002FPawPause","angziii","可自定义形象的 Agent 桌面宠物 | A local-first pixel companion for breaks, focus, hydration, and agent activity nudges.. For Claude Code, Codex, Hermes and Opencode","https:\u002F\u002Fpawpause.vercel.app",null,"TypeScript",38,8,31,1,0,3,6,7,9,2.86,"Other",false,"main",true,[],"2026-06-12 02:04:15","\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fsocial-preview.gif\" alt=\"PawPause\" width=\"800\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">PawPause\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  A local-first pixel companion for breaks, focus, hydration, and agent activity nudges.\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"docs\u002FGLOSSARY.md\">Glossary \u002F 术语表\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.md\">English\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.zh-CN.md\">中文\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.ja.md\">日本語\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.ko.md\">한국어\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.fr.md\">Français\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.de.md\">Deutsch\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.ru.md\">Русский\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.ar.md\">العربية\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002Freadme\u002FREADME.es.md\">Español\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fangziii\u002FPawPause\u002Freleases\">\n    \u003Cimg alt=\"Downloads\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdownloads\u002Fangziii\u002FPawPause\u002Ftotal?style=flat-square&label=downloads&logo=github\" \u002F>\n  \u003C\u002Fa>\n  \u003Cimg alt=\"Electron\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FElectron-vite-47848f?style=flat-square&logo=electron&logoColor=white\" \u002F>\n  \u003Cimg alt=\"React\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FReact-19-61dafb?style=flat-square&logo=react&logoColor=111111\" \u002F>\n  \u003Cimg alt=\"License\" src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue?style=flat-square\" \u002F>\n\u003C\u002Fp>\n\nPawPause is a macOS and Windows desktop companion. It keeps a small pixel friend on your screen, nudges you to take breaks, reminds you to drink water, helps protect focus sessions, and supports PetDex-style companion imports.\n\n## Features\n\n- **Pixel companion**: transparent, always-on-top, draggable desktop companion with animated states.\n- **Break intervention**: optional screen-block break mode when a reminder is easy to ignore.\n- **Hydration reminders**: water reminders with daily and historical stats.\n- **Custom reminders**: daily reminders with pet countdowns that appear only shortly before they are due, plus optional due-time pet enlargement.\n- **Focus mode**: macOS active-window detection can trigger full-screen distraction nudges for blocked apps or keywords.\n- **Agent activity alerts**: local Codex, Claude Code, OpenCode, DeepSeek TUI, and Hermes events can trigger completion, failure, review-needed, and progress nudges.\n- **Pet imports**: import `pet.json + spritesheet.webp\u002Fpng` folders or zip packages in the app.\n- **PetDex compatibility**: PawPause reads companions installed to `~\u002F.codex\u002Fpets`.\n- **Multilingual UI**: English, Chinese, Japanese, Korean, French, German, Russian, Arabic, and Spanish.\n- **Dark mode**: settings and companion UI adapt to system appearance.\n\n## Install\n\nDownload installers from [Releases](https:\u002F\u002Fgithub.com\u002Fangziii\u002FPawPause\u002Freleases):\n\n| File | Platform |\n| --- | --- |\n| `PawPause-x.x.x-mac-arm64.dmg` | macOS Apple Silicon |\n| `PawPause-x.x.x-mac-x64.dmg` | macOS Intel |\n| `PawPause-x.x.x-win-x64.exe` | Windows 64-bit |\n\nOn macOS, distraction detection and Agent window recognition require Accessibility permission.\n\n## OpenCode Agent Hook\n\nPawPause can consume OpenCode lifecycle events through a small OpenCode plugin:\n\n```bash\nmkdir -p ~\u002F.config\u002Fopencode\u002Fplugins\ncp integrations\u002Fopencode\u002Fpawpause-agent-hook.js ~\u002F.config\u002Fopencode\u002Fplugins\u002F\n```\n\nThe plugin writes JSONL events to `~\u002F.local\u002Fshare\u002Fpawpause\u002Fagent-events\u002Fopencode.jsonl`. You can override that path with `PAWPAUSE_AGENT_EVENTS`.\n\n## DeepSeek TUI Activity\n\nPawPause also watches local DeepSeek TUI activity without a plugin. It reads recent session updates from `~\u002F.deepseek\u002Fsessions` and approval events from `~\u002F.deepseek\u002Faudit.log`, so normal chats, tool use, completion, failures, and permission prompts can move the companion.\n\n## Hermes Agent Hook\n\nPawPause can consume Hermes Agent lifecycle events through a small Hermes plugin:\n\n```bash\nmkdir -p ~\u002F.hermes\u002Fplugins\ncp -R integrations\u002Fhermes\u002Fpawpause-agent-hook ~\u002F.hermes\u002Fplugins\u002F\n```\n\nThen enable it in `~\u002F.hermes\u002Fconfig.yaml`:\n\n```yaml\nplugins:\n  enabled:\n    - pawpause-agent-hook\n```\n\nThe plugin writes JSONL events to `~\u002F.local\u002Fshare\u002Fpawpause\u002Fagent-events\u002Fhermes.jsonl`. You can override that path with `PAWPAUSE_HERMES_AGENT_EVENTS`.\n\nIf the plugin is not installed, PawPause still watches recent Hermes session files in `~\u002F.hermes\u002Fsessions` as a local fallback, so normal chat turns can trigger progress and completion nudges.\n\n### Hermes in WSL + PawPause on Windows\n\nIf Hermes runs inside WSL and PawPause runs on Windows, Hermes must write events to a path that the Windows app also watches. The current PawPause Hermes hook handles this automatically, but if your Hermes process does not load environment variables correctly or PawPause still does not react, hardcode the event path in the WSL plugin.\n\nIn WSL, edit the plugin:\n\n```bash\nnano ~\u002F.hermes\u002Fplugins\u002Fpawpause-agent-hook\u002F__init__.py\n```\n\nReplace the whole `_output_file()` function with:\n\n```python\ndef _output_file() -> Path:\n    # WSL -> Windows PawPause fallback.\n    return Path(\"\u002Fmnt\u002Fc\u002FUsers\u002FAdministrator\u002F.local\u002Fshare\u002Fpawpause\u002Fagent-events\u002Fhermes.jsonl\")\n```\n\nIf the Windows username is not `Administrator`, replace it in the path:\n\n```text\n\u002Fmnt\u002Fc\u002FUsers\u002F\u003CWindowsUserName>\u002F.local\u002Fshare\u002Fpawpause\u002Fagent-events\u002Fhermes.jsonl\n```\n\nThen create the directory from WSL:\n\n```bash\nmkdir -p \u002Fmnt\u002Fc\u002FUsers\u002FAdministrator\u002F.local\u002Fshare\u002Fpawpause\u002Fagent-events\n```\n\nFinally, restart Hermes. The key point is that Hermes writes from WSL into the mounted Windows user directory, and PawPause reads the same event file from Windows.\n\n## Import Companions\n\n### From PawPause\n\n1. Open the PawPause settings window.\n2. Go to the companion page.\n3. Import a folder or zip containing `pet.json` and `spritesheet.webp` or `spritesheet.png`.\n\n### From PetDex\n\n```bash\nnpx petdex install trump\n```\n\nPawPause scans `~\u002F.codex\u002Fpets` automatically, so installed companions usually appear without restarting.\n\n## Run From Source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fangziii\u002FPawPause.git\ncd PawPause\ncorepack enable\ncorepack pnpm install\ncorepack pnpm dev\n```\n\n## Build\n\n```bash\ncorepack pnpm typecheck\ncorepack pnpm build\ncorepack pnpm dist:mac\ncorepack pnpm dist:win\n```\n\n## Project Structure\n\n```text\nsrc\u002Fmain\u002F       Electron main process: windows, tray, timers, focus detection, imports\nsrc\u002Fpreload\u002F    IPC bridge between Electron and React\nsrc\u002Frenderer\u002F   React UI for the companion and settings windows\nsrc\u002Fshared\u002F     Types, defaults, i18n, PetDex state mapping\nlanding\u002F        PawPause landing page deployed to pawpause.vercel.app\ndocs\u002Freadme\u002F    Localized README pages\n```\n\nLarge companion asset packs are intentionally not committed to keep the repository small. Import or install companions locally instead.\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=angziii\u002FPawPause&type=Date)](https:\u002F\u002Fwww.star-history.com\u002F#angziii\u002FPawPause&Date)\n\n## License\n\nSource code is released under the [MIT License](LICENSE). Companion assets may have separate licensing; see [ASSET_LICENSE.md](ASSET_LICENSE.md).\n\n## Acknowledgements\n\nPawPause is built with appreciation for:\n\n- [PawPal](https:\u002F\u002Fgithub.com\u002Fzebangeth\u002FPawPal), the original Electron desktop companion foundation.\n- [PetDex](https:\u002F\u002Fgithub.com\u002Fcrafter-station\u002Fpetdex), the inspiration for the pixel companion package format.\n","PawPause 是一个可自定义形象的桌面宠物应用程序，旨在帮助用户休息、保持专注、提醒喝水，并对代理活动进行提示。其核心功能包括像素风格的桌面伴侣，支持透明、始终置顶和拖动；定时休息和喝水提醒；以及自定义提醒设置。此外，它还具备专注模式，能够检测并阻止分心的应用程序或关键词，同时支持从PetDex导入宠物形象。该应用使用Electron和React构建，界面支持多语言且适应暗黑模式。PawPause特别适合需要长时间面对电脑工作的个人，帮助他们更好地管理时间与健康。",2,"2026-06-11 04:05:09","CREATED_QUERY"]