claude-duet-bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| send_jobA | Queue a read-only job for Claude Code on the user's Mac. Write the instructions as a complete brief: Claude Code sees only this text. Returns a job id. The Mac picks jobs up within seconds while it is awake. |
| get_jobA | Read one job: its status and, when it is done, Claude Code's full answer. |
| list_jobsB | List recent jobs, newest first, without their full answers. |
| cancel_jobA | Cancel a job that is still queued. A job that already started cannot be cancelled. |
| post_reportB | Leave a report in the mailbox for the other side to read. Claude Code uses this to tell Duet about finished work; Duet can use it to leave notes for Claude Code. |
| read_reportsA | Read reports left in the mailbox. By default returns unread reports, oldest first, and marks them read. |
| bridge_statusA | Job counts, unread messages and reports, open live windows, and when the Mac last checked in. |
| list_sessionsB | List Claude Code sessions, newest activity first: live windows the user has open (connected=true means it hears you now) and headless sessions the Mac runs. Shows each one's name, folder, focus and status. |
| start_sessionA | Start a new background Claude Code conversation on the user's Mac and send it the first message. Write a complete brief: Claude Code sees only this text. Continue it later with send_message. |
| send_messageA | Send a message to a Claude Code session, live or headless. A connected live window gets it within seconds. A headless session answers in its next turn. Give wait_seconds to get the answer in this call. |
| read_messagesA | Read unread messages that Claude Code sent you, oldest first, and mark them read. Give a session_id for one session, or none for everything, including messages Claude Code sent outside any session. |
| end_sessionA | Close a session. A headless session stops taking turns; a live window disconnects from Duet but stays open on the Mac. |
| open_on_macB | Open a headless session in a terminal window on the user's Mac, so the user can read it and take over by hand. The window then becomes a live session. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
TDQS
Scored across 13 tools
Most tools target distinct concepts, but the set has several near-neighbors: send_job vs send_message vs start_session all push instructions to Claude Code, and read_messages vs read_reports both drain a mailbox. The descriptions do draw the lines (one-shot read-only job vs persistent session vs free-form note), but an agent must read carefully to pick correctly.
Almost every tool follows a clean verb_noun pattern (get_job, list_jobs, send_job, cancel_job, start_session, end_session, read_reports, post_report). The only outlier is bridge_status, which inverts the pattern to noun_verb while its siblings use verbs.
Thirteen tools is well within the sweet spot and each maps to a concrete operation across the three sub-areas (jobs, sessions, mailbox). Nothing looks redundant or padded.
Full lifecycle is covered for jobs (send/list/get/cancel) and sessions (start/list/end/open), plus two-way messaging and a status overview. Minor gaps exist: no way to fetch a single session's detail, no way to re-read already-consumed messages/reports explicitly addressed to one item, and no cleanup/purge for old jobs.