# Use the sky CLI

> The sky CLI lets you manage agents, chats, files, billing, and automations from your terminal.

canonical: https://agentsky.dev/help/sky-cli-overview
source: https://agentsky.dev/help/sky-cli-overview.md
updated: 2026-10-21

---

**The sky CLI lets you manage agents, chats, files, billing, and automations from your terminal.**

Install sky once, then use it to start sessions, send messages, upload files, check your balance, and set up automations — all without opening a browser.

**Install:**

```
npm install -g @agentsky/sky
```

**Authenticate:**

```
sky auth login
```

**Key commands:**

| Command | What it does |
|---|---|
| `sky session create` | Create a new chat session |
| `sky session message` | Send a message to a session |
| `sky files upload` | Upload files to your workspace |
| `sky billing show` | Show your current balance |
| `sky import --current` | Import a local agent session to the cloud |
| `sky routine create` | Create a scheduled automation |
| `sky workspace` | Manage workspaces and members |

Where: terminal (any OS)

**Good to know:** Run `sky --help` to list every command and subcommand. Use `--workspace <name>` globally to target a specific workspace. The sky CLI is updated regularly — run `npm update -g @agentsky/sky` to get the latest version. Related: [Use the AgentSky API](https://agentsky.dev/help/api-overview), [Import chat history with the sky CLI](https://agentsky.dev/help/import-sessions-cli), [Automate goals and routines via the API](https://agentsky.dev/help/goals-and-routines-api).