---
title: "tractorbeam connector"
description: "Inspect Connectors."
sidebar:
  label: "connector"
  order: 15
---

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

## Shared flags

Every subcommand takes these flags.

| Flag | Description |
| --- | --- |
| `--config <string>` | The Project's `tractorbeam.config.ts`. Defaults to the one in the current directory or its nearest ancestor. |
| `--workspace <string>` | Workspace identifier or resource name. Environment variable: `TRACTORBEAM_WORKSPACE`. |
| `--origin <string>` | The Tractorbeam origin to call instead of the default, such as a proxy's. Environment variable: `TRACTORBEAM_ORIGIN`. |
| `--token <string>` | Access token. Defaults to the saved interactive session. Environment variable: `TRACTORBEAM_TOKEN`. |

## `connector status`

Show whether a Connector is connected.

```sh
tractorbeam connector status [flags] <connector>
```

| Argument | Description |
| --- | --- |
| `<connector>` | The Connector's name on the Branch. |

| Flag | Description |
| --- | --- |
| `--branch <string>` | Branch identifier or resource name where the Connector is defined. Defaults to the Workspace's default Branch. Environment variable: `TRACTORBEAM_BRANCH`. |
