cloudtifact 0.2.3 → 0.3.0

package/README.md

@@ -1,13 +1,18 @@
-# cloudtifact
+# Cloudy CLI
 
-The command line for [Cloudtifact](https://cloudtifact.com): publish pages and docs folders as links
+The command line for [Cloudy](https://cloudtifact.com): publish pages and docs folders as links
 people comment on, keep every version, and give the comments back to your coding agent.
 
 ```sh
-npm i -g cloudtifact
+npm i -g usecloudy
 ```
 
-Or run it once without installing: `npx cloudtifact publish page.html`.
+The command it installs is `cloudy`. `cloudtifact` still works as the same command, so older scripts and hooks keep
+running. The same CLI is also on npm under its old package name, `cloudtifact`, kept up to date for existing installs.
+Both packages install the same commands, so keep only one: to move, run `npm rm -g cloudtifact`, then
+`npm i -g usecloudy`.
+
+Or run it once without installing: `npx usecloudy publish page.html`.
 
 Without npm, use the install script:
 
@@ -15,13 +20,15 @@ Without npm, use the install script:
 curl -fsSL https://api.cloudtifact.com/install.sh | sh
 ```
 
-The script puts the CLI in `~/.cloudtifact` and adds `~/.cloudtifact/bin` to your PATH. Open a new terminal afterwards.
+The script puts the CLI in `~/.cloudtifact` (commands `cloudy` and `cloudtifact`) and adds `~/.cloudtifact/bin` to your PATH. Open a new terminal afterwards.
 
 ```sh
-cloudtifact login
-cloudtifact publish page.html      # one page or folder → a link
-cloudtifact init && cloudtifact push   # a repo's docs folder, versioned
-cloudtifact comments --toon        # what reviewers said, compact for agents
+cloudy login
+cloudy publish page.html      # one page or folder → a link
+cloudy copy https://cloudtifact.app/<id>/   # your own copy of a page someone sent
+cloudy context pull --space <id>            # Discord thread linked to the space
+cloudy init && cloudy push   # a repo's docs folder, versioned
+cloudy comments --toon        # what reviewers said, compact for agents
 ```
 
 Requires Node.js 20 or later. The CLI is one file with no dependencies.
@@ -29,10 +36,11 @@ Requires Node.js 20 or later. The CLI is one file with no dependencies.
 ## Update and remove
 
 ```sh
-cloudtifact upgrade
+cloudy upgrade
 ```
 
-Installed with npm: `npm i -g cloudtifact@latest` to update, `npm rm -g cloudtifact` to remove.
+Installed with npm: `npm i -g usecloudy@latest` to update, `npm rm -g usecloudy` to remove (`cloudtifact` in
+place of `usecloudy` if you installed the old package).
 
 Installed with the script: `upgrade` downloads the latest CLI and replaces `~/.cloudtifact/cloudtifact.mjs`.
 It prints the old and new version, or says the CLI is already up to date.
@@ -45,8 +53,8 @@ To remove a script install:
 
 ```sh
 rm -rf ~/.cloudtifact               # the CLI
-rm -f ~/.local/bin/cloudtifact      # the link, if the installer made one
-rm -rf ~/.config/cloudtifact        # the saved token (run `cloudtifact logout` first to revoke it)
+rm -f ~/.local/bin/cloudy ~/.local/bin/cloudtifact   # the links, if the installer made them
+rm -rf ~/.config/cloudtifact        # the saved token (run `cloudy logout` first to revoke it)
 ```
 
 If the installer added a PATH line to your shell's startup file (`~/.zshrc`, `~/.bashrc`, `~/.bash_profile`,
@@ -56,12 +64,12 @@ mentions `.cloudtifact/bin`.
 ## More than one account
 
 ```sh
-cloudtifact login                  # again, approving as your other account: adds it
-cloudtifact accounts               # * marks the active one
-cloudtifact switch                 # toggle between two (or: switch <handle>)
-cloudtifact push --account work    # one command as another account
-cloudtifact switch work --here     # this repo always uses @work, on this machine
-cloudtifact logout --account work  # sign out of one (or --all)
+cloudy login                  # again, approving as your other account: adds it
+cloudy accounts               # * marks the active one
+cloudy switch                 # toggle between two (or: switch <handle>)
+cloudy push --account work    # one command as another account
+cloudy switch work --here     # this repo always uses @work, on this machine
+cloudy logout --account work  # sign out of one (or --all)
 ```
 
 A folder set with `--here` never falls back to another account: if that account isn't signed in, the command stops.
@@ -69,13 +77,13 @@ A folder set with `--here` never falls back to another account: if that account
 ## For agents
 
 Add `--toon` (fewest tokens) or `--json` to commands that print data, or set `CLOUDTIFACT_FORMAT=toon`.
-`cloudtifact init --hooks` installs a skill and hooks for Claude Code, Codex and Cursor.
+`cloudy init --hooks` installs a skill and hooks for Claude Code, Codex and Cursor.
 
 ## Configuration
 
 | Variable | Use |
 | --- | --- |
-| `CLOUDTIFACT_API_URL` | Point at another Cloudtifact server (self-hosted). The saved token is only sent to the server it came from, so run `cloudtifact login` with it set to sign in there |
+| `CLOUDTIFACT_API_URL` | Point at another Cloudy server (self-hosted). The saved token is only sent to the server it came from, so run `cloudy login` with it set to sign in there |
 | `CLOUDTIFACT_FORMAT` | Default output: `text`, `toon` or `json` |
 | `CLOUDTIFACT_ACCOUNT` | Use this signed-in account (a handle), like `--account` |
 | `CLOUDTIFACT_TOKEN` | Use this token instead of any saved sign-in, for CI |