@vex-chat/cli 0.1.3

package/LICENSING.md

@@ -0,0 +1,15 @@
+# Licensing
+
+## Open source (default)
+
+The default **public** license is the **GNU Affero General Public License v3.0** — see the full text in [`LICENSE`](./LICENSE). The SPDX identifier in `package.json` may use **AGPL-3.0-or-later**; either way, the grant is at least AGPL v3.
+
+## Commercial licensing
+
+Commercial licenses are offered by **Vex Heavy Industries LLC**. See [`LICENSE-COMMERCIAL`](./LICENSE-COMMERCIAL) for contact details ([vex.wtf](https://vex.wtf), **licensing@vex.wtf**).
+
+If you need terms **other than the AGPL** (for example, a proprietary product or a deployment where AGPL obligations are not acceptable), inquire there.
+
+---
+
+_This file summarizes how we intend licensing to work. It is not legal advice. For binding terms, rely on the written agreement or license grant you receive from the copyright holders._

package/README.md

@@ -0,0 +1,62 @@
+# @vex-chat/cli
+
+Terminal chat client for Vex backed by `@vex-chat/libvex`.
+
+```sh
+pnpm vex
+```
+
+On first run, `vex` prompts for a username and registers a local device key.
+After that it opens straight into a live chat session.
+
+By default the CLI connects to production at `api.vex.wtf`. For local Spire development, pass `--local` to use `127.0.0.1:16777` over http/ws. Custom targets can use `--api-url <url>` to set both the host and protocol, or `--host <host:port> --http` to set them separately.
+
+Inside the app:
+
+- `/accounts` lists local users on this machine
+- `/nav` opens a channel or DM
+- `/join [server]` chooses a server, then asks which channel to open
+- `/servers` browses your available servers, then opens a channel
+- `/channels` chooses a channel
+- `/window` lists open chats
+- `/window <number>` switches to an open chat
+- `/user <username-or-user-id>` opens a DM conversation
+- `/inbox` shows DMs, unread counts, and recent senders
+- `/dm` also opens the inbox
+- `/dm <username-or-user-id>` opens a DM conversation
+- `/dm <username-or-user-id> <message>` sends a DM and opens that conversation
+- `/to <username-or-user-id>` opens a DM conversation
+- `/create` asks for a server name and selects its `#general`
+- `/invite` asks for duration and creates a pasteable `vex://invite/...` link
+- `/invite <username-or-user-id>` sends an invite link by DM
+- Incoming `vex://invite/...` links show a server preview and ask whether to join
+- `redeem <code-or-link>` previews a server invite, asks you to confirm, then opens its first channel
+- Plain text sends to the selected DM/channel
+- `/create server <name>` creates a server and selects its `#general`
+- `/invite [duration]` creates a pasteable `vex://invite/...` link for the current server
+- `/members` lists people in the current channel
+- `/whoami`
+- `/quit`
+
+Scriptable helpers still exist:
+
+```sh
+pnpm vex auth register alice
+pnpm vex auth register bob
+pnpm vex alice
+pnpm vex bob
+pnpm vex auth accounts
+pnpm vex dm send bob "hello"
+pnpm vex server create team
+pnpm vex invite redeem <invite-id>
+```
+
+Incoming messages play a small sound by default. Use `--sound off` to disable it, `--sound Glass` for a macOS system sound name, or `--sound /path/to/file.wav` for a custom audio file. `VEX_CHAT_SOUND` works too.
+
+For delivery debugging, run chat with `--debug`:
+
+```sh
+pnpm --silent vex --debug alice
+```
+
+Debug mode writes CLI send/receive/routing decisions to a log file under the CLI data directory. Use `--debug-file ./alice-debug.log` to choose a path. Use `--debug-level trace` only when you also need noisy libvex mail diagnostics.

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@vex-chat/cli",
+  "version": "0.1.3",
+  "description": "Terminal client for vex-chat.",
+  "type": "module",
+  "bin": {
+    "vex-chat": "./src/vex-chat.js"
+  },
+  "files": [
+    "src",
+    "theme.yaml",
+    "LICENSE",
+    "LICENSE-COMMERCIAL",
+    "LICENSING.md",
+    "CLA.md"
+  ],
+  "author": "Extra <extrahash@protonmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vex-protocol/vex-protocol.git",
+    "directory": "apps/vex-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/vex-protocol/vex-protocol/issues"
+  },
+  "homepage": "https://github.com/vex-protocol/vex-protocol/tree/master/apps/vex-cli#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "better-sqlite3": "11.10.0",
+    "msgpackr": "^1.11.9",
+    "@vex-chat/libvex": "^6.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "publint": "0.3.18"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "license": "AGPL-3.0-or-later",
+  "scripts": {
+    "vex": "pnpm --dir ../.. --filter @vex-chat/types --filter @vex-chat/crypto --filter @vex-chat/libvex --if-present build && node src/vex-chat.js",
+    "start": "pnpm --dir ../.. --filter @vex-chat/types --filter @vex-chat/crypto --filter @vex-chat/libvex --if-present build && node src/vex-chat.js",
+    "dev": "pnpm --dir ../.. --filter @vex-chat/types --filter @vex-chat/crypto --filter @vex-chat/libvex --if-present build && node scripts/dev-watch.mjs",
+    "watch": "pnpm --dir ../.. --filter @vex-chat/types --filter @vex-chat/crypto --filter @vex-chat/libvex --if-present build && node scripts/dev-watch.mjs",
+    "diagnose": "node scripts/diagnose-three-clients.mjs",
+    "smoke": "node scripts/smoke-three-clients.mjs",
+    "lint:pkg": "publint --strict"
+  }
+}