@tryterra/cli-darwin-x64 0.14.1 → 0.16.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.
Files changed (3) hide show
  1. package/README.md +30 -10
  2. package/bin/terra +0 -0
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -19,7 +19,7 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
19
19
 
20
20
  1. Install the CLI:
21
21
 
22
- **Standalone (macOS and Linux):**
22
+ **Native Install (macOS and Linux):**
23
23
 
24
24
  ```sh
25
25
  curl -fsSL https://cli.tryterra.co/install.sh | sh
@@ -30,6 +30,16 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
30
30
  logging in.
31
31
  Rerun the installer to update; add `-s -- --help` after `sh` for options.
32
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
+
33
43
  **Homebrew (macOS):**
34
44
 
35
45
  ```sh
@@ -42,6 +52,8 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
42
52
  npm install -g @tryterra/cli
43
53
  ```
44
54
 
55
+ On Windows ARM64, use ARM64 Node.js for a native npm installation.
56
+
45
57
  2. Log in:
46
58
 
47
59
  ```sh
@@ -87,15 +99,22 @@ The documentation is at [docs.tryterra.co/developer-tools/terra-cli][docs].
87
99
 
88
100
  ## Stay up to date
89
101
 
90
- Terra checks for updates once a day during terminal use. When a newer release
91
- is available, the notice shows the command for your installation and a link
92
- to the release notes.
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.
93
110
 
94
- For Homebrew, run `brew upgrade tryterra/tap/terra`. For a global npm install,
95
- run `npm install -g @tryterra/cli@latest`. Run `terra version` afterwards to
96
- check the version your shell uses.
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.
97
114
 
98
- Set `TERRA_NO_UPDATE_NOTIFIER=1` to disable update checks.
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`.
99
118
 
100
119
  ## Let your agent drive it
101
120
 
@@ -143,8 +162,9 @@ unattended rather than guessing that you meant it.
143
162
 
144
163
  ## Before you change anything
145
164
 
146
- Every command takes `--dry-run`, which prints the request that would be sent and
147
- touches nothing. It needs no credential, so it is safe against production.
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.
148
168
 
149
169
  ```sh
150
170
  terra environments update --name Acme --dry-run
package/bin/terra CHANGED
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tryterra/cli-darwin-x64",
3
- "version": "0.14.1",
3
+ "version": "0.16.0",
4
4
  "description": "The Terra CLI binary for darwin x64",
5
5
  "homepage": "https://docs.tryterra.co/developer-tools/terra-cli",
6
6
  "license": "SEE LICENSE IN LICENSE",