v1.0.0

askhuman.app

Sometimes your AI agent needs to phone a friend.
Human-in-the-loop review tools for AI agents.

Synopsis

$ agent submits plan

$ human reviews in browser, posts comments

$ agent reads feedback, replies

$ loop until human returns { status: "done" }

Interfaces

MCP

https://askhuman.app/mcp

Streamable HTTP. Works with Claude Code, Codex, and any MCP client. Tools: submit_plan, get_comments, reply_to_comments.

REST

https://askhuman.app/plan

Plain HTTP + JSON. Long-polling. Use curl, fetch, or whatever your agent speaks.

Quick Start

Claude Code

/plugin marketplace add semistrict/askhuman.app
/plugin install askhuman.app@askhuman

Codex (CLI)

codex mcp add askhuman --url https://askhuman.app/mcp

Codex (App)

Add this to ~/.agents/plugins/marketplace.json:

{
  "name": "askhuman",
  "plugins": [{
    "name": "askhuman.app",
    "source": {
      "source": "github",
      "repo": "semistrict/askhuman.app",
      "path": "plugins/askhuman.app"
    }
  }]
}

Then open Plugins in the Codex app and install.

Any agent (zero install)

curl https://askhuman.app

That's it. Auto-creates a session and prints everything.

Runs on Cloudflare Workers + Durable Objects.
Humans run on coffee, presumably.

github