@vox-ai/cli-linux-x64 0.1.0-beta.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fleek Fitness
+
+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,157 @@
+# @vox-ai/cli
+
+vox.ai CLI for agent-as-code workflows.
+
+`vox` lets you build, validate, diff, and ship [vox.ai](https://www.tryvox.co) voice agents as code. It is designed to be driven both by people in a terminal and by coding agents (Claude Code, Codex, and similar): edit JSON sources in your repo, read structured `--json` output, review diffs, and push when you are ready.
+
+The CLI is the durable authoring surface — what belongs in your repo, gets reviewed, and can be reproduced or rolled back. The dashboard stays the viewer and admin surface.
+
+## Install
+
+```bash
+# npm (macOS, Linux, and Windows x64; requires Node >= 20.17)
+npm install -g @vox-ai/cli
+
+# npm pre-release channel
+npm install -g @vox-ai/cli@beta
+
+# Homebrew (macOS)
+brew install vox-public/tap/vox
+```
+
+On **Windows**, npm is the official install path: `npm install -g @vox-ai/cli@beta`, then run `vox` (or `vox.cmd`) from any terminal. There is no separate `.exe` or zip download to install.
+
+Verify the install:
+
+```bash
+vox --version
+vox --help
+```
+
+## Quick Start
+
+```bash
+# 1. Sign in (OAuth in your browser)
+vox auth login
+vox auth whoami --json
+
+# 2. Read the operating contract (especially useful for coding agents)
+vox guide coding-agent
+
+# 3. Start a project — scaffold a new one, or import what already exists
+vox init
+# or, in an existing workspace:
+vox sync import --all --dry-run --json
+```
+
+## Agent-as-Code Workflow
+
+The core loop is a code workflow, not a sequence of dashboard clicks:
+
+```text
+pull / init  ->  edit JSON files  ->  doctor / validate  ->  diff / status  ->  push  ->  version save / promote
+```
+
+- `vox agent pull` / `vox init` — bring remote agents into local JSON source.
+- Edit the JSON files in your editor or with a coding agent.
+- `vox agent doctor` / `vox agent validate` — catch authoring risks before you push.
+- `vox agent diff` / `vox agent status` — review exactly what will change.
+- `vox agent push` — apply your local source to the remote draft.
+- `vox agent version save` / `vox agent promote` — snapshot an immutable version and promote it to production.
+
+## Commands
+
+A high-level map of the public surface. Run any command with `--help` for details, or add `--json` for structured output.
+
+| Area | Commands |
+| --- | --- |
+| Auth & config | `auth login`, `auth whoami`, `auth switch`, `auth logout`, `config get/set` |
+| Get started | `init`, `doctor`, `guide coding-agent`, `guide flow` |
+| Discover offline | `docs search/show`, `skills list/show`, `schema list/get` |
+| Authoring | `agent …`, `tool …`, `knowledge …` (plan, create, edit, validate, diff, push, version, promote) |
+| Sync | `sync status`, `sync import`, `sync bootstrap` |
+| Multi-org | `org list`, `org switch`, `workspace init` |
+| Runtime & telephony | `chat`, `call …`, `number …`, `version`, `upgrade` |
+
+## Using vox from Coding Agents
+
+`vox` is built to be a first-class tool for coding agents. Point your agent at these bootstrap commands:
+
+```bash
+vox guide coding-agent --json     # the operating contract to follow
+vox docs search "<query>" --json  # offline official docs
+vox skills list --json            # design playbooks and workflow routing
+vox schema get <namespace> <schema-type> --json
+```
+
+Every command accepts `--json` and emits a stable envelope (`{ ok, data }` on success, `{ ok: false, error: { code, message, … } }` on failure), so agents and automation can branch on results, read `error.details.hint`, and follow `related_commands`.
+
+## Authentication
+
+- vox uses **OAuth only**. `vox auth login` opens your browser and completes a loopback flow.
+- Refresh tokens are stored in your OS keychain / secret store — never in project files.
+- Project and workspace JSON never contain tokens or secrets.
+
+## Telemetry and Privacy
+
+Official builds send anonymous usage telemetry to help improve the CLI. It records coarse signals such as the command name, exit status, CLI version, and OS — never your arguments, file contents, tokens, agent data, or organization identifiers.
+
+Opt out at any time:
+
+```bash
+vox config set settings.telemetry disabled
+# or, per-process:
+DO_NOT_TRACK=1 vox …
+VOX_TELEMETRY_DISABLED=1 vox …
+```
+
+Development and local builds never emit telemetry.
+
+## Upgrade
+
+`vox upgrade` is a package-manager aware upgrade assistant: it detects how vox was installed (npm, Homebrew, standalone, or unknown) and prints the exact upgrade command for that install. It never modifies your installation itself — run the printed command to update.
+
+```bash
+vox upgrade                              # detect the install and print the exact upgrade command
+vox upgrade --channel beta               # check the beta channel
+vox upgrade --json                       # structured output for scripts / coding agents
+npm install -g @vox-ai/cli@latest        # update an npm install
+brew upgrade vox-public/tap/vox          # update a Homebrew install
+```
+
+For Homebrew, `vox upgrade` distinguishes the newest upstream release from what the formula currently offers, so it won't tell you to `brew upgrade` before the formula has caught up. `vox upgrade --json` (schema `vox.ai.cli.upgrade.v2`) returns `status`, `confidence`, `actions`, and `verify_commands` so a coding agent can pick the next command without parsing human text.
+
+### Update notices
+
+vox occasionally checks — at most once a day, when you run a command — whether a newer version is published, and caches the result locally (no daemon, no background process). When an update exists, it prints a single line to stderr on your next interactive run:
+
+```text
+A newer vox.ai CLI is available: 0.1.0-beta.9
+Run `vox upgrade` for the exact upgrade command.
+```
+
+The check only queries the public npm registry — it is not telemetry and sends no account, organization, or auth information. It stays silent for `--json`, non-interactive shells, and CI, and never changes a command's exit code. **Homebrew installs are not nudged by this periodic notice** (npm alone cannot tell whether the formula has published the new version yet) — run `vox upgrade` or `brew outdated` for accurate Homebrew guidance. Turn it off with:
+
+```bash
+VOX_NO_UPDATE_NOTIFIER=1 vox …
+```
+
+### macOS code signing
+
+Official macOS binaries are signed with the company Developer ID Application identity, with a stable signing identity across builds:
+
+```text
+Identifier=ai.vox.cli
+TeamIdentifier=Z47Q5G9FA2
+Authority=Developer ID Application: Fleek Corp. (Z47Q5G9FA2)
+```
+
+Because the identity is stable, the macOS Keychain "Always Allow" choice keeps applying across `brew upgrade`s instead of re-prompting on every update. The first release that moves to the company Developer ID may prompt once (the identity changed from the previous one); after that it stays quiet while the identity is unchanged. This phase ships a Developer ID signature, not Apple notarization. Inspect it with `codesign -dvvv "$(which vox)"`.
+
+## Support
+
+- Homepage: https://www.tryvox.co
+- Documentation: https://docs.tryvox.co
+- npm package: https://www.npmjs.com/package/@vox-ai/cli
+
+Licensed under the MIT License.

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@vox-ai/cli-linux-x64",
+  "version": "0.1.0-beta.10",
+  "description": "Prebuilt linux-x64 binary for the vox.ai CLI",
+  "homepage": "https://www.tryvox.co",
+  "license": "MIT",
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "bin": {
+    "vox": "bin/vox"
+  },
+  "files": [
+    "bin/vox",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.17.0"
+  }
+}