Free & Open Source

The mascot that watches Codex for you

A free macOS overlay that tracks your sessions, notifies you in real time, and lets you approve permissions without switching apps.

macOS 14+ · Apple Silicon & Intel · Runs 100% locally

Idle
Working
Thinking
Needs you

Your mascot,
your character

6 mascots included out of the box. Or bring your own from masko.ai.

6 mascots included

Choose from 6 unique characters. No account needed.

Custom mascots via masko.ai

Design your own character with AI generation.

Idle, working & attention animations

Each mascot has unique animations for every state.

Export & load in one click

Download from masko.ai, load into the desktop app.

Madame Patate
Otto
Cupidon
Masko
Rusty
Nugget

See it in action

Your mascot floats on top of everything. When Claude needs you, a speech bubble appears.

claude — ~/projects/my-app
Fix the login form validation bug
Read src/components/LoginForm.tsx
Read src/lib/validation.ts
Claude wants to run a command
╭─────────────────────────────────────────────────╮
Bash · npm run build
╰─────────────────────────────────────────────────╯
Bash
npm run build
11

Up and running in 60 seconds

No config files. No server. No API keys.

1

Download the app

Install the DMG. Lives in your menu bar, no dock clutter.

2

Grant accessibility

First launch detects Codex sessions automatically.

3

Pick a mascot

Choose from 6 included mascots or bring your own from masko.ai.

4

Start coding

Open a terminal, run Codex. Your mascot springs to life.

Full observability

Your mission control for every Codex session.

Notification Dashboard4 items
Session "refactor-auth" running
Codex agent active · 14 events
12s ago
Permission needed: Bash
Session "cleanup-tests" awaiting input
1m ago
Session "build-ci" thinking
Agent reasoning through approach
4m ago
Session "add-api-route" ended
38 events · Last: 9 minutes ago
9m ago

Session summary

Running, idle, and finished sessions at a glance.

Color-coded activity feed

Events, tool calls, and completions in order.

Native macOS notifications

Badges and alerts when Codex needs you. No sounds.

Notification dashboard

Priority levels and resolution tracking.

Subagent tracking

Monitor child agents in real time.

Interrupt detection

Knows when you stopped Codex mid-task.

Keyboard-first,
zero context switch

Every action has a shortcut. Your hands never leave the keyboard.

Double-tap ⌘ to switch sessions

Running 3 Codex sessions? Double-tap Cmd to cycle between them. Hit ⌘↵ to jump to that terminal.

⌘1-9 to approve permissions instantly

Codex needs to run a command? Press ⌘1 to allow, ⌘2 to deny. No mouse needed.

Jump to the exact terminal tab

Click a session or hit ⌘↵ to focus the right terminal tab. Works with iTerm2, Terminal.app, VS Code, Ghostty, and more.

⌘M to jump to the terminal

Instantly focus the terminal running Codex from anywhere. Shortcut is fully customizable.

my-app
Running · 12s ago
⌘1
backend-api
Thinking · 4m ago
⌘2
docs-site
Idle · 9m ago
⌘3
⌘⌘ switch⌘↵ focusesc cancel
⌘MJump to terminal
⌘⌘Session switcher
⌘1-9Select action
⌘↵Confirm

What changes with Masko

Your mascot watches Codex so you don't have to.

Raw terminal

Permission handling

Switch to terminal, type yes

Question answering

Find terminal, type response

Plan review

Open terminal, scroll up

Session awareness

Check each tab manually

Crash detection

Notice when output stops

Context switching

High

With Masko

Permission handling

One click from overlay

Question answering

Answer from speech bubble

Plan review

Expandable plan in overlay

Session awareness

Summary view with status

Crash detection

Instant notification

Context switching

Zero

Frequently asked questions

Everything you need to know about Masko for Codex.

Yes. Masko Code is free and open source. The desktop companion is MIT-licensed. Custom mascots require a Masko account, but the default mascot is included.

No. The overlay is a lightweight SwiftUI window. CPU usage is negligible.

Masko monitors session metadata like tool names and status but never reads your code. Everything runs locally. Nothing is sent to any server.

Yes. Masko Code supports both OpenAI Codex and Claude Code. The same app, same mascots, same overlay.

Yes. Create a custom mascot on masko.ai with your own animations for idle, working, and attention states. Export and load it into the desktop app.

Vibe coding is a development style where you describe what you want in natural language and an AI agent writes the code. OpenAI Codex is one of the most popular vibe coding tools. Masko adds a visual layer so you can monitor progress, approve permissions, and stay in flow without switching windows.

Masko connects to Codex running in any supported terminal. A VS Code extension adds click-to-focus for the active terminal tab.

Masko shows a real-time overlay on your desktop. You see the current tool being used, permission requests, and session status at a glance. The mascot animates to reflect what Codex is doing - idle, working, or waiting for input.

macOS 14.0 or later (Sonoma) on Apple Silicon (M1, M2, M3, M4) and Intel.

Make your terminal feel alive

A mascot that watches Codex so you don't have to. Free, open source, ready in 60 seconds.

Free & open source · macOS 14+ · Apple Silicon & Intel