@crvouga/personal 0.1.2 → 0.1.4
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 +25 -3
- package/cli.mjs +12174 -1883
- package/commands.json +224 -28
- package/package.json +3 -3
- package/probe.mjs +86 -11
- package/releasing.md +12 -2
- package/schema.json +19 -3
package/README.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# Personal CLI
|
|
2
2
|
|
|
3
|
+
Start with `personal` for help; it never opens a menu implicitly.
|
|
4
|
+
|
|
5
|
+
```sh
|
|
6
|
+
personal
|
|
7
|
+
personal index --json
|
|
8
|
+
personal agent --json
|
|
9
|
+
personal t3-apply --help
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
The index includes per-command help, mutation defaults, preview instructions and
|
|
13
|
+
required authorization. `--json` changes output format; it does not prevent writes.
|
|
14
|
+
`commands` remains an alias-compatible name for `index`. Use `personal --interactive`
|
|
15
|
+
only when you want the terminal menu.
|
|
16
|
+
|
|
3
17
|
Use the installed `personal` executable for routine work. `npx @crvouga/personal`
|
|
4
18
|
is the same CLI when it is not installed.
|
|
5
19
|
|
|
@@ -51,7 +65,7 @@ Requires Node **22.13+ on the 22.x line, or 23.5+** with npm.
|
|
|
51
65
|
npx --yes @crvouga/personal
|
|
52
66
|
```
|
|
53
67
|
|
|
54
|
-
|
|
68
|
+
With `personal --interactive`, the terminal application has a flat searchable command palette sorted A–Z with group prefixes,
|
|
55
69
|
descriptions, target selection, progress indicators, result summaries, searchable
|
|
56
70
|
node/status/check drill-downs, remedies, retry/back navigation, and an add-node
|
|
57
71
|
wizard. It shows the equivalent noninteractive command before running anything.
|
|
@@ -71,7 +85,7 @@ npx --yes @crvouga/personal@latest fleet doctor --node dev-linux --json
|
|
|
71
85
|
|
|
72
86
|
Pin an **exact released version** instead of `latest` for automation. Direct
|
|
73
87
|
commands, `--json`, `--non-interactive` and redirected input never open prompts.
|
|
74
|
-
No arguments
|
|
88
|
+
No arguments prints help in every environment, including a terminal. `personal --json` or `personal index --json` prints the structured command index. The menu requires `personal --interactive`. JSON is one versioned
|
|
75
89
|
document on stdout; interactive chrome and progress use stderr. Exit codes:
|
|
76
90
|
**0** success/preview, **1** failed operation/check, **2** invalid usage/config,
|
|
77
91
|
**130** cancellation. `--strict` makes warnings and skips fail too.
|
|
@@ -176,7 +190,8 @@ untrusted checkout: setup/dependency lifecycle scripts are executable code.
|
|
|
176
190
|
## Development and release
|
|
177
191
|
|
|
178
192
|
```sh
|
|
179
|
-
bun run personal #
|
|
193
|
+
bun run personal # help
|
|
194
|
+
bun run personal --interactive # optional interactive menu
|
|
180
195
|
bun run --cwd packages/personal-cli tc
|
|
181
196
|
bun run --cwd packages/personal-cli lint
|
|
182
197
|
bun run --cwd packages/personal-cli test
|
|
@@ -236,3 +251,10 @@ See [fleet access and repair research](../fleet/docs/access-and-repair-research.
|
|
|
236
251
|
for the comparison of mise, OpenBao, Bitwarden, 1Password, Tailscale SSH, chezmoi,
|
|
237
252
|
Teleport, Ansible and Syncthing, plus existing password-manager onboarding and
|
|
238
253
|
the distinction between shared service secrets and per-machine logins.
|
|
254
|
+
|
|
255
|
+
## Ubuntu one-command synchronization
|
|
256
|
+
|
|
257
|
+
See [the Fleet operator and implementation status guide](../fleet/docs/ubuntu-sync.md).
|
|
258
|
+
`personal fleet-sync` and `personal fleet converge` share the guarded controller-driven
|
|
259
|
+
flow. Full Ubuntu baseline and fleet acceptance remain incomplete; a profile
|
|
260
|
+
apply does not claim machine readiness. Existing commands retain their semantics.
|