# TinyCloud for your agent Give your coding agent (Claude Code, Codex or OpenCode) abilities that keep your data in your own TinyCloud space. Each ability has one page. Every page says what it does, the one prompt or command to run, what you'll be asked to approve, and how to undo it. You need a shell, Node.js 22.20 or later, and npm. **Agents:** the owner sent you this page, maybe with a request. Pick the page below that matches the request and follow it now, in this conversation. If they only asked you to set up TinyCloud, follow [the CLI page](https://agents.tinycloud.xyz/cli). ## Personal records: [/apps](https://agents.tinycloud.xyz/apps) - **What it does:** your agent logs, tracks and looks up anything you keep records of, like weight, workouts or todos, and organises them into apps as you go. - **Paste into your agent:** `Log my weight: 80.5 kg today. Set it up with TinyCloud: https://agents.tinycloud.xyz/apps` - **You approve:** one OpenKey request that lets the agents on this computer keep records under `xyz.tinycloud.agent-data/` in your `default` space, for 30 days. - **Undo:** the end of [the page](https://agents.tinycloud.xyz/apps#undo) lists the commands. ## Meetings: [/chat](https://agents.tinycloud.xyz/chat) - **What it does:** your agent answers questions about your TinyChat meetings: recaps, follow-ups and what was said, with references to the transcript. - **Paste into your agent:** `How did my last meeting go? Check TinyCloud: https://agents.tinycloud.xyz/chat` - **You approve:** a TinyChat sign-in in your browser that lets this computer read your TinyChat meetings, for 7 days. - **Undo:** delete the `tinychat-retrieval` skill folder, and log out if you signed in; [ยง6 of the page](https://agents.tinycloud.xyz/chat#6-return-hand-off-update-or-remove) has both. ## Publish and share: [/publish](https://agents.tinycloud.xyz/publish) `/share` redirects here. - **What it does:** your agent publishes a document or web page from your computer and sends you a link: private to you by default, or public when you ask. - **Run once:** the setup block on [the page](https://agents.tinycloud.xyz/publish), then ask your agent "Publish this report and send me a private link." - **You approve:** an OpenKey request, on your phone or computer, that lets the agent publish files to your TinyCloud and manage their links, for up to 30 days. - **Undo:** ask your agent to revoke a link; every link also expires on its own. [The page](https://agents.tinycloud.xyz/publish#undo) has the commands that end the agent's access and remove its key. ## Secrets: [/secrets](https://agents.tinycloud.xyz/secrets) - **What it does:** your agent uses API keys you keep in TinyCloud Secrets without the value ever appearing in the conversation. If a key is missing, it sends you a link to add it. - **Run once:** the setup block on [the page](https://agents.tinycloud.xyz/secrets), then ask your agent "Turn this script into a voiceover with ElevenLabs. Get the key from TinyCloud." - **You approve:** an OpenKey request that names each secret the agent may read, for up to 30 days. - **Undo:** one `auth logout` command on [the page](https://agents.tinycloud.xyz/secrets#undo) stops the agent reading them. ## Agent-to-agent threads: [/courier](https://agents.tinycloud.xyz/courier) - **What it does:** your agent and a colleague's agent send each other requests and answers over TinyCloud, inside rules you set. - **Run once:** the setup block on [the page](https://agents.tinycloud.xyz/courier), then pair with the other person. - **You approve:** an OpenKey request for Courier's own key to keep messages under `xyz.tinycloud.courier/` in your `agents` space, for 30 days, and each pairing. - **Undo:** `"$TC" courier revoke ` ends a pairing, with `TC` set to the CLI the setup installed; [the page](https://agents.tinycloud.xyz/courier#undo) has the exact commands. ## Building blocks - [/cli](https://agents.tinycloud.xyz/cli): installs the TinyCloud CLI and its `tc-cli` skill, and makes the `tinycloud` command run it. Nothing to approve. `/chat` runs it for you; the other pages install the CLI themselves. - [/openkey](https://agents.tinycloud.xyz/openkey): installs the standalone OpenKey CLI, for workflows that need it. No page here uses it. Nothing to approve. ## Skills The pages install these for you. To install one yourself, replace `` and `` (`claude-code`, `codex` or `opencode`): ```sh curl -fsSL https://agents.tinycloud.xyz/skills/install.js | node - --agent ``` `` is `apps`, `chat`, `publish`, `secrets`, `courier` or `cli`, from the pages above, or `mcp`. The installer checks every file against [`/skills/index.json`](https://agents.tinycloud.xyz/skills/index.json) and prints `SKILL_INSTALLED `. To read a skill, open `/skills/.md`, for example [`/skills/apps.md`](https://agents.tinycloud.xyz/skills/apps.md); its files, exactly as installed, are under `/skills//`. To remove one, delete its folder. `mcp` has no setup page: it's the skill that goes with the TinyCloud MCP server, `@tinycloud/mcp` 0.5.3, for agents that already run that server. Install it with the line above and `mcp` as ``; read it at [`/skills/mcp.md`](https://agents.tinycloud.xyz/skills/mcp.md).