hitl-protocol
by rotorstar
Web & Frontend DevelopmentBrief
HITL Protocol — the open standard for human decisions in autonomous agent workflows.
Description
What This Skill Does
HITL Protocol is an open standard for inserting human decisions into autonomous agent workflows. When a service needs human input, it returns HTTP 202 with a review URL. The agent forwards that URL to the user, polls for the structured result, and continues execution.
It enforces human control over irreversible agent actions using plain HTTP with no SDK, no UI framework, and no custom messenger integration beyond optional native buttons.
When to Use It
- Reviewing job listings before an agent submits applications
- Confirming a non-refundable booking before payment goes through
- Approving a generated email batch before it sends
- Selecting a deployment plan before an agent executes it
- Escalating a failed agent action to a human for recovery
Example Workflow
User asks: Find senior developer jobs in Berlin and apply to the best ones
- 1
Posts search query to job board API
- 2
Receives HTTP 202 with a HITL object containing review_url and poll_url
- 3
Sends review_url to user: '5 jobs found. Select which to apply for: [url]'
- 4
Polls poll_url every 30 seconds until status changes from pending
- 5
Reads selected job IDs from result.data and submits applications
Applied to 2 user-selected jobs.
Installation
clawhub install rotorstar/hitl-protocolRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.