Skip to content
Masko

Claude Code integration

Give Claude Code a face on your Mac.

Claude Code can work in the background while your mascot shows activity, attention, completion, and the next action Masko can honestly provide.

Current compatibility reference: Claude Code 2.1.227.

See how it works ↓

Live agent state

Know what Claude Code is doing.

Answer supported permission prompts from the mascot with Allow or Deny. The mascot stays visible while the agent remains in its normal terminal, IDE, or desktop surface.

  1. 01
    Session

    Masko observes session start and end through the supported Claude Code connection.

  2. 02
    Activity

    Masko observes tool activity through the supported Claude Code connection.

  3. 03
    Attention

    Masko observes permission prompts through the supported Claude Code connection.

Needs attentionSessionOpen the right session.

How it works

Connect Claude Code to Masko.

The integration uses ~/.claude/settings.json. Masko installs or repairs the supported connection and reports its health.

  1. 01Install Masko

    Open the Apps or Integrations area in Masko Desktop.

  2. 02Connect Claude Code

    Install the supported configuration at ~/.claude/settings.json.

  3. 03Run a session

    Watch the mascot change as the agent works, waits, asks, or finishes.

In practice

What you can answer here.

Masko responds only to prompts exposed by Claude Code hooks. Other terminal input remains in Claude Code.

Direct response

Answer supported permission prompts from the mascot with Allow or Deny.

Return to source

When Claude Code owns the input, Masko focuses the best known native surface.

Compatibility

Current compatibility reference: Claude Code 2.1.227.

AI agents

Your mascot keeps watch over Claude Code.

  1. 01Know when an agent needs you.

    See when Claude Code is working, waiting, asking, or done.

  2. 02Keep the work moving.

    Approve a supported command or answer a question through your mascot.

  3. 03Jump to the right session.

    Return to the exact terminal or app without hunting through tabs.

〉_ Bash

Run a build?$npm run build

Builds the app. Nothing else changes.

Questions

The practical bits.

How does Masko connect to Claude Code?

Masko uses the supported local connection associated with ~/.claude/settings.json. Its health screen can install or repair that connection.

Can I answer Claude Code from the mascot?

Answer supported permission prompts from the mascot with Allow or Deny.

What does Masko see from Claude Code?

Current support covers session start and end, tool activity, permission prompts, questions, completion and failure.

What is the current Claude Code limitation?

Masko responds only to prompts exposed by Claude Code hooks. Other terminal input remains in Claude Code.

Which Macs can run Masko?

Masko Desktop supports macOS 14 or newer.

Masko for Mac

Give Claude Code a face on your Mac.

Download Masko

Current compatibility reference: Claude Code 2.1.227.