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 [email protected]: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.