---
name: kuick
description: Hand work to a person as a link with kuick.io — share a Markdown report, files or a short link, send a secret that burns after one read, ask a person to approve or choose and wait for the answer, or read a kuick.io link. Use when the user wants something they can open on another device or send to someone, when you need a human's decision mid-task, or when a kuick.io link appears.
---

# kuick

kuick.io turns content into a link anyone can open in a browser: no sign-up for you or for them. Links expire on their own (24 hours by default).

Use it when:

- The user wants to **see or send** what you made: a report, summary, diff, table or file, on another device or to someone else.
- You need a **person's decision** before going on ("Deploy now?", "Which option?"): ask with a poll, then wait for the answer.
- You have a **secret** to hand over (API key, password): share it one-time, so the first open deletes it. Never paste secrets into chat.
- You're given a **kuick.io link**: read it as Markdown.

## How to call it

Use whichever is available, in this order:

1. **MCP tools** (`share_text`, `share_file`, `shorten_url`, `ask_human`, `get_responses`, `read_share`, `list_shares`, `delete_share`, `request_files`), when the kuick MCP server is connected.
2. **The CLI**, with a shell: `npx -y kuickio@latest <command>`.
3. **HTTP**, otherwise: `https://backend-api.kuick.io/v1/agent/...` (OpenAPI at `https://backend-api.kuick.io/v1/openapi.json`).

### CLI

```sh
npx -y kuickio@latest share report.md             # a .md file becomes a page; other files are shared as files
npx -y kuickio@latest share chart.png data.csv    # several files behind one link
echo "# Done" | npx -y kuickio@latest text        # Markdown from stdin
npx -y kuickio@latest link https://example.com/a/very/long/url
npx -y kuickio@latest secret "sk-live-…"          # one-time: the first open deletes it
npx -y kuickio@latest ask "Deploy to production?" Yes No --wait 300   # prints the link, then waits for a vote
npx -y kuickio@latest results <link> --wait 60
npx -y kuickio@latest read https://kuick.io/ab12cd
```

Options for anything that makes a link: `--expires 2h` (5m to 24h free; up to 30d with Plus), `--once`, `--passcode <p>`, `--title <t>`, `--json`.

The CLI keeps its key in `~/.config/kuick/config.json`, so `results`, `list` and `delete` work on what it made.

### HTTP

```sh
# Share Markdown; the response has the link, and a `key` to keep when you sent none.
curl -s https://backend-api.kuick.io/v1/agent/shares -H 'content-type: application/json' \
  -d '{"type":"text","markdown":"# Report\n\nAll green.","expiresIn":"2h"}'

# Ask, then wait (up to 55 s per call) for the first vote.
curl -s https://backend-api.kuick.io/v1/agent/shares -H 'content-type: application/json' \
  -H "authorization: Bearer $KEY" -d '{"type":"poll","question":"Ship it?","options":["Yes","No"]}'
curl -s "https://backend-api.kuick.io/v1/agent/shares/<code>?wait=55&since=0" -H "authorization: Bearer $KEY"

# Files: send names and sizes, then PUT each file's bytes to its uploadUrl with the given headers.
curl -s https://backend-api.kuick.io/v1/agent/shares -H 'content-type: application/json' \
  -d '{"type":"file","files":[{"name":"out.pdf","size":48213,"mimeType":"application/pdf"}]}'

# Read any kuick link as Markdown.
curl -s https://kuick.io/ab12cd.md
```

## Good practice

- **Give the link to the user** with what it is and when it expires, e.g. "Report: https://kuick.io/ab12cd (expires in 24 h)".
- **Secrets**: `one_time` / `--once`, and a passcode sent through a different channel if it matters.
- **Waiting on a person**: tell the user to open the link, then wait in steps (`wait_seconds: 55`, passing the last `total` as `since`) rather than one long block. Stop when you have the answer.
- **Sensitive content** (personal data, credentials) only when the user asked for it to be shared.
- A `PLUS_REQUIRED` error means the setting needs kuick Plus: drop it (e.g. a shorter expiry) or tell the user they can use a Plus key from https://kuick.io/account.
