@agora-build/atem 0.7.1 → 0.7.2
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/README.md +18 -11
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -34,11 +34,11 @@ atem repl # Interactive REPL with AI command inter
|
|
|
34
34
|
```bash
|
|
35
35
|
atem login # Log in with Agora Console (opens browser)
|
|
36
36
|
atem logout # Log out from SSO
|
|
37
|
-
atem status # Account, pairing, verification and
|
|
37
|
+
atem status # Account, pairing, verification, credentials, Astation link and sessions (read-only)
|
|
38
38
|
atem pair # Pair with Astation, then verify this device (shows the status when already paired)
|
|
39
39
|
atem pair --save # Same, and keep credentials for offline use
|
|
40
40
|
atem pair verify # Verify this device with the paired Astation (no re-pairing)
|
|
41
|
-
atem unpair [--yes] # Remove
|
|
41
|
+
atem unpair [--yes] # Remove the Astation pairing (asks first; your own login stays)
|
|
42
42
|
```
|
|
43
43
|
|
|
44
44
|
`atem login` unlocks a limited set: project list, tokens for the active
|
|
@@ -56,33 +56,39 @@ never from piped input or keys typed earlier, so run `atem pair` in an
|
|
|
56
56
|
interactive terminal. If verification fails, the pairing stays saved, Astation
|
|
57
57
|
is told, and `atem pair` exits nonzero; run `atem pair verify` to retry. A connected or SSO-paired session alone does not
|
|
58
58
|
mean the device is verified; check `atem status`. With `--save`
|
|
59
|
-
the
|
|
60
|
-
5 minutes after the disconnect (atem asks when `--save` isn't given).
|
|
59
|
+
the login Astation shares keeps working when Astation disconnects; without it
|
|
60
|
+
it stops 5 minutes after the disconnect (atem asks when `--save` isn't given).
|
|
61
|
+
While it may be used, Agora API calls (`atem project list`) use it; otherwise
|
|
62
|
+
they use your own `atem login`. One pairing at a time: `atem unpair` removes
|
|
63
|
+
it and keeps your own login.
|
|
61
64
|
|
|
62
65
|
Once paired, `atem pair` only prints the status (`Already paired. Verify this
|
|
63
66
|
device: atem pair verify · Replace the pairing: atem unpair, then atem pair`):
|
|
64
67
|
it never pairs again or changes keys, trust or sessions. `atem pair verify`
|
|
65
68
|
verifies the existing pairing on the runtime's Astation link, does nothing when the
|
|
66
69
|
device is already verified, and refuses after a revocation (run `atem unpair`,
|
|
67
|
-
which sets the revoked keys aside, then `atem pair`). `atem status` reads
|
|
68
|
-
local files and an already running
|
|
69
|
-
|
|
70
|
+
which sets the revoked keys aside, then `atem pair`). `atem status` reads
|
|
71
|
+
local files and asks an already running cred agent and `atem runtime`
|
|
72
|
+
(never starting either, never writing, never using the network): the session
|
|
73
|
+
authorization, the Astation link and the local agents, or `no runtime
|
|
74
|
+
running`.
|
|
70
75
|
|
|
71
76
|
### Device keys (`atem cred`)
|
|
72
77
|
|
|
73
78
|
```bash
|
|
74
79
|
atem cred unlock # Unlock this device's keys (approve with Touch ID on your Mac)
|
|
75
|
-
atem cred lock # Wipe unlocked keys and stop the
|
|
80
|
+
atem cred lock # Wipe unlocked keys and stop the cred agent
|
|
76
81
|
atem cred projects # Send known Git projects to Astation's credential picker (keys must be unlocked)
|
|
77
82
|
```
|
|
78
83
|
|
|
79
84
|
This device's keys are sealed on disk under a storage key that only the paired
|
|
80
85
|
Mac (the home Astation) holds. `atem cred unlock` asks the Mac for it (Touch
|
|
81
|
-
ID) and starts a background `atem
|
|
86
|
+
ID) and starts a background `atem cred-agent` that holds the keys in memory;
|
|
82
87
|
on a device no Astation verified it stops with `This device isn't verified.
|
|
83
88
|
Run atem pair verify first.` and never starts pairing or verification.
|
|
84
89
|
`atem cred lock` wipes them and stops the agent. After upgrading atem, run
|
|
85
|
-
`atem cred lock` then `atem cred unlock` to pick up the new agent
|
|
90
|
+
`atem cred lock` then `atem cred unlock` to pick up the new agent (the unlock
|
|
91
|
+
first updates Atem's runtime, which starts the agent, to the new build).
|
|
86
92
|
|
|
87
93
|
`atem cred projects` sends this repo's Git remote, and the project names atem
|
|
88
94
|
remembers, to Astation's credential picker, encrypted to your Mac. An
|
|
@@ -93,7 +99,7 @@ values from Astation's local Credentials store (`atem cred get/list`) is not
|
|
|
93
99
|
available yet; it is described in the
|
|
94
100
|
[encryption design](https://github.com/Agora-Build/Atem/blob/main/designs/e2e-encryption.md).
|
|
95
101
|
|
|
96
|
-
Updated clients and
|
|
102
|
+
Updated clients and cred agents retain the remote's original capitalization,
|
|
97
103
|
such as `github.com/Agora-Build/Atem`; project identity and duplicate checks
|
|
98
104
|
ignore case. Older clients/agents may report lowercase names. Reports are
|
|
99
105
|
encrypted even when memory encryption is off and can remain in the picker
|
|
@@ -278,6 +284,7 @@ atem agent launch claude -- --help # Use -- to read the agent's own help
|
|
|
278
284
|
atem agent list # The sessions the background runtime holds
|
|
279
285
|
atem agent attach ses-… # Reopen a session (screen restored)
|
|
280
286
|
atem agent stop ses-… # Stop a session
|
|
287
|
+
atem runtime restart # Restart the runtime as this build; sessions keep running
|
|
281
288
|
```
|
|
282
289
|
|
|
283
290
|
`atem agent launch [claude|claude-code|codex] [ARGS]...` runs the installed
|