set_status
Set status key-value pairs for AI agents in terminal multiplexer workspaces to display agent states and progress indicators.
Instructions
Set a sidebar status key-value pair
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Status key | |
| value | Yes | Status value | |
| workspace | No | Target workspace ref | |
| surface | No | Target surface ref | |
| icon | No | Icon name | |
| color | No | Hex color |
Implementation Reference
- src/server.ts:439-454 (handler)The handler function for the 'set_status' MCP tool in src/server.ts, which validates the key and calls the underlying client.setStatus method.
async (args) => { try { parseReservedModeKey(args.key, args.value); await client.setStatus(args.key, args.value, { icon: args.icon, color: args.color, workspace: args.workspace, surface: args.surface, }); return ok({ key: args.key, value: args.value, applied: "set_status", }); } catch (e) { return err(e); - src/server.ts:427-438 (schema)Input validation schema for the 'set_status' MCP tool.
{ key: z.string().describe("Status key"), value: z.string().describe("Status value"), workspace: z.string().optional().describe("Target workspace ref"), surface: z.string().optional().describe("Target surface ref"), icon: z.string().max(8).optional().describe("Icon name"), color: z .string() .regex(/^#[0-9a-fA-F]{6}$/) .optional() .describe("Hex color"), }, - src/server.ts:424-426 (registration)Registration of the 'set_status' tool using the server.tool method.
server.tool( "set_status", "Set a sidebar status key-value pair",