xjxandgd-ops
72c66a67fb
## Summary
- restore release-preparation context on `main` pushes only when typed
validation scope reports an exact `CHANGELOG.md` change
- make primary cold launch converge on the shared control-center
presenter and retain fronting until the SwiftUI window is registered
- add control-plane, lifecycle, and race-regression coverage for both
release blockers
## Validation
- `python3 script/tests/test_validation_tooling.py` (53 passed)
- `python3 script/development_domains.py validate`
- `./script/validate_build_scripts_safety.sh --static-only`
- `./script/validate_app_lifecycle_contract.sh` (12/12 passed)
- `./script/validate_swift_tests.sh --scope all` (745 passed)
- `./script/validate_pre_push.sh`
- `./script/changelog_fragments.py policy --base-ref origin/main
--release-preparation true`
## Release note
This amends the still-unpublished v0.4.3 release preparation. The exact
merged `main` commit will receive the mandatory host UI acceptance
before release dispatch.
## Development claim / 开发声明
- Domain: `release-control-plane`
- Claim: `control-plane`
- Base commit: `7c57bbdb16b24074df16dd64ec51d3fc28782a7f`
- Release preparation: `yes`
- Focused validation:
- `python3 script/tests/test_validation_tooling.py`
- `./script/validate_build_scripts_safety.sh --static-only`
<!-- apc-engineering-coordination-v1
{"claim_overlap_rejections":0,"merge_tree_conflicts":0,"schema_version":"apc.engineering-coordination.v1","task_created_at":"2026-08-12T16:56:32Z","train_conflict_resolutions":0}
-->
---------
Co-authored-by: gd-ops <gd-ops@xmfunny.com>
Agent Pet Companion
简体中文 | English
Know what your coding agents are doing without constantly watching the terminal.
Agent Pet Companion is a native macOS desktop pet for people who work with one or more coding agents. Pet animations and message bubbles show whether an Agent is thinking, using tools, waiting for you, or finished. When it is time to return, an available session destination appears right in the bubble.
Download the latest release · macOS 14 or later · Apple silicon and Intel Macs
What it does for you
- Switch windows less often — see Agent activity on your desktop without repeatedly opening a terminal or Agent app.
- Notice tasks that need you — get a clear visual response when an Agent needs input, finishes, or fails.
- Follow several Agents together — bring activity from Codex, Claude Code, Pi Coding Agent, and OpenCode into one place.
- Get back to work quickly — when routing is available, open the relevant session, Agent app, or terminal from the bubble.
- Make the pet yours — use one of three bundled pets, import a
.petpack, or create and edit your own pet with AI Pet Maker. - Keep data centered on your Mac — pets, settings, limited session summaries, and diagnostics remain local. The App does not read Agent credentials, tokens, cookies, or API keys.
Get started in three steps
- Download and install the App from GitHub Releases.
- Follow the first-run guide to choose a pet and set up the Agents you use.
- Start a task in your Agent as usual. The pet will automatically show its status and any available return destination.
On first launch, choose 星雾团子, Bytebud 字节芽, or 桃蕾. After setup, the pet stays on your desktop even when the control center is closed.
Everyday use
| What you want to do | Where to do it |
|---|---|
| View tasks or expand and collapse messages | Click the pet |
| Move the pet and its bubble | Drag the pet |
| Switch, import, or export pets | Pet Library |
| Create or edit your own pet | AI Pet Maker |
| Change pet size, bubble text, or attention behavior | Pet Configuration |
| Check, install, or repair Agent integrations | Agent Connections |
| Inspect status or troubleshoot a problem | Service & Diagnostics |
Agent Connections is organized by Agent and session, so you do not need to configure every project directory. The App manages only the connection components it installed and leaves custom configuration it cannot safely attribute untouched.
Create your own pet
In AI Pet Maker, describe the appearance, style, and important traits you want to keep. The App uses locally available Codex capabilities to create a new pet or edit an existing one.
- In-App creation supports low and standard resolution.
- Creation progress is retained, and you can answer questions inside the App when a task needs your input.
- The Universal Pet Maker Skill button installs and manages the provider-neutral
agent-pet-makerworkflow at~/agent/skills/agent-pet-maker. The App shows its requirements and version but leaves Agent directory discovery for you to confirm. - You can also import compatible
.petpackV3 packages, including high-resolution packages made by external workflows. - The three bundled pets are read-only defaults. Customizing one creates a new pet instead of replacing the original.
Install a release
- Open GitHub Releases.
- Download the ZIP for your Mac:
- Apple silicon Mac:
macos-arm64 - Intel Mac:
macos-x86_64
- Apple silicon Mac:
- Extract the ZIP and move the App to
/Applications. - On first launch, Control-click or right-click the App in Finder and choose Open, or use System Settings → Privacy & Security → Open Anyway.
Official releases are currently ad-hoc signed rather than Developer ID signed or Apple-notarized, so macOS asks you to approve the first launch. You do not need to disable Gatekeeper or remove quarantine from the command line.
Optional: verify your download
Download the release's SHA256SUMS.txt, then run:
grep 'macos-arm64.zip' AgentPetCompanion-*-SHA256SUMS.txt | shasum -a 256 -c -
For an Intel build, replace macos-arm64.zip with macos-x86_64.zip.
After a healthy launch, the App checks for the latest stable release at most once per day. It only notifies you; it never downloads or installs updates automatically. Quit the old version and replace the App in /Applications to update.
Privacy
Everyday activity display accepts only bounded task status, titles, and message summaries. It does not copy full conversations or read Agent sign-in credentials. When you use AI Pet Maker, the descriptions and reference images you submit are passed to the locally available Codex workflow for generation; everyday Agent activity and AI creation remain separate flows.
For developers
Building from source requires macOS 14+, Apple Command Line Tools with Swift 6 and a macOS SDK, the Rust toolchain pinned by rust-toolchain.toml, and Python 3. Full Xcode is optional.
git clone https://github.com/xjxtree/agent-pet-companion.git
cd agent-pet-companion
./script/build_app_bundle.sh
The development App is written to dist/. To rebuild and launch it:
./script/build_and_run.sh --run
The SwiftUI/AppKit App owns the control center, menu bar, desktop overlay, and rendering. Rust PetCore owns pets, settings, Agent events, connections, creation tasks, and diagnostics. They communicate through local JSON-RPC.
License
Agent Pet Companion is available under the MIT License.