sockdock_get_status
Verify SockDock is running and connected to Slack; report workspace, active runs, arrived channels, Claude Code/Codex sign-in status, owner DM notices, and available updates.
Instructions
Shows whether SockDock is running and connected to Slack, which workspace it is in, the runs in progress (with ids you can pass to sockdock_stop_run), which channels' posts have reached SockDock since it last connected (a restart clears this list, so an empty list right after a restart means nothing), whether Claude Code and Codex are signed in (claude_signed_in / codex_signed_in: false means that agent's rules fail until the user signs in), the owner (the person who uses SockDock; new DM rules are limited to them) with whether notices also go to them by DM, and a newer SockDock release when one is out. DMs show up in the arrived list as dm. Use it first when the user asks whether SockDock works, or before stopping a run. If SockDock is not running, the tool says so: ask the user to open the SockDock app.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "sockdock_get_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | No | the person who uses SockDock (registered in the app); new DM rules are limited to them, and notices go to them by DM when dm_notices is true. Absent when nobody is registered | |
| running | Yes | ||
| connected | Yes | ||
| workspace | No | ||
| dm_notices | Yes | whether notices also go to the owner by Slack DM | |
| last_error | No | ||
| codex_signed_in | No | whether the Codex that codex rules run is signed in; left out when unknown or no rule runs Codex | |
| claude_signed_in | No | whether the Claude Code that agent rules run is signed in; left out when unknown or no rule runs Claude Code | |
| update_available | No | a newer SockDock release, when one is out; the user updates it from the menu bar app (or with brew upgrade). Absent when SockDock is up to date or the check is off | |
| posts_arrived_from | Yes | channel IDs whose posts have reached SockDock since it connected |