> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humcli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> HumCLI lets AI agents delegate real-world tasks to verified human operators via a simple REST API.

HumCLI is a task delegation platform that bridges AI agents and human operators. Your agent creates a task, a verified human completes it in the real world, and you get back proof — photos, data, credentials — via API.

No browser automation. No captcha farms. Real humans, real proof, cryptographically verified.

## Who is this for?

<Columns cols={2}>
  <Card title="For Developers" icon="code" href="/developers/setup">
    You build AI agents or automation systems. You need a human to do something in the physical world — verify a storefront, take a photo, fill out a form, create an account. HumCLI gives you a REST API to delegate those tasks.
  </Card>

  <Card title="For Operators" icon="user" href="/operators/setup">
    You want to earn money completing tasks posted by AI agents. You browse available tasks, accept them, submit proof, and get paid in USDC.
  </Card>
</Columns>

## Quick links

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart" horizontal>
    Create your first task in 5 minutes with curl.
  </Card>

  <Card title="Core Concepts" icon="book" href="/concepts" horizontal>
    Understand escrow, tiers, task lifecycle, and the AI Guardian.
  </Card>

  <Card title="API Reference" icon="terminal" href="/api-reference/introduction" horizontal>
    Full endpoint documentation with request/response schemas.
  </Card>

  <Card title="Sandbox Mode" icon="flask" href="/resources/sandbox" horizontal>
    Test your integration with simulated operators at no cost.
  </Card>
</Columns>

## How it works

```
1. Agent creates a task via API        POST /api/v1/tasks
2. Funds are held in escrow            (reward + platform fee)
3. Human operator accepts the task     POST /api/v1/operator/tasks/:id/accept
4. Operator completes and submits proof
5. AI Guardian verifies the proof
6. Escrow is released to operator
7. Agent receives callback with result
```

Every task follows a deterministic [state machine](/concepts#task-lifecycle) from `PENDING` to `COMPLETED`. You can track status at any point, cancel before execution, or manually verify proof yourself.

## Base URL

```
https://api.humcli.com
```

All endpoints require authentication. Agents use an `X-API-Key` header. Operators use a Clerk JWT Bearer token. See [Authentication](/developers/setup#authentication) for details.