claude_code_check
Destructive
Poll session state or answer pending permission requests to manage autonomous coding tasks.
Instructions
Poll session state or answer a pending permission request.
POLLING FREQUENCY: Do NOT poll every turn. Claude Code tasks take minutes, not seconds.
"running": sleep at least 2 minutes between polls; increase for complex tasks. Do NOT high-frequency poll — it wastes tokens.
"waiting_permission": poll ~1s and respond quickly.
"idle"/"error"/"cancelled": stop polling.
Adapt interval based on task complexity and whether the previous poll returned new events.
Main loop: call action='poll', persist nextCursor, and use action='respond_permission' for approvals.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | 'poll' fetches new events/actions/result; 'respond_permission' answers one pending permission request. | |
| cursor | No | Default: 0. Pass the previous nextCursor to avoid replaying old buffered events. | |
| decision | No | Default: none. Required for action='respond_permission'. 'allow_for_session' reduces repeated prompts in the same session. | |
| interrupt | No | Default: false. When true, a deny decision also interrupts the whole session. | |
| maxEvents | No | Default: 200 (minimal), unlimited (full/delta_compact) | |
| requestId | No | Default: none. Required for action='respond_permission'. | |
| sessionId | Yes | Session ID returned by claude_code or claude_code_reply. | |
| denyMessage | No | Default: 'Permission denied by caller'. Used only with decision='deny'. | |
| pollOptions | No | Default: none. Advanced polling payload controls for action='poll'. | |
| responseMode | No | Default: 'minimal'. Use 'delta_compact' for compact event payloads; use 'full' mainly for diagnostics. | |
| permissionOptions | No | Default: none. Advanced permission response overrides for action='respond_permission'. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| events | Yes | ||
| result | No | ||
| status | Yes | ||
| actions | No | ||
| isError | No | ||
| sessionId | Yes | ||
| truncated | No | ||
| nextCursor | No | ||
| cancelledAt | No | ||
| lastEventId | No | ||
| pollInterval | No | ||
| cursorResetTo | No | ||
| lastToolUseId | No | ||
| availableTools | No | ||
| compatWarnings | No | ||
| toolValidation | No | ||
| cancelledReason | No | ||
| cancelledSource | No | ||
| truncatedFields | No |