[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-79922":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":15,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":17,"compositeScore":18,"rankGlobal":8,"rankLanguage":8,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":15,"lastSyncTime":27,"discoverSource":28},79922,"hermes-pets","asimons81\u002Fhermes-pets","asimons81",null,"Python",94,13,87,1,0,2,7,6,3.44,"MIT License",false,"main",true,[],"2026-06-12 02:03:55","# Hermes Pets\n\n![Hermes Pets promo banner](docs\u002Fassets\u002Fhermes-pet-banner-updated.png)\n\nHermes Pets is a local desktop companion for Hermes-style daily work, a small overlay that reacts to commands, messages, briefs, and ambient status events while staying fully controllable from the terminal.\n\nIt exists to make long local coding sessions feel more legible and alive. The pet gives visible feedback when work starts, finishes, fails, needs attention, or goes quiet, without requiring a hosted service or remote account.\n\n## Start here\n\nIf you only want the map, read [`docs\u002FREADME.md`](docs\u002FREADME.md).\n\nIf you want day-to-day use, open:\n- [`OPERATOR_GUIDE.md`](OPERATOR_GUIDE.md) for the short daily operator flow\n- [`CURRENT_STATE.md`](CURRENT_STATE.md) for the current snapshot of what works\n- [`RELEASE_CHECKLIST.md`](RELEASE_CHECKLIST.md) for release prep and verification\n- [`CUSTOM_PETS.md`](CUSTOM_PETS.md) and [`docs\u002Fcustom-pets\u002FREADME.md`](docs\u002Fcustom-pets\u002FREADME.md) for custom pet packages and the curated gallery\n- [`docs\u002Freleases\u002F`](docs\u002Freleases\u002F) and [`release-readiness\u002F`](release-readiness\u002F) for shipped and historical release notes\n\n## Quickstart\n\nInstall from GitHub:\n\n```bash\npip install 'git+https:\u002F\u002Fgithub.com\u002Fasimons81\u002Fhermes-pets.git'\n```\n\nOr, for local development:\n\n```bash\ncd \u003Crepo>\npip install -e .\n```\n\nThen launch the bridge and overlay:\n\n```bash\nhermes-pet launch\nhermes-pet emit bubble \"Hello from Hermes Pets\"\nhermes-pet doctor\nhermes-pet dashboard --no-open\n```\n\nOn WSL and Windows, run the CLI from WSL. `hermes-pet launch` starts the Python bridge in WSL and opens the Electron overlay through the Windows launcher.\n\n## Core commands\n\n```bash\nhermes-pet launch\nhermes-pet launch --replace\nhermes-pet overlay-status\nhermes-pet emit bubble \"Starting work\"\nhermes-pet wrap --name \"Tests\" -- pytest\nhermes-pet jobs --last\nhermes-pet brief --since 24h\nhermes-pet quiet\nhermes-pet mute 30m\nhermes-pet doctor\nhermes-pet doctor --strict\nhermes-pet dashboard --no-open\n```\n\n## What the tool does\n\n- Launch one floating pet overlay from WSL and Windows.\n- Emit lightweight activity events to the overlay.\n- Wrap commands so success, failure, duration, and retry info get recorded.\n- Send message notifications from external channels.\n- Control quiet and mute preferences for bubbles.\n- Generate a short local brief from recent jobs and events.\n- Open a localhost-only, token-protected dashboard for state, custom pets, prefs, voice preview, and achievements.\n- Diagnose bridge, overlay, state, prefs, and job-history health.\n\n## Platform support\n\nWSL2 on Windows 10\u002F11 with Windows interop is the supported platform for the full CLI, bridge, and floating Electron overlay experience. Native Linux, macOS, and native Windows are investigation targets only in Phase 5, so do not treat CLI-only behavior on those platforms as full overlay support.\n\nSee [`docs\u002Fplatform-support.md`](docs\u002Fplatform-support.md) for the supported platform matrix and known blockers.\n\n## Updating Hermes Pets\n\nUse the guarded update command when you want Hermes Pets to inspect or update itself without remembering the git, Python packaging, and Electron overlay steps by hand:\n\n```bash\nhermes-pet update --check\nhermes-pet update --dry-run\nhermes-pet update\nhermes-pet update --yes\nhermes-pet update --no-install\nhermes-pet update --verbose\n```\n\n## Need more detail?\n\nRead the docs map first: [`docs\u002FREADME.md`](docs\u002FREADME.md).\n","Hermes Pets 是一个本地桌面伴侣，旨在为长时间的本地编码工作提供可视化反馈。它通过一个小的浮动窗口对命令、消息、简报和环境状态事件做出反应，并且完全可以通过终端控制。该项目使用Python编写，核心功能包括启动浮动宠物窗口、向窗口发送轻量级活动事件、包装命令以记录执行信息、发送外部消息通知等。此外，还支持静音偏好设置、生成本地简报以及打开仅限本地访问的仪表板来查看状态和自定义宠物。Hermes Pets 适用于需要在不依赖托管服务或远程账户的情况下，使开发过程更加生动有趣的场景，特别是在WSL2与Windows 10\u002F11环境下工作的开发者。","2026-06-11 03:58:31","CREATED_QUERY"]