---
title: "tractorbeam commit"
description: "The Tractorbeam API's commit operations."
sidebar:
  label: "commit"
  order: 31
---

```sh
tractorbeam commit <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 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`. |

## `commit list`

Returns a page of the Commits on the Branch's first-parent history, newest first, each with its parents, when it was written, and who and what made it. Needs Workspace authority; an App token can't list Commits.

```sh
tractorbeam commit list [flags]
```

| Flag | Description |
| --- | --- |
| `--limit <string>` | The most items the page returns, from 1 to 200. Defaults to 50. |
| `--cursor <string>` | A cursor for use in pagination: the `nextCursor` of the previous page, whose read the page continues. |
| `--branch <string>` | Branch name. Defaults to the Branch you last switched to, or main. Environment variable: `TRACTORBEAM_BRANCH`. |
| `--all` | Read every page, following `nextCursor`, and print all their items together. |

## `commit get`

Returns the Commit with this ID from any Branch, even a deleted one, with its parents, when it was written, and who and what made it. Returns 404 for a Commit the Workspace doesn't retain. Needs Workspace authority; an App token can't retrieve Commits.

```sh
tractorbeam commit get [flags] <commit>
```

| Argument | Description |
| --- | --- |
| `<commit>` | The ID of the Commit to retrieve. |
