Working
The pet moves while Codex is using tools or progressing through a task.
CODEX INTEGRATION
Give Codex a custom desktop pet.
Keep a custom mascot on your Mac while Codex works. It shows working, waiting, approvals, completion, errors, and subagent activity, then opens the right Codex surface when you need to respond.
macOS 14+ · Start free with Ko
NEEDS ATTENTIONCodex needs youOpen the right session.
CODEX PET STATES
Know when Codex is working or needs you.
Masko turns Codex hooks and session activity into a few readable mascot states. Questions and permissions still belong to Codex, so Masko returns you to the right native surface.
Waiting
A quiet attention state tells you when the session needs input.
Approval
The mascot points you back to the native Codex permission prompt.
Completed
A finished reaction makes the result visible away from the Codex window.
Error
An interruption or failure gets a distinct reaction instead of disappearing in a tab.
FIVE READABLE SIGNALS
Follow Codex without watching the window.
The mascot gives working, waiting, approval, completed, and error states a visible place on your desktop. Codex remains the source of truth for the task and every response.
- Working
Tools and subagents are active
- Waiting
The session needs input
- Approval
Open the native Codex prompt
- Completed
The task has finished
- Error
The session stopped unexpectedly
CODEX NEEDS YOUApproval requestedOpen the native prompt →
Connect Codex to Masko.
Masko connects through ~/.codex/hooks.json and Codex session logs. Its health screen installs or repairs the supported connection and confirms that activity is arriving.
Install Masko
Open the Apps or Integrations area in Masko.
Connect Codex
Install the supported configuration at ~/.codex/hooks.json and Codex session logs.
Run a session
Watch the mascot change as the agent works, waits, asks, or finishes.
Built-in Codex pets and Masko solve different jobs.
Use the native Codex pet for a character inside Codex. Use Masko when you want a custom animated mascot that stays visible across your Mac and can connect to other supported agents too.
| Capability | Built-in Codex pet | Masko |
|---|---|---|
| Where it lives | Inside the Codex experience | As a floating character across your Mac desktop |
| Character choice | Codex pet choices and supported customization | Create from a sentence or image, or choose a marketplace mascot |
| Activity signals | Codex activity inside Codex | Codex hooks and session logs mapped to visible mascot states |
| Agent coverage | Codex | Codex plus other supported coding-agent integrations |
| Questions and approvals | Answered in the native Codex surface | Shows the request, then opens or focuses Codex to answer |
Choose the built-in Codex pet
Best when you want a playful character contained inside the Codex experience.
Choose Masko
Best when you want your own animated mascot across the desktop, with Codex state and other supported integrations in one character.
TRY IT
Your mascot keeps watch over Codex.
› Refactor the sign-in flow
✓ Read src/auth/session.ts
✓ Read src/lib/validate.ts
✓ Updated the redirect handler
Codex wants to run a command
Bash · npm run build
one very attentive colleague.
Codex: this example opens the original session so you can answer there.
Interactive preview. No commands run.THE LITTLE DETAILS
A few questions.
we were hoping you’d ask.
Does Masko replace the built-in Codex pet?
No. The built-in pet belongs inside Codex. Masko adds a separate custom character that stays visible across your Mac and can represent activity from other supported agents too.
Can I create my own Codex pet?
Yes. In Masko, you can create a mascot from a sentence or image, choose a marketplace character, or start with Ko, then connect that character to Codex activity.
How does Masko connect to Codex?
Masko uses the supported local connection associated with ~/.codex/hooks.json and Codex session logs. Its health screen can install or repair that connection.
Can I answer Codex from the mascot?
Masko shows the request and returns you to Codex, where the answer remains under Codex control.
What does Masko see from Codex?
Current support covers session lifecycle, tool activity, subagent activity, questions and approvals, completion and interruption.
What is the current Codex limitation?
Masko does not pretend to answer Codex permissions directly. It opens or focuses the correct Codex surface.
Which Macs can run Masko?
Masko supports macOS 14 or newer.
MASKO FOR MAC