@tinycloud/cli 1.0.0-beta.15 → 1.0.0-beta.17

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
@@ -8,7 +8,16 @@ Self-sovereign storage from the terminal. `tc` is the command-line interface for
8
8
  npm install -g @tinycloud/cli
9
9
  ```
10
10
 
11
- Requires Node.js >= 20.
11
+ Requires Node.js >= 20. On Linux, `/usr/sbin/tc` (iproute2) can shadow this
12
+ CLI; call it as `"$(npm prefix --global)/bin/tc"` when in doubt.
13
+
14
+ ## Agent skills
15
+
16
+ The package ships the general `tc-cli` skill and its references in
17
+ `skills/tc-cli`. See [skill installation](skills/tc-cli/INSTALL.md) for a
18
+ pinned, cross-agent installation with OpenCode, Codex and Claude Code, and
19
+ [authentication](skills/tc-cli/AUTH.md) for device login and relaying the
20
+ approval code to the owner.
12
21
 
13
22
  ## Operations coverage
14
23
 
@@ -34,11 +43,17 @@ tc init
34
43
  # Authenticate via browser
35
44
  tc auth login
36
45
 
37
- # Authenticate on a remote/headless machine
38
- tc auth login --device
46
+ # Authenticate on a remote/headless machine: the owner approves an explicit
47
+ # manifest on their phone (URL + code printed to stderr). Use a new profile
48
+ # name if it already exists; keep the user's existing profiles.
49
+ tc init --name publisher --key-only
50
+ tc --profile publisher auth login --device --manifest builtin:share-publishing
51
+
52
+ # Same Share publishing scope, as a shortcut (on the dedicated profile)
53
+ tc --profile publisher enable share
39
54
 
40
- # Enable only Share publishing authority
41
- tc enable share
55
+ # Selected profile, owner, host and space (JSON; does not test access)
56
+ tc context
42
57
 
43
58
  # Store and retrieve data
44
59
  tc kv put greeting "Hello, world"
@@ -64,8 +79,10 @@ tc delegation create --to did:pkh:eip155:1:0x...
64
79
  |---------|-------------|
65
80
  | `tc init` | Set up a profile and generate keys |
66
81
  | `tc auth login` | Authenticate via browser |
67
- | `tc auth login --device` | Authenticate with an OpenKey URL and user code |
68
- | `tc enable share` | Enable narrowly scoped Share publishing authority |
82
+ | `tc auth login --device --manifest <file>` | Approve exactly a manifest's permissions on another device (phone) |
83
+ | `tc auth login --manifest <file>` | Browser OpenKey login scoped to a manifest |
84
+ | `tc enable share` | Device login with the built-in Share publishing manifest (use a dedicated profile) |
85
+ | `tc context` | Show the selected profile, owner, host, space and session state |
69
86
  | `tc auth status` | Show authentication status |
70
87
  | `tc auth whoami` | Show current identity |
71
88
  | `tc kv get <key>` | Retrieve a value |