@tryterra/cli-win32-arm64 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 ADDED
@@ -0,0 +1,4 @@
1
+ Copyright (c) Terra Enabling Developers, Inc. All rights reserved.
2
+
3
+ Use of the Terra CLI is subject to Terra's Terms of Service:
4
+ https://tryterra.co/terms-of-service
package/README.md ADDED
@@ -0,0 +1,248 @@
1
+ # Terra CLI
2
+
3
+ [![Homebrew]](https://github.com/tryterra/homebrew-tap) [![npm]](https://www.npmjs.com/package/@tryterra/cli) ![](https://img.shields.io/badge/Node.js-18%2B-brightgreen?style=flat-square)
4
+
5
+ [Homebrew]: https://img.shields.io/badge/Homebrew-tryterra%2Ftap-orange?style=flat-square
6
+ [npm]: https://img.shields.io/npm/v/@tryterra/cli.svg?style=flat-square
7
+
8
+ Set up and debug your Terra integration from the terminal. Create environments
9
+ and credentials, turn providers on and off, see which users have connected, and
10
+ replay the webhook events your integration received. `terra data-api` reaches
11
+ the data API too, for the wearable data itself and the user-linking flow.
12
+
13
+ Your coding agent can drive it too, so you can ask for the result instead of
14
+ looking up the command. See [Let your agent drive it](#let-your-agent-drive-it).
15
+
16
+ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
17
+
18
+ ## Get started
19
+
20
+ 1. Install the CLI:
21
+
22
+ **Native Install (macOS and Linux):**
23
+
24
+ ```sh
25
+ curl -fsSL https://cli.tryterra.co/install.sh | sh
26
+ ```
27
+
28
+ Installs into `~/.local/bin` and configures PATH for Bash, Zsh, or fish.
29
+ If prompted, open a new terminal or run the printed PATH command before
30
+ logging in.
31
+ Rerun the installer to update; add `-s -- --help` after `sh` for options.
32
+
33
+ **Native Install (Windows PowerShell, x64 or ARM64):**
34
+
35
+ ```powershell
36
+ irm https://cli.tryterra.co/install.ps1 | iex
37
+ ```
38
+
39
+ Requires Windows PowerShell 5.1 or PowerShell 7. Installs into
40
+ `%LOCALAPPDATA%\Terra\bin` and adds it to your user and current session PATH.
41
+ No administrator privileges are needed.
42
+
43
+ **Homebrew (macOS):**
44
+
45
+ ```sh
46
+ brew install tryterra/tap/terra
47
+ ```
48
+
49
+ **npm (all platforms):**
50
+
51
+ ```sh
52
+ npm install -g @tryterra/cli
53
+ ```
54
+
55
+ On Windows ARM64, use ARM64 Node.js for a native npm installation.
56
+
57
+ 2. Log in:
58
+
59
+ ```sh
60
+ terra login
61
+ ```
62
+
63
+ This opens your browser and prints a pairing code to approve in the
64
+ dashboard.
65
+
66
+ 3. Pick an environment and read something:
67
+
68
+ ```sh
69
+ terra environments list
70
+ terra environments use Production
71
+ terra users list
72
+ ```
73
+
74
+ 4. Ask a question when you are not sure:
75
+
76
+ ```sh
77
+ terra docs ask --question "how do I generate an auth widget"
78
+ ```
79
+
80
+ Answered from the documentation, with links to the pages it came from.
81
+
82
+ 5. Find any other command:
83
+
84
+ Search command names and descriptions, including nested commands:
85
+
86
+ ```sh
87
+ terra help --search webhook
88
+ ```
89
+
90
+ Or read the full reference:
91
+
92
+ ```sh
93
+ terra reference
94
+ ```
95
+
96
+ Every command and flag as one page. Name a group to narrow it:
97
+ `terra reference billing`. Both `terra <command> --help` and
98
+ `terra help <command>` list every supported flag for that command.
99
+
100
+ ## Stay up to date
101
+
102
+ Terra automatically updates Native Installs, global npm, and Homebrew
103
+ installations.
104
+ An invocation can start a background check once every four hours. Your command
105
+ does not wait for the check or installation, and subsequent invocations use the
106
+ updated version. Coding agents can trigger updates; CI does not.
107
+
108
+ To update explicitly, run `terra update`. On Windows, this schedules the update
109
+ after the command exits. Run `terra version` to check the version your shell uses.
110
+
111
+ Project dependencies, npx, and pinned Homebrew installations are not changed
112
+ automatically. Other installation methods receive manual update instructions.
113
+ Updates never request elevated permissions.
114
+
115
+ Set `TERRA_NO_AUTO_UPDATE=1` to keep update notices without installing updates.
116
+ Set `TERRA_NO_UPDATE_NOTIFIER=1` or `DO_NOT_TRACK=1` to disable automatic update
117
+ activity entirely. These settings do not prevent an explicit `terra update`.
118
+
119
+ ## Let your agent drive it
120
+
121
+ Terra configuration usually means clicking around the dashboard, which your
122
+ agent cannot do. Give it the CLI instead. Paste this into Claude Code, Cursor,
123
+ Codex or whatever you use:
124
+
125
+ ```text
126
+ Set up the Terra API CLI for this project. Install it with
127
+ "brew install tryterra/tap/terra" on macOS, or "npm install -g @tryterra/cli"
128
+ otherwise. Then run "terra agent setup" to install Terra's agent skills, read
129
+ the terra-cli skill it writes, and follow its getting-started section to tell
130
+ me what my account is configured to do.
131
+ ```
132
+
133
+ That installs the skills into whichever agent is asking, so your agent then
134
+ knows the commands, the exit codes, and the traps worth avoiding. In a later
135
+ session, once it has picked the skills up, this is enough:
136
+
137
+ ```text
138
+ Get started with Terra API.
139
+ ```
140
+
141
+ It will check that the CLI is authenticated, find your environments, report
142
+ which wearable providers are on and where webhooks are going, and name the gap
143
+ that matters. Then ask for whatever you need:
144
+
145
+ ```text
146
+ Which wearable providers are enabled in my dev environment, and where are its
147
+ webhooks going?
148
+ ```
149
+
150
+ ```text
151
+ A sleep webhook never arrived for user 8f2a1c. Find out what Terra actually
152
+ delivered, and resend it.
153
+ ```
154
+
155
+ ```text
156
+ Set up a staging environment with Garmin and Fitbit turned on, and point its
157
+ webhooks at my tunnel.
158
+ ```
159
+
160
+ Asking questions is safe: reading changes nothing, and a delete refuses to run
161
+ unattended rather than guessing that you meant it.
162
+
163
+ ## Before you change anything
164
+
165
+ Commands that support previews offer `--dry-run`. It sends an authenticated
166
+ request to the API, which reports what would change without committing it.
167
+ Commands without preview support reject the flag.
168
+
169
+ ```sh
170
+ terra environments update --name Acme --dry-run
171
+ ```
172
+
173
+ Destructive commands confirm first, naming the account and environment they
174
+ will act on and what you cannot take back, and need `--yes` where there is no
175
+ terminal to ask. These include deletes and commands that charge a card, rotate
176
+ a live credential, or clear fields you leave out.
177
+
178
+ On a terminal, nested objects appear as sections and arrays of records as
179
+ tables. Wide automatic tables fall back to stacked records. Use `--format json`
180
+ for structured output in scripts.
181
+
182
+ ## Documentation
183
+
184
+ [The CLI section of Terra's documentation][docs] covers the whole tool:
185
+
186
+ - [Installation] for Homebrew, npm, staying up to date, and shell completion
187
+ - [Authentication] for logging in interactively, in CI, or with no browser
188
+ - [Configuration] for environments, profiles, and every variable
189
+ - [Output and scripting] for formats, field selection, pagination, exit codes
190
+ - [Guardrails] for the dry run, secret gating, and confirmations
191
+ - [Raw API requests] for reaching an endpoint that has no command of its own
192
+ - [Coding agents] for driving the CLI from an agent
193
+ - [Ask the docs] for asking a question from the terminal
194
+ - [Command reference] for every command group and the flags they all share
195
+
196
+ [docs]: https://docs.tryterra.co/developer-tools/terra-cli
197
+ [Installation]: https://docs.tryterra.co/developer-tools/terra-cli/installation
198
+ [Authentication]: https://docs.tryterra.co/developer-tools/terra-cli/authentication
199
+ [Configuration]: https://docs.tryterra.co/developer-tools/terra-cli/configuration
200
+ [Output and scripting]: https://docs.tryterra.co/developer-tools/terra-cli/output-and-scripting
201
+ [Guardrails]: https://docs.tryterra.co/developer-tools/terra-cli/guardrails
202
+ [Raw API requests]: https://docs.tryterra.co/developer-tools/terra-cli/raw-requests
203
+ [Coding agents]: https://docs.tryterra.co/developer-tools/terra-cli/coding-agents
204
+ [Ask the docs]: https://docs.tryterra.co/developer-tools/terra-cli/ask
205
+ [Command reference]: https://docs.tryterra.co/developer-tools/terra-cli/command-reference
206
+
207
+ ## What changed
208
+
209
+ Every released version, newest first, is in
210
+ [the changelog](https://github.com/tryterra/terra-cli/blob/main/CHANGELOG.md).
211
+ `terra version` says which one you are on.
212
+
213
+ ## Reporting bugs
214
+
215
+ **Found a security issue? Do not open a public issue.** See the
216
+ [security policy](https://github.com/tryterra/terra-cli/security/policy), which
217
+ routes it privately.
218
+
219
+ For everything else, use
220
+ [GitHub issues](https://github.com/tryterra/terra-cli/issues). Including
221
+ `terra version` and the failing command with `--show-headers` helps: that traces
222
+ the request with credentials redacted and bodies reduced to a byte count, so the
223
+ output is safe to paste. Exit codes are a contract, documented in
224
+ [docs/troubleshooting.md](https://github.com/tryterra/terra-cli/blob/main/docs/troubleshooting.md).
225
+
226
+ For anything specific to your account, billing, or covered by your contract, use
227
+ your usual Terra support channel instead. That tracker is public.
228
+
229
+ The CLI is built from a private repository, so a pull request here has nothing
230
+ to change and cannot be merged. Open an issue instead.
231
+
232
+ ## Data collection, usage, and retention
233
+
234
+ Released builds report which commands are run, never flag values or arguments,
235
+ so we can tell which parts of the CLI matter and which are getting in the way.
236
+ [docs/telemetry.md](https://github.com/tryterra/terra-cli/blob/main/docs/telemetry.md) lists every field that is sent and every
237
+ one that is not. To turn it off:
238
+
239
+ ```sh
240
+ export TERRA_CLI_TELEMETRY_OPTOUT=1
241
+ ```
242
+
243
+ `DO_NOT_TRACK=1` works too, and is honored across tools that follow
244
+ [the convention](https://donottrack.sh).
245
+
246
+ For full details, see Terra's
247
+ [Terms of Service](https://tryterra.co/terms-of-service) and
248
+ [Privacy Policy](https://tryterra.co/privacy).
package/bin/terra.exe ADDED
Binary file
package/package.json ADDED
@@ -0,0 +1,25 @@
1
+ {
2
+ "name": "@tryterra/cli-win32-arm64",
3
+ "version": "0.0.0",
4
+ "description": "The Terra CLI binary for win32 arm64",
5
+ "homepage": "https://docs.tryterra.co/developer-tools/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/win32-arm64"
11
+ },
12
+ "publishConfig": {
13
+ "access": "public",
14
+ "registry": "https://registry.npmjs.org"
15
+ },
16
+ "os": [
17
+ "win32"
18
+ ],
19
+ "cpu": [
20
+ "arm64"
21
+ ],
22
+ "files": [
23
+ "bin/terra.exe"
24
+ ]
25
+ }