cloudtifact 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Cloudtifact authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# cloudtifact
+
+The command line for [Cloudtifact](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
+```
+
+Or run it once without installing: `npx cloudtifact publish page.html`.
+
+Without npm, use the install script:
+
+```sh
+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.
+
+```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
+```
+
+Requires Node.js 20 or later. The CLI is one file with no dependencies.
+
+## Update and remove
+
+```sh
+cloudtifact upgrade
+```
+
+Installed with npm: `npm i -g cloudtifact@latest` to update, `npm rm -g cloudtifact` to remove.
+
+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.
+
+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)
+```
+
+If the installer added a PATH line to your shell's startup file (`~/.zshrc`, `~/.bashrc`, `~/.bash_profile`,
+`~/.profile` or `~/.config/fish/config.fish`), delete it too. It sits under a `# cloudtifact` comment and
+mentions `.cloudtifact/bin`.
+
+## 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.
+
+## Configuration
+
+| Variable | Use |
+| --- | --- |
+| `CLOUDTIFACT_API_URL` | Point at another Cloudtifact server (self-hosted or staging) |
+| `CLOUDTIFACT_FORMAT` | Default output: `text`, `toon` or `json` |
+
+The token from `login` is stored in `~/.config/cloudtifact/config.json` (or `$XDG_CONFIG_HOME`).
+
+## Docs
+
+Every command and option: the [CLI reference](https://cloudtifact.com/docs/reference/cli).
+
+MIT licensed.