Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@zenovay/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Zenovay CLI

The Zenovay terminal — AI install wizard, live analytics, and full MCP integration.

Install

# one-liner (macOS, Linux, Windows via WSL/Git Bash)
curl -fsSL https://cli.zenovay.com/install.sh | sh

# Windows PowerShell 7+
iex ((iwr https://cli.zenovay.com/install.ps1).Content)

# npm
npm install -g @zenovay/cli

# one-shot install wizard
npx @zenovay/wizard

Commands

zenovay init          # AI install wizard — adds tracking to your codebase
zenovay login         # OAuth device flow — works over SSH, in IDE terminals, in CI
zenovay ai            # 3-mode AI assistant (install / chat / MCP management)
zenovay watch         # live TUI dashboard
zenovay events tail   # stream every analytics event in real time
zenovay health        # self-diagnostic
zenovay doctor        # AI-assisted self-healing
zenovay update        # manual update (auto-update runs implicitly)

Every command supports --json / --ndjson for piping. Auto-detects CI=true and headless stdout.

Documentation

CLI reference: https://docs.zenovay.com/cli
Changelog: https://cli.zenovay.com/changelog
Feedback: https://cli.zenovay.com/feedback

Local Development

Prerequisites

Node.js 20 or 22 (CI matrix runs on both)
npm 10+
A Zenovay account is not required for most work — local dev runs against test fixtures, and zenovay login only matters when you exercise the device-flow OAuth against the real api.

Quick start

git clone git@github.com:zenovay/cli-zenovay.git
cd cli-zenovay
npm install
npm run dev          # tsx src/bin.ts — runs the CLI from source
npm run dev -- health
npm run dev -- watch

Common commands

npm run dev          # Run CLI from source via tsx
npm run typecheck    # Strict TypeScript
npm run lint         # ESLint
npm run build        # tsdown bundle
npm test             # Vitest unit tests
npm run test:all     # unit + integration + security corpus
npm run smoke        # End-to-end smoke against a built binary

Releases

cli-zenovay ships actual versioned npm releases via the gold-standard release.yml workflow (semver, signed binaries, multi-stage approval, post-deploy smoke). Releases are triggered by tagging v*.*.*. Read CLAUDE.md §"PUBLISH SAFETY" before any npm publish — the dry-run-then-publish protocol is mandatory.

Status

Private repository. Compiled binaries are public; source is not.

Licensed under the Zenovay CLI License — see LICENSE.