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

# CLI Overview

> Install the TinyCloud CLI and pick the right command path

`tc` is the terminal entry point for TinyCloud. Start here if you want to sign in, create a space, store data, or inspect local profile state.

## Choose a path

<CardGroup cols={2}>
  <Card title="Sign in" icon="lock" href="/cli/authentication">
    Set up a profile, choose OpenKey or a local key, and create a session.
  </Card>

  <Card title="Store data" icon="database" href="/cli/storage">
    Write and read key-value data in the active space.
  </Card>

  <Card title="Manage spaces" icon="box" href="/cli/spaces">
    Host your owned space, inspect it, or switch the active space.
  </Card>

  <Card title="Troubleshoot" icon="stethoscope" href="/cli/diagnostics">
    Run `tc doctor`, inspect node health, and check local state.
  </Card>
</CardGroup>

## Install

```bash theme={null}
npm install -g @tinycloud/cli@0.7.7
tc --version
```

The CLI requires Node.js 20 or later.

## Defaults

`tc` applies global flags first, then environment variables, then profile settings.

| Flag or env                | Purpose                                                   |
| -------------------------- | --------------------------------------------------------- |
| `--profile` / `TC_PROFILE` | Select the active profile                                 |
| `--host` / `TC_HOST`       | Override the TinyCloud node URL                           |
| `--json`                   | Force machine-readable output                             |
| `--quiet`                  | Suppress banner output                                    |
| `TC_OPENKEY_HOST`          | Override the OpenKey host used by browser auth            |
| `TC_PRIVATE_KEY`           | Provide a headless private key for auth-required commands |

## What the CLI covers

* Authentication and session management
* Key-value storage
* SQLite and DuckDB database operations
* Spaces and delegations
* Secrets, vault, and plaintext variables
* Manifest resolution and local state inspection

## Source note

Command names, flags, and defaults on the CLI pages are verified against `@tinycloud/cli` 0.7.7.