Skip to content
Masko

Codex integration

A desktop mascot for Codex.

Codex 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: Codex 0.147.0.

See how it works ↓

Live agent state

Know what Codex is doing.

Masko shows the request and returns you to Codex, where the answer remains under Codex control. The mascot stays visible while the agent remains in its normal terminal, IDE, or desktop surface.

  1. 01
    Session

    Masko observes session lifecycle through the supported Codex connection.

  2. 02
    Activity

    Masko observes tool activity through the supported Codex connection.

  3. 03
    Attention

    Masko observes subagent activity through the supported Codex connection.

Needs attentionSessionOpen the right session.

How it works

Connect Codex to Masko.

The integration uses ~/.codex/hooks.json and Codex session logs. 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 Codex

    Install the supported configuration at ~/.codex/hooks.json and Codex session logs.

  3. 03Run a session

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

In practice

What you can answer here.

Masko does not pretend to answer Codex permissions directly. It opens or focuses the correct Codex surface.

Native prompt handoff

Masko shows the request and returns you to Codex, where the answer remains under Codex control.

Return to source

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

Compatibility

Current compatibility reference: Codex 0.147.0.

AI agents

Your mascot keeps watch over Codex.

  1. 01Know when an agent needs you.

    See when Codex 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 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 Desktop supports macOS 14 or newer.

Masko for Mac

A desktop mascot for Codex.

Download Masko

Current compatibility reference: Codex 0.147.0.