tractorbeam commit
The Tractorbeam API's commit operations.
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.
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.
tractorbeam commit get [flags] <commit>
| Argument | Description |
|---|---|
<commit> |
The ID of the Commit to retrieve. |