Free & Open Source

The mascot that watches Claude Code 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 · Runs 100% locally

Idle
Working
Compacting
Needs you

Your mascot,
your character

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

5 mascots included

Choose from 5 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

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 installs Claude Code hooks automatically.

3

Pick a mascot

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

4

Start coding

Open a terminal, run Claude Code. Your mascot springs to life.

Full observability

Your mission control for every Claude session.

Notification Dashboard4 items
Session "refactor-auth" running
2 subagents active · 14 events
12s ago
Permission needed: Bash
Session "cleanup-tests" awaiting input
1m ago
Session "build-ci" compacting
Freeing context window
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 Claude 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 Claude mid-task.

What changes with Masko

Your mascot watches Claude 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 Claude Code.

Yes. Masko for Claude 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 uses Claude Code's hook system. It receives event metadata like tool names and session status but never reads your code. Everything runs locally. Nothing is sent to any server.

Masko auto-updates via Sparkle. We track Claude Code releases and ship fixes within days.

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. Claude Code 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 Claude Code 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 Claude Code is doing — idle, working, or waiting for input.

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

Make your terminal feel alive

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

Free & open source · macOS 14+ · Apple Silicon