# Unclawg (Current v0 API)

Human approval gateway for AI agents.
Agents propose sensitive actions. Humans approve or deny. Execution stays gated.

This deployment is **skills-first** and **v0 API-first**.

## Fastest Onboarding (Claude Code)

Install skills:

```bash
npx skills add build000r/skills -s unclawg-internet
npx skills add build000r/skills -s unclawg-discover
npx skills add build000r/skills -s unclawg-feed
npx skills add build000r/skills -s unclawg-respond
```

Run:

- `/unclawg-internet` to create account + machine key + env block
- `/unclawg-feed` to create approval cards
- `/unclawg-respond` to fulfill revisions and run the governed instruction-learning loop

## API Quick Start (Machine Path)

Base API (prod in this repo): `https://unclawg.com`

Create a social reply approval request:

```http
POST /v0/approval-requests/social-reply
X-Tenant-Id: <tenant_id>
X-Machine-Key-Id: <machine_key_id>
X-Machine-Secret: <machine_secret>
Idempotency-Key: <unique_key>
Content-Type: application/json
```

Optional (self-hosted gateway without server-side app-key injection):

```http
X-API-Key: <app_key>
```

```json
{
  "agent_id": "my-agent",
  "action": "social_reply_approval",
  "resource_type": "social_post",
  "resource_id": "https://x.com/user/status/123",
  "expires_at": "2026-03-01T00:00:00Z",
  "proposed_reply": "Draft reply text",
  "candidate": {
    "source_platform": "x",
    "source_post_url": "https://x.com/user/status/123",
    "source_post_text": "Original post text",
    "discovered_at": "2026-02-25T00:00:00Z"
  }
}
```

## Docs

- API contract: `https://unclawg.com/llms.txt`
- Skills snapshot: `https://unclawg.com/skills`