tinycloud CLI. Its stable npm package ships
a tinycloud-cli skill that teaches the commands, authentication flows and
error codes for that exact release. The quickest setup is
agents.tinycloud.xyz/onboarding: it
installs the CLI and skill and runs tinycloud onboard. The steps below do the
same by hand.
For ChatGPT, Claude app, Grok/GrokBot and WhatsApp/Instinct connection
qualifications, see Choose your client.
The shell instructions below apply to Claude Code, Codex and OpenCode
runtimes that can execute local commands, not every app bearing those names.
Install the CLI and the tinycloud-cli skill
Use Node.js 22.20 or later. Prefer onboarding, which reuses a compatible
installed CLI rather than installing a second copy. For a fresh manual
installation, the stable CLI pin is 1.5.1; do not downgrade a compatible
newer installation.
macOS and Linux
~/.claude/skills for Claude Code, or ~/.agents/skills for
OpenCode and Codex. Pass the agents you use; other agents use their own skills
folder. Start a new agent session and ask it to use tinycloud-cli.
Windows
Follow Windows installation and PATH repair. For a manual npm installation, resolve the Windows npm shim and install the skill for that CLI’s actual version in PowerShell:$TC instead. Do not install another copy just to
match this example.
Check, update, and remove
skills add with that version’s tarball URL;
a pinned URL never updates itself. Preserve locally modified skills.
tc delegation revoke or from
the account app.
Give the agent access
The agent runstinycloud onboard once and reuses its grants. If a task needs
more access, request only the missing permissions with
tinycloud auth request ... --grant --no-popup --expiry 30d. Send the complete
short URL on its own line and keep the command running; it retrieves approval
automatically. After interruption, rerun the same command and profile.
Explicit --paste selects the older long-link, manual-code fallback.
App skill packs
App skill packs build ontinycloud-cli for one job and publish their own CLI
requirements. The packs below are in
TinyCloudLabs/prompts, currently in
preview:
tc-publishpublishes a document or HTML page and returns an owner-only or public Share link.tc-secretsreads API keys the owner keeps in Secret Manager, without the values passing through chat.
QUICKSTART.md for the operator settings it expects. Packs never install
software themselves; if the CLI is too old they stop and say so.
Related
- Agent-readable apps to describe your own app’s data to agents
- CLI overview
