From 988a0eecd522431980174910db28e45a63ff2710 Mon Sep 17 00:00:00 2001 From: Christophe Besson Date: Thu, 15 Oct 2026 12:32:24 +0200 Subject: feat(cli): account, rm -r and mkdir, Tab completion MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit account shows the account and does what the sign-up form and the Profile page do: register (the passphrase floor and the hub's proof of work checked here, the recovery key printed once), verify, change the passphrase, reset a forgotten one, change the e-mail address, sign out everywhere, delete. A new passphrase carries the copy of the account's keys each node keeps for browsers first — opened under the old M, the same keys sealed under the new one — and only then tells the hub; a refusal sets the copies back. A reset restores them from the recovery copy. The connections that do it never make keys nor ask for a device approval. This machine keeps the M it changed away from, so a node out of reach is carried at its next connection; a copy under an M it does not know is no longer rewritten, which locked the browsers out after a passphrase changed elsewhere. rm -r removes a folder and all it holds, from the node's operator key: the files, then the folders deepest first, one confirmation that counts them. mkdir makes folders, --parents the missing ones (not -p, the passphrase). completion bash|powershell prints the script that makes Tab complete actions, verbs, options and the paths of the groups this machine is signed in to, cached two minutes; the deb and rpm packages install the bash one. Co-Authored-By: Claude Opus 5.5 --- docs/USERGUIDE.md | 29 ++++++++++++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) (limited to 'docs/USERGUIDE.md') diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md index 93205d3..6035a1e 100644 --- a/docs/USERGUIDE.md +++ b/docs/USERGUIDE.md @@ -248,6 +248,8 @@ meshbay-cli get -R Family/photos/2024 # download, here; -o elsewhere meshbay-cli stream --player vlc 'Family/films/Night Drive.mkv' # play it; Ctrl+C stops meshbay-cli put -R ~/scans Family/documents meshbay-cli rm Family/documents/old-draft.odt # asks first; --yes in a script +meshbay-cli mkdir --parents Family/documents/2026/taxes +meshbay-cli rm -r Family/documents/2019 # a folder and all it holds meshbay-cli logout ``` @@ -259,7 +261,8 @@ run the same `get`. `stream` plays a film or a song without downloading it: it prints an address to open in VLC or mpv (or starts the player with `--player`), which works on this computer only and until you press Ctrl+C or close the player; skipping ahead in the player works. `rm` deletes what you uploaded, from any of your devices; -the node's operator can delete anything. Run `meshbay-cli` with nothing after it for a two-pane +the node's operator can delete anything, and only the operator removes a +folder (`rm -r`, which says how many files go before it asks). Run `meshbay-cli` with nothing after it for a two-pane view: this computer on the left, your groups on the right, F5 to copy the selection across, Delete to delete it from the group (what `rm` may delete). @@ -294,6 +297,30 @@ open, with your passphrase alone, a group you joined from it. To allow that, as *Browser access* does in the application, run `meshbay-cli browser-access on` on that computer; `off` takes the copy back. It is that computer's setting. +Your account, from the client: + +```bash +meshbay-cli account # name, e-mail address, status +meshbay-cli account register -u alice --email alice@example.org +meshbay-cli account passphrase # change it; asks the current one, then the new +meshbay-cli account reset -u alice --email alice@example.org # forgotten: a code by e-mail +meshbay-cli account email new@example.org +meshbay-cli account sign-out-everywhere +meshbay-cli account delete +``` + +`register` prints your recovery key once: keep it apart from your passphrase, +it is what gives your groups back after a `reset`. Changing the passphrase +carries the copy of your keys each node keeps for browsers over to the new one +first; a node out of reach is carried the next time this computer connects to it. + +Tab completes actions, options and the paths in your groups once the shell +knows how. In bash, add `eval "$(meshbay-cli completion bash)"` to `~/.bashrc` +(the Linux packages install it already); in PowerShell, add +`meshbay-cli completion powershell | Out-String | Invoke-Expression` to your +`$PROFILE`. It never asks for anything: on a computer that is not signed in, +it completes actions and options only. + Managing a node is not the client's job: that is `meshbay-node` (§6). --- -- cgit v1.2.3