@tryterra/cli-darwin-x64 0.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +4 -0
- package/README.md +99 -0
- package/package.json +25 -0
package/LICENSE
ADDED
package/README.md
ADDED
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
# Terra CLI
|
|
2
|
+
|
|
3
|
+
 [![npm]](https://www.npmjs.com/package/@tryterra/cli)
|
|
4
|
+
|
|
5
|
+
[npm]: https://img.shields.io/npm/v/@tryterra/cli.svg?style=flat-square
|
|
6
|
+
|
|
7
|
+
Set up and debug your Terra integration from the terminal. Create environments
|
|
8
|
+
and credentials, turn providers on and off, see which users have connected, and
|
|
9
|
+
replay the webhook events your integration received.
|
|
10
|
+
|
|
11
|
+
Coding agents can drive it too. `terra agent setup` installs the guidance into
|
|
12
|
+
Claude Code, Cursor and Codex, and `terra reference --format json` hands an
|
|
13
|
+
agent every command in a single call.
|
|
14
|
+
|
|
15
|
+
## Get started
|
|
16
|
+
|
|
17
|
+
1. Install the CLI:
|
|
18
|
+
|
|
19
|
+
**npm (all platforms):**
|
|
20
|
+
|
|
21
|
+
```sh
|
|
22
|
+
npm install -g @tryterra/cli
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
2. Log in:
|
|
26
|
+
|
|
27
|
+
```sh
|
|
28
|
+
terra login
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
This opens your browser and prints a pairing code to approve in the
|
|
32
|
+
dashboard.
|
|
33
|
+
|
|
34
|
+
3. Pick an environment and read something:
|
|
35
|
+
|
|
36
|
+
```sh
|
|
37
|
+
terra environments list
|
|
38
|
+
terra environments use dev-prod
|
|
39
|
+
terra users list
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
4. Find any other command:
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
terra reference
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
Every command and flag as one page. Name a group to narrow it:
|
|
49
|
+
`terra reference billing`.
|
|
50
|
+
|
|
51
|
+
## Before you change anything
|
|
52
|
+
|
|
53
|
+
Every command takes `--dry-run`, which prints the request that would be sent and
|
|
54
|
+
touches nothing. It needs no credential, so it is safe against production.
|
|
55
|
+
|
|
56
|
+
```sh
|
|
57
|
+
terra environments update --name Acme --dry-run
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Commands whose response contains a credential will not print it without
|
|
61
|
+
`--reveal`. Destructive ones confirm first, naming the account and environment
|
|
62
|
+
they will act on, and need `--yes` where there is no terminal to ask.
|
|
63
|
+
|
|
64
|
+
## Reporting bugs
|
|
65
|
+
|
|
66
|
+
**Found a security issue? Do not open a public issue.** See the
|
|
67
|
+
[security policy](https://github.com/tryterra/terra-cli/security/policy), which
|
|
68
|
+
routes it privately.
|
|
69
|
+
|
|
70
|
+
For everything else, use
|
|
71
|
+
[GitHub issues](https://github.com/tryterra/terra-cli/issues). Including
|
|
72
|
+
`terra version` and the failing command with `--show-headers` helps: that traces
|
|
73
|
+
the request with credentials redacted and bodies reduced to a byte count, so the
|
|
74
|
+
output is safe to paste. Exit codes are a contract, documented in
|
|
75
|
+
[docs/troubleshooting.md](https://github.com/tryterra/terra-cli/blob/main/docs/troubleshooting.md).
|
|
76
|
+
|
|
77
|
+
For anything specific to your account, billing, or covered by your contract, use
|
|
78
|
+
your usual Terra support channel instead. That tracker is public.
|
|
79
|
+
|
|
80
|
+
The CLI is built from a private repository, so a pull request here has nothing
|
|
81
|
+
to change and cannot be merged. Open an issue instead.
|
|
82
|
+
|
|
83
|
+
## Data collection, usage, and retention
|
|
84
|
+
|
|
85
|
+
Released builds report which commands are run, never flag values or arguments,
|
|
86
|
+
so we can tell which parts of the CLI matter and which are getting in the way.
|
|
87
|
+
[docs/telemetry.md](https://github.com/tryterra/terra-cli/blob/main/docs/telemetry.md) lists every field that is sent and every
|
|
88
|
+
one that is not. To turn it off:
|
|
89
|
+
|
|
90
|
+
```sh
|
|
91
|
+
export TERRA_CLI_TELEMETRY_OPTOUT=1
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
`DO_NOT_TRACK=1` works too, and is honored across tools that follow
|
|
95
|
+
[the convention](https://donottrack.sh).
|
|
96
|
+
|
|
97
|
+
For full details, see Terra's
|
|
98
|
+
[Terms of Service](https://tryterra.co/terms-of-service) and
|
|
99
|
+
[Privacy Policy](https://tryterra.co/privacy).
|
package/package.json
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@tryterra/cli-darwin-x64",
|
|
3
|
+
"version": "0.0.0",
|
|
4
|
+
"description": "The Terra CLI binary for darwin x64",
|
|
5
|
+
"homepage": "https://github.com/tryterra/terra-cli",
|
|
6
|
+
"license": "SEE LICENSE IN LICENSE",
|
|
7
|
+
"repository": {
|
|
8
|
+
"type": "git",
|
|
9
|
+
"url": "git+https://github.com/tryterra/terra-cli.git",
|
|
10
|
+
"directory": "npm/darwin-x64"
|
|
11
|
+
},
|
|
12
|
+
"publishConfig": {
|
|
13
|
+
"access": "public",
|
|
14
|
+
"registry": "https://registry.npmjs.org"
|
|
15
|
+
},
|
|
16
|
+
"os": [
|
|
17
|
+
"darwin"
|
|
18
|
+
],
|
|
19
|
+
"cpu": [
|
|
20
|
+
"x64"
|
|
21
|
+
],
|
|
22
|
+
"files": [
|
|
23
|
+
"bin/terra"
|
|
24
|
+
]
|
|
25
|
+
}
|