@ref0/cli 0.5.0 → 0.6.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.
Files changed (3) hide show
  1. package/README.md +6 -2
  2. package/dist/main.mjs +2545 -1429
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -4,13 +4,17 @@
4
4
 
5
5
  ```sh
6
6
  npm i -g @ref0/cli
7
- ref0 connect --harness claude-code --owner <your owner name>
7
+ ref0 connect --harness claude-code
8
8
  ```
9
9
 
10
- `ref0 connect` connects this machine to one of your agents. Run it in your own terminal: it shows a code, which you type under Waiting on you on ref0 and approve with your passkey. With `--harness claude-code` or `--harness codex`, it also installs ref0's plugin into that harness. `ref0 --help` lists every command.
10
+ `ref0 connect` connects this machine to one of your agents. Run it in your own terminal: it shows a link to open on ref0.dev and a code for Find under Waiting on you. Approve with your passkey, then paste the answer code from your own page into that terminal. With `--harness claude-code` or `--harness codex`, it also installs ref0's plugin from the public [ref-0/plugins marketplace](https://github.com/ref-0/plugins) into that setup. The marketplace holds the latest release. Before installing, ref0 checks the fetched plugin's hook protocol. A compatible version works with an older CLI; a mismatch installs nothing and gives the update command. `ref0 --help` lists every command.
11
11
 
12
12
  It needs Node.js 22.19 or later.
13
13
 
14
14
  Before it requests a code, `ref0 connect` checks that the keychain can store, read and clear a probe item. It stops after a minute if the keychain does not answer.
15
15
 
16
16
  On Linux, `ref0` keeps its grant in the secret service through `secret-tool`. Install `secret-tool` with `sudo apt install libsecret-tools` on Debian or Ubuntu, `sudo dnf install libsecret` on Fedora or `sudo pacman -S libsecret` on Arch. If `secret-tool` is installed, unlock the keychain or start a secret service before trying again.
17
+
18
+ To add the marketplace yourself, run `claude plugin marketplace add ref-0/plugins`, then `claude plugin install ref0@ref0 --scope user`, or `codex plugin marketplace add ref-0/plugins`, then `codex plugin add ref0@ref0`. Run `ref0 connect --harness <claude-code or codex>` to connect the setup. A setup without a kept agent says that line at session start.
19
+
20
+ Connecting also writes `~/.ref0/bin/ref0` with the absolute Node and CLI paths, so the plugin runs when its harness has neither on `PATH`. If you move or remove that Node installation, run connect or install again with the Node you use now.