Skip to content
Masko

Cursor integration

Give Cursor Agent a face.

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

Download MaskoCompare all integrations

Current compatibility reference: Cursor 3.16.17.

See how it works ↓

Live agent state

Know what Cursor is doing.

Masko alerts you and returns you to Cursor when its native interface owns the question. The mascot stays visible while the agent remains in its normal terminal, IDE, or desktop surface.

  1. 01
    Session

    Masko observes agent sessions through the supported Cursor connection.

  2. 02
    Activity

    Masko observes tool use through the supported Cursor connection.

  3. 03
    Attention

    Masko observes file edits through the supported Cursor connection.

Needs attentionSessionOpen the right session.

How it works

Connect Cursor to Masko.

The integration uses ~/.cursor/hooks.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 Cursor

    Install the supported configuration at ~/.cursor/hooks.json.

  3. 03Run a session

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

In practice

What you can answer here.

Cursor Desktop structured question cards stay in Cursor because current hooks do not expose their payload or a response channel.

Native prompt handoff

Masko alerts you and returns you to Cursor when its native interface owns the question.

Return to source

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

Compatibility

Current compatibility reference: Cursor 3.16.17.

AI agents

Your mascot keeps watch over Cursor.

  1. 01Know when an agent needs you.

    See when Cursor 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.

Keep exploring

Questions

The practical bits.

How does Masko connect to Cursor?

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

Can I answer Cursor from the mascot?

Masko alerts you and returns you to Cursor when its native interface owns the question.

What does Masko see from Cursor?

Current support covers agent sessions, tool use, file edits, subagent activity, completion and failure.

What is the current Cursor limitation?

Cursor Desktop structured question cards stay in Cursor because current hooks do not expose their payload or a response channel.

Which Macs can run Masko?

Masko Desktop supports macOS 14 or newer.

Masko for Mac

Give Cursor Agent a face.

Download Masko

Current compatibility reference: Cursor 3.16.17.