@supernala/cli 0.0.0-stage → 0.1.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/README.md CHANGED
@@ -1,3 +1,40 @@
1
- # Temporary Holding Version
1
+ # @supernala/cli
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Connect your own computer to a Supernala workspace as a **Machine**, so your Agents can read files,
4
+ run commands and work with your coding agents (Claude Code, Codex, OpenCode, pi) there, and so you
5
+ can run coding agent Sessions from Supernala.
6
+
7
+ Requires Node.js 22.4 or later.
8
+
9
+ ## Connect
10
+
11
+ ```sh
12
+ supernala connect # pairs this computer; approve the code in Supernala
13
+ supernala daemon # keeps the connection open while you want Agents to reach it
14
+ ```
15
+
16
+ The Machine starts **Read-only** for all Agents. Change its Agent access and mode in Supernala under
17
+ Machines → Computers. Full access lets the chosen Agents run any command as you on this computer.
18
+
19
+ ## Commands
20
+
21
+ | Command | What it does |
22
+ | ---------------------------------------- | -------------------------------------------------------------- |
23
+ | `supernala connect` | Pair this computer with a workspace |
24
+ | `supernala daemon` | Keep the connection open; runs commands and Sessions |
25
+ | `supernala status` | Show the connection |
26
+ | `supernala stop` | Stop a running daemon |
27
+ | `supernala disconnect` | Forget this computer's credential |
28
+ | `supernala doctor` | Check the setup and installed coding agents |
29
+ | `supernala files ls / pull / push` | Move files between this computer and Workspace Files |
30
+ | `supernala send <paths…> [-m note]` | Hand files back to the Agent that started this command or turn |
31
+ | `supernala skills install [--agent …]` | Teach your coding agents to work with Supernala |
32
+
33
+ ## Security
34
+
35
+ - The Machine holds an Ed25519 key in `~/.supernala` (mode 0600); your Supernala sign-in never
36
+ leaves the browser.
37
+ - The connection is outbound only; nothing listens on this computer.
38
+ - Workspace Secrets are never sent to a Machine.
39
+ - Session transcripts are stored in your workspace and count toward its storage; delete them in
40
+ Machines, or turn on auto-delete.