CodexPet Nest

Give your Codex pet a place to live.

A tiny open-source macOS companion app that adds floating nests, focus widgets, usage rings, and local pet management beside your Codex Desktop pet.

Download for macOS Install with npx View on GitHub

macOS 14+Apple SiliconOpen sourceIndependent from OpenAI/Codex

Install from Terminal

A fast way to get the latest version directly into your Applications folder.

iInstalled to ~/Applications/CodexPet Nest.app

iCurrently supports macOS only

zsh

$npx codexpetxyz nest install

To download without installing:

npx codexpetxyz nest install --download-only

Four nests included in the first release

These nests are bundled with the CodexPet Nest desktop app. They are shown on the website for product preview only and are not offered as separate web downloads in the first release.

Capacity Orbit

Dynamic usage rings that sit around your Codex pet.

Basket Pomodoro

A cozy basket with a built-in focus timer.

Legend Status

A game-like status panel for usage and session context.

Nest Terminal

A retro terminal-style home for your pet.

✦

Floating nest overlay

A lightweight window that follows your Codex pet or stays where you place it.

✦

Built-in widgets

Clock, countdown, Pomodoro, and usage indicators.

✦

Local pet management

Install, preview, and manage Codex pet packs from one small menu bar app.

✦

Pet browsing support

Browse pets from codexpet.xyz and install pet packs locally. Nest themes are bundled with the app in the first release.

✦

Safe by design

No code injection, no prompt upload, no project file upload, and no automatic Codex state rewriting.

Built to stay out of your workspace

CodexPet Nest does not modify the Codex app bundle, inject code, upload prompts, read your repositories, or rewrite Codex global state. It only reads local pet position/state data needed to place the nest beside your pet.

No prompt uploadNo code injectionNo project file uploadFully uninstallableOpen source

Currently for macOS

The first release is built for macOS 14+ on Apple Silicon. Windows support is possible, but it requires a separate desktop client because the current app uses native macOS APIs for the menu bar, transparent overlay window, and desktop positioning.

Download for macOS Follow Windows progress on GitHub

Open source from day one

CodexPet Nest is developed in the open. You can inspect the code, report issues, package your own nests, or contribute platform work.

View GitHub Repository Report an Issue All Releases

RyanNiu / codexpet-nest

git clone https://github.com/RyanNiu/codexpet-nest.git
cd codexpet-nest
make build

Give your Codex pet a place to live.

Download CodexPet Nest for macOS.

Download for macOS View GitHub

npx codexpetxyz nest install