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 overview      # one-shot dashboard summary
zenovay live          # real-time visitor / event stream
zenovay globe         # standalone 3D Braille Earth (press [o] for the photoreal web globe)
zenovay events tail   # stream every analytics event in real time
zenovay status-agent  # background daemon → tmux status bar + threshold alerts (see below)
zenovay telemetry     # manage anonymous CLI usage telemetry (on / off / status)
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.

Status-agent

Background daemon that polls your live + errors + revenue every 60s and writes a tmux-format status line to ~/.zenovay/tmux-status. Optional desktop notifications when threshold rules trigger.

# Start
zenovay status-agent --daemonize --notify-on "error_rate>5"

# Wire into tmux (~/.tmux.conf)
zenovay status-agent --install-tmux   # prints the conf line; copy + reload tmux

# Auto-start on boot
zenovay status-agent --install-systemd  # → ~/.config/systemd/user/zenovay-status.service
zenovay status-agent --install-launchd  # macOS → ~/Library/LaunchAgents/

# Stop
zenovay status-agent --stop

Notification platforms (auto-detected, with graceful fallback to OSC 9 bell):

macOS: terminal-notifier (brew install terminal-notifier)
Linux: notify-send (apt install libnotify-bin)
Windows + others: OSC 9 (works in Windows Terminal, iTerm2, WezTerm, Konsole)

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.