---
title: "CLI"
description: "The tractorbeam command builds and operates Tractorbeam Projects."
sidebar:
  label: "Overview"
  order: 0
---

```sh
tractorbeam <subcommand> [flags]
```

## Commands

| Command | Description |
| --- | --- |
| [`init`](/docs/cli/init) | Create a Tractorbeam Project. |
| [`login`](/docs/cli/login) | Sign in to Tractorbeam. |
| [`logout`](/docs/cli/logout) | Sign out of Tractorbeam on this machine. |
| [`whoami`](/docs/cli/whoami) | Show who this machine signs in to Tractorbeam as. |
| [`auth`](/docs/cli/auth) | Inspect sign-in and create API keys. |
| [`auth token`](/docs/cli/auth#auth-token) | Print an access token for Tractorbeam's API. |
| [`auth create-key`](/docs/cli/auth#auth-create-key) | Create an API key acting as you. |
| [`configure`](/docs/cli/configure) | Save the Workspace a Project targets. |
| [`build`](/docs/cli/build) | Build a Project and its Apps. |
| [`plan`](/docs/cli/plan) | Show what applying a Project would change. |
| [`apply`](/docs/cli/apply) | Build and apply a Project to the control plane. |
| [`deploy`](/docs/cli/deploy) | Build an App and deploy it to a Branch. |
| [`branch`](/docs/cli/branch) | Manage a Workspace's Branches. |
| [`branch list`](/docs/cli/branch#branch-list) | List the Workspace's Branches. |
| [`branch create`](/docs/cli/branch#branch-create) | Fork a Branch. |
| [`branch switch`](/docs/cli/branch#branch-switch) | Make a Branch current. |
| [`branch merge`](/docs/cli/branch#branch-merge) | Merge a Branch into another. |
| [`branch delete`](/docs/cli/branch#branch-delete) | Delete a Branch. |
| [`secret`](/docs/cli/secret) | Manage encrypted Secret values. |
| [`secret set`](/docs/cli/secret#secret-set) | Set a Secret's value. |
| [`secret delete`](/docs/cli/secret#secret-delete) | Delete a Secret's value on every Branch. |
| [`connect`](/docs/cli/connect) | Connect a Connector to its provider. |
| [`disconnect`](/docs/cli/disconnect) | Disconnect a Connector. |
| [`connector`](/docs/cli/connector) | Inspect Connectors. |
| [`connector status`](/docs/cli/connector#connector-status) | Show whether a Connector is connected. |
| [`blobs`](/docs/cli/blobs) | Upload the files Blob fields reference. |
| [`blobs upload`](/docs/cli/blobs#blobs-upload) | Upload a file as a Blob. |
| [`export`](/docs/cli/export) | Export the Workspace. |
| [`import`](/docs/cli/import) | Import an export into the Workspace. |
| [`dev`](/docs/cli/dev) | Develop a Project on your personal Branch. |
| [`mcp`](/docs/cli/mcp) | Connect agents to the Project's MCP Servers. |
| [`mcp add`](/docs/cli/mcp#mcp-add) | Add the Project's MCP Servers to agent harnesses. |

## Global flags

Every command takes these flags.

| Flag | Description |
| --- | --- |
| `--help, -h` | Show help information. |
| `--version, -v` | Show version information. |
| `--wizard` | Start wizard mode for a command. |
| `--completions <bash\|zsh\|fish\|powershell\|sh\|pwsh>` | Print shell completion script. |
| `--log-level <all\|trace\|debug\|info\|warn\|warning\|error\|fatal\|none>` | Sets the minimum log level. |
| `--cwd <directory>` | Run as if started in this directory. |

## Environment variables

A flag left out falls back to its environment variable.

| Variable | Flags |
| --- | --- |
| `TRACTORBEAM_BRANCH` | `--branch` |
| `TRACTORBEAM_ORIGIN` | `--origin` |
| `TRACTORBEAM_TOKEN` | `--token` |
| `TRACTORBEAM_WORKSPACE` | `--workspace` |
