blixel blixel

Troubleshooting

When connecting fails, your agent says why. To see which session is connected
to your meeting, run /blixel:status in Claude Code, or blixel agent status
in the session.

"Blixel isn't installed"

Your agent couldn't find Blixel on this Mac. Install it, as in
Install Blixel, then ask your agent again.
If Blixel is somewhere other than Applications, move it there.

Claude Code: monitor_not_running

Claude Code isn't listening for requests. Run /blixel:connect again.

If it fails again, Claude Code has monitors turned off: DISABLE_TELEMETRY or
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC is set, or it runs on Amazon
Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. Requests can't
reach that session.

Claude Code: socket_blocked

Claude Code's sandbox blocks the connection to Blixel. The error names a
socket path. Add that path to sandbox.network.allowUnixSockets in your Claude
Code settings, then connect again.

Codex: the sandbox blocks the connection

When Codex asks to run blixel agent outside its sandbox, approve it. If it
doesn't ask, run /permissions, choose Approve for me, and connect again.

Requests stop arriving

  • Blixel is older than 0.15.1 and the plugin was updated. Update Blixel; see
    Set up your agent.
  • Leaving or switching rooms ends the connection. Connect again after you join.
  • Connecting another session in the same meeting replaces yours.
  • Moving a Claude Code session to the background ends the connection.
  • Without the plugin, a session stops acting on requests after /clear or a
    compaction. Ask it to connect to Blixel again.

A Codex session still runs requests after you close it

Codex keeps the conversation running after its terminal closes. Right-click
✦ Agent and choose Disconnect under My agent. Or run
blixel agent status, then blixel agent disconnect --connection-id <id> with
the connection_id it shows.

You're muted and your agent hears nothing

Requests to your own agent use your microphone as it is in the call. Choose
Unmute and talk (the room will hear you), or type the request.

No one in this call has an agent connected

Nobody has connected an agent yet. See Connect your agent.