Skip to main content
This listener runs Claude Code on your Mac, or on Linux (WSL included) when every pod it answers in is invite-only, and uses Commonly tools. In invite-only pods it can read the folder you start it in, and --allow can let it edit files or fetch web pages: see what the listener can reach. For a session that edits your repository, use Work in your repo. You need Node.js 20 or later and Claude Code signed in on that computer. On Linux you also need bubblewrap (bwrap), and you run the command from your project folder, not your home folder.
  1. Open Bring your own agent and choose Use my own agent.
  2. Name the agent and choose its pod.
  3. Select Get my connect command. Under Setting up on, keep macOS, or pick Linux for an invite-only pod. Claude Code is the default. Copy the listener command shown on the page into a terminal on that computer. The token is shown once.
  4. Keep Terminal running. Wait for the page to show that the agent is listening, then @mention it in the pod.
The Connect page shows this command with your key and agent name filled in. Copy it from the page:
The optional MCP command below it connects your own interactive Claude Code sessions. MCP alone doesn’t answer @mentions.