ZENOVAYcli

Changelog

Cada versión del Zenovay CLI, de la más reciente a la más antigua.

$curl -fsSL https://cli.zenovay.com/install.sh | sh
v1.0.36

Install without logging in, using --tracking-code

Destacados
  • zenovay init --tracking-code ZV_… installs the tracker without a login and without a single network call. Until now init always had to sign in and fetch your site list first, which made it awkward to run anywhere a browser and a stored token are not available: a CI job, a Dockerfile, a container. Pass the tracking code from your site's settings and the whole run is local file edits.
Correcciones
  • init --json now reports what it actually did, per step: tracker.installed, crawler.beacon, first-party.configured and env.written, each carrying the files it touched. Scripts no longer have to parse English sentences to find out whether a step ran.
  • framework.detected reports the real detection confidence. It previously always reported 1, even when the match was a weaker fallback.
  • A run that finds the tracker already installed now emits the same set of events as a fresh install, so a progress display cannot stall on a step that was simply skipped.
  • Pair it with --cookieless when the site runs in cookieless mode, so the tag is written correctly without looking the setting up.
v1.0.35

Scaffold a consent banner with zenovay consent init

Destacados
  • Session replay and heatmaps do not record until a visitor grants consent, on a site that has "require consent" switched on. Building that gate was left entirely to you. zenovay consent init writes a starting point into your project: it detects your framework and tells you why it picked it, then writes an unstyled component that inherits your own colours, so it never arrives as a light banner on a dark site.
Correcciones
  • It never edits your existing files. It prints the two wiring steps and leaves your layout to you. --dry-run shows exactly what it would write, and it asks before writing anything.
  • The generated component calls zenovay('consent', 'granted') and zenovay('consent', 'denied'), and honours Global Privacy Control.
  • It is a separate command on purpose, and never runs as part of zenovay init. A consent mechanism you did not ask for is worse than none.
v1.0.34

Crawler tracking now sees robots.txt, llms.txt and sitemaps

Destacados
  • The crawl beacon reports requests to /robots.txt, /llms.txt, /llms-full.txt and any sitemap*.xml. Previous versions matched them against a static-asset extension list and dropped them before the request was ever sent, so the files an AI crawler fetches specifically to decide how to treat your whole site were the ones that never appeared. "Who read my robots.txt, and did they then respect it" is now answerable.
Correcciones
  • Re-running zenovay init upgrades an installed beacon of any earlier version in place, in a single run. Ordinary assets that share those extensions, such as /manifest.json or /feed.xml, are still ignored, so the change adds the discovery files without adding noise.
  • Cloudflare Pages projects are detected by the presence of a functions/ directory containing a middleware or an exported onRequest handler, rather than by configuration alone.

An existing install keeps working untouched until you re-run init; nothing breaks in the meantime, the discovery files simply stay unreported. A beacon block you have edited by hand is never rewritten — the CLI prints the new block and leaves your file alone.

v1.0.33

AI crawler beacon installer

Destacados
  • zenovay init can install the AI crawler beacon, so requests from AI crawlers show up alongside your ordinary traffic.
v1.0.32

Zero-dependency package and hardened webhook tunnels

Destacados
  • The published package now declares zero runtime dependencies. All 16 runtime packages are bundled into dist/, so installing the CLI pulls nothing else from the registry and the install-time attack surface is gone. THIRD-PARTY-NOTICES.md ships in the tarball with the full 102-package license closure.
Correcciones
  • Webhook tunnels now verify where they are connecting before sending credentials. The tunnel address returned by the API is checked against the API host you have configured and must use wss://; a mismatched or unencrypted address is refused without handing over an access token.
  • zenovay webhooks forward --to example.com no longer assumes an unencrypted http:// connection for a remote address. Loopback targets are unchanged; anything else needs an explicit https:// URL, because inbound headers are replayed to the target verbatim.
  • The access token is read through the permission-checked token store on every invocation. A previous shortcut read auth.json directly and would load a world-readable token file instead of refusing it and tightening the permissions.
  • apiBase and cliBase now have to be https:// URLs, with http:// allowed only for localhost during development.
  • The self-update path validates the target version itself rather than relying on its callers, so a malformed version can never reach the Windows shell.
  • Dependency scanning covers the packages that are actually shipped. Because everything is bundled, the previous production-only filter matched an empty set and reported no findings; the audit and the automated dependency updates now cover the full bundled set.
v1.0.31

Reliable Windows recovery and future updates

Destacados
  • The Windows installer is now the verified recovery path from v1.0.27. Release automation places the exact public v1.0.27 binary at the normal install path, runs the signed installer over it, and requires the resulting v1.0.31 version and SHA-256 to match the candidate before any public channel can move.
Correcciones
  • Standalone Bun executables now resolve their own path from process.execPath. Earlier builds used process.argv[0], which Bun reports as the literal word bun; on Windows, v1.0.27 could therefore download and verify an update but write it to the working directory instead of replacing zenovay.exe.
  • The release gate also exercises the corrected updater from the exact v1.0.31 candidate by applying a force-downgrade to the immutable, signed v1.0.30 candidate and proving the same installed path, reported version, checksum, and temporary-file cleanup.
  • Astro installs no longer create an unused .env.local. The tracker code already carries the selected site ID, so the extra file only left otherwise-clean projects dirty after the CLI’s focused commit.
  • v1.0.30 failed closed at the Windows replacement proof and was never published to npm, GitHub Releases, or the live update manifest. Its immutable signed candidate remains available only as the downgrade fixture for this recovery test.
v1.0.30

Windows update proof on trusted HTTPS

Destacados
  • The Windows release gate now tests the shipped v1.0.27 executable against a version-bound candidate manifest served from Zenovay’s public-CA workers.dev origin. A failed candidate cannot advance any live release channel.
Correcciones
  • The v1.0.29 gate failed closed because its localhost test manifest was not selected; the old CLI remained on the live v1.0.27 channel and correctly made no change. The new gate first proves that v1.0.27 sees the exact candidate, then verifies the signed download, self-replacement, reported version, installed SHA-256, and cleanup of updater files.
  • Each immutable candidate is now fresh-installed at its exact version across the release matrix before the tested manifest is promoted byte-for-byte. npm and the GitHub release must already exist, release runs are globally serialized, and an older tag cannot move the live channel backwards.
  • Post-promotion checks retry Workers KV propagation and require both JSON and flat manifests to match the candidate, so an older healthy channel cannot produce a misleading green result.
  • The macOS, Linux, and Windows native installers now refuse to install when the exact versioned checksum is unavailable. An explicit ZENOVAY_ALLOW_UNVERIFIED=1 emergency override is still available, but a checksum mismatch can never be overridden.
v1.0.29

Windows update release gate unblocked

Destacados
  • This release carries the Windows updater, download-origin, stale-backup cleanup, and CLI website fixes prepared in v1.0.28. That tag failed closed before publication, so the live update manifest and npm package remained on v1.0.27.
Correcciones
  • The dedicated Windows update smoke now disables setup-node’s automatic package-manager cache. The job only needs Node for its local HTTPS manifest server; attempting to initialize a pnpm cache had stopped the runner before it could exercise the real v1.0.27 updater.
v1.0.28

Windows updates verified before release

Destacados
  • Native Windows updates now use the same signed payload in release automation and in the installed CLI, fixing the Signature verification failed. Update refused. error reported by v1.0.27 users.
  • Every release must now pass a real Windows 2022 update from the exact public v1.0.27 executable before the live version manifest can advance. The gate verifies the production public key, signature, checksum, download, self-replacement, reported version, and cleanup of temporary executables.
Correcciones
  • Signed native manifests now download immutable binaries from Zenovay’s workers.dev distribution origin, so Cloudflare Bot Fight Mode cannot challenge CLI, CI, or datacenter downloads after the version check succeeds.
  • Windows removes updater-owned .old-* executable backups on the next launch instead of leaving a roughly 123 MB stale binary behind. Near-match files and npm’s Node executable are never touched.
  • The CLI website keeps the current version badge visible throughout the changelog, marks the active page for assistive technology, handles the install command on narrow screens, and presents Open dashboard without the decorative arrow.
v1.0.27

Site-aware setup from every CLI entry point

Correcciones
  • After zenovay domains add, the suggested installer command now includes the new site's exact --site-id. This prevents a tracker already present in the project from silently selecting a different site.
  • Users without a site are now sent to the live /domains/add flow, and the Domains keybar action opens the current /domains page instead of obsolete /websites routes.
  • The --no-first-party help line no longer displays CAC's misleading (default: true) implementation detail. First-party installation remains enabled by default; the flag remains the explicit opt-out.
v1.0.26

Accurate first-party reinstall summary

Correcciones
  • When zenovay init upgrades or adds only the first-party proxy for an existing tracker, the completion screen now reports the real changed-file count and explains that the proxy was upgraded or added. It no longer shows Modified: 0 files or claims the installation was already unchanged after writing a proxy update.
v1.0.25

Safer first-party proxy isolation

Destacados
  • Cloudflare Pages proxies generated by zenovay init now forward only the headers analytics actually needs. Customer cookies, authorization tokens, Cloudflare Access credentials, private application headers, and spoofed Zenovay trust headers never leave the customer's origin.
Correcciones
  • Trusted visitor IP and location metadata is re-stamped from Cloudflare's runtime context, while request method, query, body, replay compression, privacy signals, and tracking-code headers are preserved. Upstream Set-Cookie headers are also removed before the response reaches the customer's origin.
  • Re-running the CLI safely upgrades a complete CLI-managed legacy proxy. Unrelated or lookalike function files are left untouched and no longer cause the site snippet to switch to a proxy that may not work.
v1.0.24

Compact download progress in every terminal

Destacados
  • The macOS and Linux installer now uses one compact Downloading… 10% (6.1/60.9 MiB) line instead of curl’s full-width hash bar. It matches the calm percentage-and-size presentation already used by the Windows installer.
Correcciones
  • Redirected and CI output is now line-oriented, with no carriage-return animation, hash wall, ANSI color, or blue transfer panel. Failed downloads close the active progress line before the installer tries its mirror or npm fallback.
  • After a verified onboarding install, a temporary destination lookup failure now falls back to the app’s site-aware resume route. The CLI still closes first, then opens the exact onboarding state automatically instead of leaving a new user at the post-install command menu.
v1.0.23

Smoother onboarding, safer installs, and reliable session recovery

Destacados
  • The macOS, Linux, and Windows installers now show clear percentage progress. After zenovay init verifies tracking, it opens the exact onboarding or domain-setup page that still needs attention; completed sites continue to their dashboard.
  • Site selection and Git-assisted installs are safer. The CLI never guesses when multiple sites could match, accepts an explicit --site-id, leaves Git staging and history untouched when work already exists, and stages only files written by Zenovay.
Correcciones
  • Expired access tokens now refresh consistently for ordinary requests and live event streams. Logout and revocation also invalidate the server-side device grant, so a retired token cannot silently remain active.
  • Running zenovay init again on an existing tracker now offers live verification and resumes the unfinished browser setup instead of stopping at an already-installed message.
v1.0.22

Polish pass — safer AI installer, clearer errors, and dozens of UX fixes

Destacados
  • A big reliability + polish pass across the whole CLI: dashboards no longer blank out on a single failed refresh, an expired session now tells you to run zenovay login instead of showing a dead retry, and every long-running view survives a network blip.
  • The AI install wizard is safer: its file writes are now confined to the specific framework layout/head files it needs — it can no longer touch your package.json, lockfiles, or unrelated source. And zenovay init --undo now reverts the last wizard run's changes.
Correcciones
  • Unknown sub-commands (e.g. a typo like zenovay domains bogus) now show the valid actions and exit with an error instead of silently doing nothing.
  • zenovay update works from CI and datacenter IPs (npm-registry / mirror fallback); --help now shows real examples for each command; time-range flags are unified under --range (old names still work).
  • Clearer errors everywhere: request timeouts, proxy hints, and unexpected server responses now show a friendly message instead of a raw stack or JSON blob. Ctrl+C reliably cancels, including during login.
  • zenovay tour greets logged-out users with a single "run zenovay login" instead of a wall of errors; zenovay globe no longer garbles in narrow terminals; zenovay health gained a first-party-tracking check.
  • Login is more robust against concurrent CLI sessions (no more surprise logouts when two instances refresh at once), and auth tokens are written atomically.
v1.0.21

CI installs for every major framework · first-party proxy fixes · rock-solid self-update

Destacados
  • zenovay init now installs the tracker headlessly (CI, scripts, --json) on 10 frameworks — Next.js App Router, Astro, Vite, Angular, Qwik, SolidStart, Gatsby, Nuxt, SvelteKit and plain HTML — using the same deterministic no-AI fast path the interactive wizard uses. Previously only plain HTML worked non-interactively.
  • First-party tracking fixes for two hosts: on Netlify the proxy rule is now inserted above a catch-all /* rewrite (it was unreachable on single-page-app sites), and on Next.js the rewrite is written into the default TypeScript next.config.ts shape that create-next-app generates.
Correcciones
  • Failed installs no longer leave anything behind — env vars are written only after the tracker actually lands, and every headless run ends with a machine-readable done event. --json output is real newline-delimited JSON now.
  • Self-update: the freshly-updated binary no longer runs your command twice; updates in cron/CI never swallow the command you invoked; updates work on Linux systems with a tmpfs /tmp (Fedora, Arch); and a pending update tells you once to run zenovay update instead of failing silently.
  • Network resilience: every API call has a 15-second timeout instead of hanging forever; an expired or revoked session refreshes properly on retry (or tells you to zenovay login); login survives a brief network blip instead of making you start over, and shows a "Waiting for approval…" indicator.
  • SvelteKit installs now add the tracker inside your existing <svelte:head> block — a second head block is a Svelte compile error. Astro's minimal starter installs instantly without the AI wizard.
  • zenovay health is fair to new users: not being logged in is a note, not a failure; the MCP row no longer shows a false red HTTP 401; and a new First-party tracking check tells you when Safari/Brave visitors aren't being counted and how to fix it.
  • Ctrl+C reliably cancels again (including during login). ZENOVAY_API_TOKEN and the new ZENOVAY_SITE environment variables work everywhere for scripting. zenovay logout tells you if the server-side session could not be revoked.
v1.0.20

Cleaner install snippet — localhost is a dashboard toggle, not a script attribute

Correcciones
  • The tracker snippet the CLI writes no longer includes data-allow-localhost="true". It never actually enabled localhost tracking on its own: your site's settings (fetched from the same server the events go to) override the attribute, and the server only accepts localhost events when the per-site Allow Localhost toggle is on. Localhost testing is now controlled solely by that dashboard toggle (domain settings → Advanced), so the installed snippet is cleaner and consistent with the dashboard and docs. Existing installs are still recognized.
v1.0.19

Self-update never crashes on a spawn error

Correcciones
  • Defense-in-depth on top of 1.0.18: if launching npm for a self-update ever fails outright (an edge-case Windows shell error), the CLI now prints a clear Update manually: npm i -g @zenovay/cli@latest hint instead of surfacing a raw spawn EINVAL stack trace.
v1.0.18

Windows self-update fixed · login required for data commands · cleaner --version · un-stuck dashboard

Destacados
  • zenovay update works on Windows again. On Node 18.20+/20.12+/21+ (and Node 24), spawning npm.cmd without a shell throws EINVAL (a Node security change) — the updater now runs npm through the shell on Windows. If you're stuck on an older version that still crashes, update once with npm i -g @zenovay/cli@latest (the broken updater can't fix itself).
Correcciones
  • zenovay --version now prints just the version — not the full help text after it.
  • Every data command checks you're logged in first and says run zenovay login, instead of opening a dashboard that silently fails with 401s. (login, init, help, version, update and other bootstrap commands are exempt.)
  • The dashboard's q always quits now — even while the site-picker is open (it used to get stuck). A failed site list shows an actionable error instead of an endless "Loading…", and an expired session shows a clear "run zenovay login" message.
v1.0.17

Install verification recognizes the first-party snippet

Correcciones
  • After a first-party install, zenovay init could wrongly report "tracker not yet on your live site" even though it was deployed and already recording hits. The live-site check only matched the third-party tag (data-id="ZV_…") and missed the first-party form (src="/api/_z/script.js?id=ZV_…", where the code rides in the query). It now recognizes both.
v1.0.16

First-party tracking works on Edge, Safari & Brave (every host)

Destacados
  • First-party tracking now actually works on privacy-strict browsers. The proxy + snippet are mounted at /api/_z/ across all hosts (Cloudflare Pages, Netlify, Vercel, Next.js) to match the path the tracker calls at runtime — previously the snippet loaded but every event POST hit a dead route, so Edge / Safari / Brave visitors weren't counted.
Correcciones
  • Re-running zenovay init on an existing install (legacy /_z/ or new /api/_z/) is correctly detected, so it never double-installs the tag.
v1.0.15

Visible AI-install progress · deterministic Astro install · no terminal flicker

Destacados
  • The AI installer now shows live progress — a spinner plus a "Working…" status — so it never looks frozen while the model is thinking between steps.
  • Astro projects whose <head> lives a few components deep now install deterministically (no AI round-trip): the installer follows imported components to find the real <head>.
Correcciones
  • No more brutal flicker on the framework-detection step in the VS Code integrated terminal.
  • Rate-limit messages now state the real reason — daily vs per-minute limit, how many you've used, and when it resets — instead of a generic "wait a moment".
v1.0.14

AI installer now handles non-standard layouts correctly

Destacados
  • The AI installer no longer reports a false "install failed" when it correctly adds the tracker to a non-standard spot — e.g. a site whose <head> lives in an imported component a couple of levels below the page layout. It now confirms success by checking the tracker is actually present in your source (the right test), instead of insisting it was written to one specific expected file (which defeated the whole point of the AI installer).
Correcciones
  • Frameworks and project structures the deterministic installers can't handle — where the AI agent traces your components to find the real <head> — now complete cleanly, including the automatic first-party proxy setup that runs right after.
  • The "not installed" error is now accurate: it only fires when no tracker tag with your site's code is actually present in your source (it still catches the case where the code was written into .env only, or the wrong file).
v1.0.13

Deep hardening pass — Windows fixes, no more hangs, clearer errors

Correcciones
  • Windows: zenovay now reads its config + auth from the correct location (%APPDATA%\zenovay) — a team override from teams switch and telemetry settings were being silently missed on Windows.
  • The AI install can no longer hang forever: the model stream now has an idle-timeout, so a stalled connection fails fast instead of freezing the wizard.
  • Git push failures now show the FULL error (e.g. authentication/permission), not a truncated first 80 characters.
  • Defense-in-depth: the tracking code is validated before it's ever written into your HTML/JSX/config on every install path (HTML, Vite, Astro, Remix, Solid, Next, Nuxt, SvelteKit, and the AI path).
  • The generated Cloudflare Pages first-party proxy now has a request timeout + safe redirect handling, so a slow upstream can never make your pages feel slow.
  • Clearer failures everywhere: session-expired (401) and rate-limit (429) during install now say what to do; a failed first-party setup is surfaced (not shown as success); MCP-client install failures are distinguished from "no client installed"; verify network errors include a hint; agent install failures explain the next step.
  • MCP client config files are written owner-only (0600).
v1.0.12

Hardening pass: verified install flow end-to-end + a batch of robustness fixes

Destacados
  • The whole zenovay init flow is now verified end-to-end by an automated terminal harness (it drives the real interactive wizard): framework detect → first-party host picker → success screen → the W/E shortcuts launching the live dashboard.
Correcciones
  • W/E on the success screen reliably launch the dashboard on every install type (npm global/local, npx, and dev runs) — the launcher now picks the right runtime instead of mis-detecting it.
  • --skip-verify truly skips verification (no more "press [s] to skip" prompt).
  • init no longer says "already installed" when only a stale config marker exists but no real tracker tag — so re-pointing to a different site works.
  • Safer file edits: the Vercel proxy writer won't clobber an unusual vercel.json; the tracking code is validated before it's written into HTML; first-party never swaps your tag to a same-origin path unless the proxy was actually wired.
  • Cleaner runs: old undo-history folders are pruned automatically, the AI installer stops re-trying a file it can't write, and it explains when a framework needs the (slower) AI path.
v1.0.11

W / E success-screen actions launch reliably (real fix)

Correcciones
  • The 1.0.10 fix for the W/E shortcuts was incomplete — they still dropped to the shell. Root cause: the wizard signalled "done" the instant you pressed a key, BEFORE its terminal teardown (exiting the alt-screen buffer + restoring the keyboard) had run, and the follow-up launch then blocked the event loop so that teardown never completed — the dashboard rendered into the about-to-be-discarded screen. It now waits for the wizard to fully tear down before launching, so W (watch) and E (events) reliably take over your terminal.
v1.0.10

The W / E shortcuts on the success screen now launch the dashboard

Correcciones
  • Pressing W (watch live) or E (stream events) on the install success screen dropped to the shell instead of launching, because it mounted a second dashboard inside the wizard's just-closed terminal. It now launches the dashboard as a fresh process, so it reliably takes over your terminal. If it still can't launch, it prints the exact command (zenovay overview --site-id …) instead of closing silently.
v1.0.9

zenovay update now works for global npm installs

Correcciones
  • zenovay update auto-updated via npm only when it could tell it was an npm install — but a global install (npm i -g) exposes zenovay as a symlink, and we were reading the unresolved symlink path, so it misread the install as a native binary and printed "No prebuilt binary for your platform". It now resolves the symlink first and updates via npm correctly. (Once on 1.0.9+, zenovay update and the automatic background update both work; to get TO 1.0.9 from an older version, run npm i -g @zenovay/cli@latest once.)
v1.0.8

First-party tracking sets itself up — no flag to remember

Destacados
  • When your deploy host can't be auto-detected (e.g. a static site deployed through a git integration, which leaves no config on disk), zenovay init now ASKS which host you use — Cloudflare Pages, Vercel, Netlify or Next.js — right in the wizard, and wires first-party tracking in that same run. No more re-running with --host.
Correcciones
  • Clearer messaging: the standard tracker is already live and working on its own (Chrome, Firefox and most browsers) with no further setup. First-party tracking is OPTIONAL — it adds Safari, Edge and Brave (which block third-party analytics) by serving Zenovay from your own domain, a step wired at your hosting provider.
v1.0.7

MCP for Claude Code, and first-party tracking that never breaks your tracker

Destacados
  • zenovay init now sets up the Zenovay MCP server in Claude Code too (it previously only configured Cursor / Claude Desktop / VS Code). Each editor gets its correct config shape, and a second run never adds a duplicate. This is what lets your own AI assistant read your analytics and wire up custom conversion events on demand.
Correcciones
  • First-party tracking no longer breaks a working install when your host can't be auto-detected (e.g. a static site deployed via a git integration). It now leaves the standard tracker in place — instead of silently pointing it at a proxy path that doesn't exist yet — and explains, in plain language, the optional one-command way to also cover Safari, Edge and Brave: zenovay init --host cloudflare-pages (or vercel / netlify / nextjs).
  • Replaced the cryptic "add a proxy from /_z/* to …/fp/*" note with a clear, benefit-first explanation everywhere it appears.
v1.0.6

Instant installs for component-based heads, and zenovay update on every platform

Destacados
  • The installer now handles projects whose <head> lives in an imported component (e.g. a shared SEO/BaseHead): it traces the import and inserts the tracker DETERMINISTICALLY and instantly, instead of handing off to the slower AI agent. Same speed as a standard layout.
Correcciones
  • zenovay update now works on every platform: it updates via npm when that is how you installed, instead of failing with "No release binary for platform …".
v1.0.5

Calmer install wizard + reliable AI install on non-standard layouts

Destacados
  • The wizard no longer flickers while the AI works: the model's streamed reasoning now updates the status line at a calm cadence (a few times a second) instead of on every token.
Correcciones
  • The AI install no longer gives up early on a project whose <head> lives in an imported component (e.g. a shared BaseHead): it follows the import to the right file and has the exploration headroom to do so.
v1.0.4

First-party tracking: install records events in every browser, automatically

Destacados
  • zenovay init now sets up FIRST-PARTY tracking automatically: it detects your host (Cloudflare Pages, Next.js, Vercel, Netlify), writes the proxy config, and serves the tracker same-origin via /_z/script.js. After your next deploy, events record in EVERY browser, including Edge, Safari and Brave (which block third-party trackers). Opt out with --no-first-party.
Correcciones
  • Re-running the installer is a safe no-op once first-party is set up (the detector recognizes the same-origin snippet, so it never double-injects the tracker).
v1.0.3

Hands-off AI install: auto-apply, self-update, faster and cheaper, smoother wizard

Destacados
  • The AI install now applies its file changes itself, with NO per-file [y/n] prompts. Pass --review if you want to approve each write.
  • zenovay now auto-updates to the latest version by default (opt out with ZENOVAY_NO_AUTO_UPDATE=1).
Correcciones
  • The install agent now writes the tracker snippet immediately instead of looping, so installs are much faster and use far fewer tokens (a stuck run previously read 30+ files across 40 rounds).
  • Smoother "Learn" cards in the wizard, and a single clear progress indicator (removed the confusing second counter at the bottom).
v1.0.2

Fix: unresponsive error screen + deprecated command in the next-steps screen

Destacados
  • A more responsive install wizard whose post-install screen points at the current commands.
Correcciones
  • The "Install failed" screen now responds to q / Esc right away. It previously ignored every key and only exited after a hidden 8-second timeout.
  • The post-install next-steps screen now shows and runs zenovay overview instead of the deprecated zenovay watch.
v1.0.1

Reliability: Windows installer + first-run config fixes

Destacados
  • A more robust install and first-run experience, especially on Windows.
Correcciones
  • The Windows installer (irm cli.zenovay.com/install.ps1 | iex) no longer closes your terminal window. It used to run exit inside your own shell session (for example on the "already installed" path); it now returns cleanly so the window stays open.
  • zenovay init no longer fails with "Unexpected end of JSON input" when the local config file is empty or was left half-written by an interrupted run. A corrupt config now resets to defaults instead of crashing every command.
v1.0.0

Zenovay CLI 1.0 — reliable installs for 11 frameworks, redesigned terminal UI, governed MCP

Destacados
  • Installs are now deterministic for 11 frameworks — plain HTML, Next.js (App Router), Nuxt, SvelteKit, Astro, Vite, Remix, SolidStart, Qwik, Angular and Gatsby: the tracker is placed in the right file fast, offline, idempotently, and verified afterwards. The AI agent is now a fallback only for genuinely unusual / custom project layouts.
  • New framework support: Nuxt, SvelteKit, Vite, Gatsby, Angular, SolidStart and Qwik.
  • zenovay init now verifies the tracker actually landed in your source and shows a clear confirmation — no more “done” without a write.
  • Redesigned terminal UI (“The Quiet Instrument”): every command opens full-screen, grids tile cleanly at any width with no garbled borders, and breakdowns expand so you can scroll the full list.
  • Time-window tabs now match the data actually fetched (no more picking “24h” and seeing 7-day numbers), and the home screen sums across all your sites with a real week-over-week change.
  • Discoverable [s] site switcher across data commands, clickable dashboard links, and [O] to open your dashboard from the success screen.
  • Connecting the Zenovay MCP server to Cursor, Claude or VS Code now uses secure OAuth sign-in instead of a static token, and honours the per-action permissions you set under Settings → Account → Agent.
  • The Claude/Cursor agent skills now teach the real Zenovay tracker and MCP tools, and can be dropped into your project.
Correcciones
  • zenovay webhooks forward now actually starts the tunnel (it was shadowed and never ran).
  • zenovay analytics <live|funnels|goals|insights> route to the right view instead of always showing the overview.
  • zenovay ai --json in a non-interactive shell now exits with a clear error instead of crashing while reporting success.
  • Live dashboards no longer freeze or overflow on small terminals; refresh is non-destructive and shows how recent the data is.
  • Hardened the install sandbox path checks and removed all known dependency advisories.
v0.1.68

Pantalla de instalación correcta mejorada + enlaces en los que se puede hacer clic

Destacados
  • Rediseñamos la pantalla “Ya está activo” — con una tarjeta de resumen clara, una confirmación de “primer evento recibido” y un diseño más sereno y acorde a la marca.
  • Las URL del panel y del sitio ahora son enlaces de terminal en los que se puede hacer clic y apuntan a la dirección legible /domains/{slug}, nunca a un ID sin procesar.
  • La nueva tecla [O] abre tu panel en el navegador directamente desde la pantalla de instalación correcta.
v0.1.67

Inicio de sesión e instalación más fluidos

Destacados
  • La solicitud de autocompletado del shell ya no interrumpe el inicio de sesión en el navegador durante zenovay init: se ofrece una sola vez al final, una vez completada la configuración.
  • La instalación con curl | sh ahora también añade zenovay a tu PATH automáticamente y muestra una línea que puedes ejecutar en la misma terminal.
Correcciones
  • Corrige el desconcertante "command not found: zenovay" justo después de la instalación al añadir el directorio de instalación a tu perfil del shell.
v0.1.66

Instalación y actualización automática resilientes, marca renovada

Destacados
  • La instalación y la actualización automática ahora recurren a una alternativa cuando el host de descarga principal no está disponible, de modo que curl | sh, npm y la autoactualización siguen funcionando desde servidores y CI.
  • Renovamos la interfaz de la terminal con el azul de la marca Zenovay para un aspecto más sobrio y coherente.
Correcciones
  • El instalador ya no se interrumpe antes de poder ejecutar su alternativa con npm cuando todavía no hay un binario precompilado disponible.
v0.1.65

Coincidencia bidireccional de sitios y detección de instalación previa

Destacados
  • Coincidencia de sitios más inteligente durante la instalación — el asistente busca coincidencias en ambas direcciones, así que una pista de proyecto más larga (como el nombre completo de un repo) sigue resolviéndose al sitio correcto.
  • Cuando tu proyecto ya tiene el código de seguimiento correcto, el asistente da un atajo a un panel verde de «ya instalado» en lugar de volver a ejecutar la configuración.
  • El panel de «ya instalado» muestra tu sitio, dominio y código de seguimiento, con teclas rápidas para salir o volver a ejecutar el asistente de todos modos.
  • El modo headless de zenovay init detecta el código instalado e informa «ya instalado» en lugar de rehacer el trabajo.
v0.1.64

Corrección de fallo de arranque en binarios independientes

Destacados
  • Corrige el fallo de arranque de los binarios independientes.
v0.1.63

Descarga de npm más ligera

Destacados
  • El paquete de npm ya no incluye los binarios independientes, lo que hace npm install más pequeño y rápido.
v0.1.62

Corrección de la detección de actualizaciones automáticas

Destacados
  • Restaura la detección automática de actualizaciones que se rompió en la compilación de binarios independientes.
v0.1.61

Comprobaciones de ruta de instalación, agente de estado persistente y alertas instantáneas

Destacados
  • zenovay health y zenovay doctor ahora detectan cuándo hay dos binarios de zenovay en tu PATH (el caso habitual de npm global + Homebrew) y dan instrucciones concretas para desinstalar.
  • El agente de estado en segundo plano gana persistencia y alertas instantáneas.
v0.1.60

Soporte de binarios independientes y ejecutor de autodiagnóstico

Destacados
  • Rediseña el punto de entrada para que el CLI funcione correctamente como binario compilado independiente, con la versión incrustada en tiempo de compilación.
  • El ejecutor de zenovay self-test detecta correctamente si se está ejecutando como script o como binario compilado.
v0.1.59

Detención instantánea del agente de estado

Destacados
  • zenovay status-agent --stop ahora detiene el agente en segundo plano de inmediato en lugar de esperar a su siguiente ciclo.
v0.1.58

Corrección de supervivencia del daemon del agente de estado

Destacados
  • El agente de estado en segundo plano ahora sigue ejecutándose después de su primer ciclo en lugar de salir antes de tiempo.
v0.1.57

Conexión del comando status-agent

Destacados
  • Registra el comando zenovay status-agent para que se despache correctamente.
v0.1.56

Agente de estado en segundo plano

Destacados
  • Añade el agente de estado en segundo plano — un daemon ligero que vigila tus visitantes en vivo, errores e ingresos, y envía notificaciones de escritorio (compatible con macOS, Linux y Windows Terminal).
  • El instalador marca el binario como de confianza en macOS para que se ejecute sin un aviso de Gatekeeper.
v0.1.55

Enlaces directos por sitio para abrir en el navegador

Destacados
  • La tecla [o] de abrir en el navegador por sitio ahora salta directamente a la pestaña correcta del panel del dominio.
v0.1.54

La tecla del globo abre el panel web

Destacados
  • Elimina los paneles del globo dentro de la terminal y reasigna la tecla [o] del globo para abrir en su lugar el globo interactivo completo en tu navegador.
v0.1.53

Panel del globo en live y overview

Destacados
  • Añade un panel del globo con datos a los paneles de zenovay live y zenovay overview que muestra dónde están tus visitantes en este momento.
v0.1.52

Corrección de la configuración de telemetría

Destacados
  • Corrige la telemetría de uso anónima para que detecte correctamente tu token y la base de la API.
v0.1.51

Llamadas a herramientas en el chat y telemetría anónima

Destacados
  • El chat de IA en la terminal ahora puede llamar a herramientas para obtener tu analítica real mientras responde.
  • Añade telemetría de uso anónima opcional para ayudar a mejorar el CLI.
Correcciones
  • Corrige el cierre automático inesperado del panel de chat.
v0.1.50

Corrección del renderizado del globo

Destacados
  • Revierte un cambio del panel de chat de la 0.1.49 que rompió el renderizado del globo.
v0.1.49

Gestión de entrada del panel de chat

Destacados
  • El panel de chat de IA ahora captura la entrada del teclado de forma limpia y limpia la pantalla cuando se abre.
v0.1.48

Panel de chat de IA en los paneles

Destacados
  • Añade un panel de chat de IA integrado dentro de los paneles del TUI, para que puedas hacer preguntas sobre tu analítica sin salir de la terminal.
v0.1.47

Correcciones de autocompletado y watch

Destacados
  • Corrige el autocompletado del shell para valores escritos y añade un alias --csv a zenovay watch.
v0.1.46

Tecla de abrir en el navegador y pulido

Destacados
  • Añade una tecla [o] de abrir en el navegador en los comandos del TUI para saltar de la terminal a la vista correspondiente del panel web.
v0.1.45

Anotaciones en los gráficos

Destacados
  • zenovay annotation create añade anotaciones a tus gráficos directamente desde la terminal.
Correcciones
  • Corrige el enrutamiento del comando de anotaciones para que se despache correctamente.
v0.1.43

Versión de mantenimiento

Destacados
  • Subida de versión y mantenimiento rutinarios. Esta entrada también cubre la subida trivial de solo compilación 0.1.44.
v0.1.42

Correcciones de mensajes de error y alertas

Destacados
  • Los errores de la API ahora muestran un mensaje claro y legible en lugar de «[object Object]».
  • Corrige la validación de crear/actualizar alertas y unos flags rotos en el tour guiado.
v0.1.41

Valores por defecto más seguros en el autodiagnóstico

Destacados
  • zenovay self-test ya no ejecuta sondas de seguridad activas por defecto.
v0.1.40

Mostrar los errores reales en overview

Destacados
  • zenovay overview ya no oculta los errores de permisos — un --site-id incorrecto ahora informa del error real.
v0.1.39

Renderizado de la salida del autodiagnóstico

Destacados
  • El resumen de zenovay self-test ahora se imprime como stdout plano y limpio.
v0.1.38

Corrección del orden del autodiagnóstico

Destacados
  • Los resultados de zenovay self-test ahora se imprimen en el orden del catálogo.
v0.1.37

Diseño de los fallos del autodiagnóstico

Destacados
  • Los detalles de los fallos en zenovay self-test ahora se renderizan en su propia línea con sangría para mayor legibilidad.
v0.1.36

Filas del autodiagnóstico y ayuda más ligera

Destacados
  • Mejora el renderizado de las filas de zenovay self-test y la lógica de restricción por plan, y reduce --help.
v0.1.35

Autodiagnóstico, tour guiado, alertas y exportación

Destacados
  • El nuevo zenovay self-test ejecuta en paralelo todos los endpoints de lectura contra tu cuenta e imprime un resumen coloreado de aprobado/fallido — una forma de comprobar con un solo comando que todo funciona.
  • Nuevo zenovay tour — un recorrido interactivo de 8 pasos, con un modo de documento plano para uso no interactivo.
  • Añade gestión de alertas y exportación de datos, además de mensajes de error coherentes con códigos semánticos claros en todos los comandos.
v0.1.34

Correcciones de la ayuda y de la vista de analítica

Destacados
  • Corrige un error falso mostrado en --help y una colisión de iconos en la vista de analítica.
v0.1.33

Bordes del globo y URL del panel

Destacados
  • Añade bordes de países al globo de la terminal y corrige la URL del panel a la que enlaza.
v0.1.32

Abre el globo real en tu navegador

Destacados
  • Añade un flag --browser y una tecla [w] para abrir el globo interactivo completo en tu navegador.
v0.1.31

Continentes rellenos en el globo

Destacados
  • El globo de la terminal ahora renderiza continentes rellenos a partir de un mapa de bits del mundo para un mapa más claro.
v0.1.30

Correcciones de ancho y visuales del globo

Destacados
  • Corrige un error de distorsión de ancho en el globo de la terminal.
v0.1.29

Correcciones del contorno y el diseño del globo

Destacados
  • Añade un contorno de esfera visible al globo y corrige los porcentajes de las barras y el ancho de la barra lateral.
v0.1.28

Globo ortográfico 3D

Destacados
  • Redibuja el globo de la terminal como una Tierra ortográfica 3D real con nubes de puntos de visitantes y navegación con desplazamiento mediante j/k.
v0.1.27

Soporte multiequipo y globo Braille

Destacados
  • Añade soporte multiequipo para que puedas cambiar entre los equipos a los que perteneces.
  • Introduce un globo real renderizado en Braille en la terminal.
v0.1.26

Webhooks, registro de auditoría, compartición y modo silencioso

Destacados
  • Añade reenvío de webhooks, acceso al registro de auditoría y comandos de enlaces para compartir.
  • Nuevo modo silencioso -q y códigos de error coherentes en todos los comandos.
v0.1.25

Comando de uso y pulido

Destacados
  • El nuevo zenovay usage muestra los eventos usados frente a tus límites mensuales y diarios, además del recuento de sitios web, equipos y claves de API frente a los límites de tu plan.
Correcciones
  • Los comandos desconocidos ahora informan «Unknown command» y salen con un error en lugar de tener éxito en silencio; zenovay a secas imprime la ayuda.
  • zenovay domains list ahora imprime una tabla compacta en lugar de tomar prestada la vista de proyectos.
v0.1.24

Desbloqueo de mutaciones y analítica con paridad del panel

Destacados
  • Desbloquea los comandos de mutación y lleva los comandos de analítica a la paridad total con el panel.
v0.1.23

Paridad total con el panel y comandos de mutación

Destacados
  • Añade 13 comandos nuevos que reflejan el panel web, incluyendo claves de API, dominios, gestión de equipos, perfil, planes, ajustes, integraciones, objetivos y notas.
  • Gestión de clientes de agencia (zenovay agency) para los planes Scale.
  • Los comandos destructivos ahora piden confirmación antes de actuar y se niegan a ejecutarse de forma desatendida sin --yes.
v0.1.22

Corrección de errores y pulido

Destacados
  • Una ronda de corrección de errores y un pulido de la interfaz comedido.
v0.1.21

Cambio de sitio y de rango sin salir

Destacados
  • zenovay overview gana un selector de sitio sin salir ([s]) y un selector de rango de fechas ([1-4]).
v0.1.20

Interfaz más limpia y dominio del sitio en el encabezado

Destacados
  • Renueva la paleta de la interfaz y muestra el dominio del sitio activo en el subtítulo del encabezado.
v0.1.19

Comprobación de actualizaciones silenciosa y correcciones de inicio de sesión

Destacados
  • La comprobación de actualizaciones ahora es silenciosa, y se corrigen el éxito del inicio de sesión y la consulta al registro de npm.
v0.1.18

Comandos espejo del panel

Destacados
  • La superficie de comandos ahora refleja el panel web 1:1, añadiendo 11 comandos en analítica (overview, live, pages, devices, geo) y comportamiento (retention, uptime, sessions, heatmaps, journeys), con restricción por plan para las funciones de Pro+.
v0.1.17

Primitivas del panel y actualización automática bloqueante

Destacados
  • Nuevos componentes básicos del panel — tarjetas de métricas, estados vacíos y tablas de datos — usados en todos los comandos.
  • Cada comando ahora comprueba y aplica las actualizaciones automáticamente antes de ejecutarse.
v0.1.16

Resolución automática del sitio

Destacados
  • El CLI ahora resuelve tu sitio automáticamente — --site-id ya no es obligatorio.
v0.1.15

Correcciones del asistente de instalación

Destacados
  • Corrige un error de pantalla en negro y de bucle de verificación en zenovay init y añade instrucciones de PATH más claras.
v0.1.14

Menú interactivo tras la instalación

Destacados
  • Después de instalar, zenovay init ofrece un menú interactivo para encadenar directamente con zenovay watch o el seguimiento de eventos en vivo.
v0.1.13

Instalación más rápida en HTML plano

Destacados
  • Añade una vía rápida para instalar el tracker en sitios de HTML plano.
v0.1.12

Fiabilidad de la instalación

Destacados
  • Una herramienta que falle durante la instalación ya no detiene el agente de instalación — se recupera y continúa.
v0.1.11

Garantías de escritura en la instalación

Destacados
  • El instalador ahora requiere que una escritura real de un archivo del framework tenga éxito antes de informar de un resultado correcto.
v0.1.10

Comprobación previa de verify

Destacados
  • zenovay verify ahora hace una comprobación previa de tu URL en vivo y limpia la pantalla entre fases.
v0.1.9

Diagnóstico de instalación enriquecido y protección de escritura

Destacados
  • El flujo de instalación gana un diagnóstico más rico de tu proyecto y una protección contra escrituras destructivas de archivos.
v0.1.3

Mejoras del asistente de instalación con IA

Destacados
  • El agente de instalación con IA ahora requiere que los archivos del tracker se escriban realmente antes de informar de un resultado correcto.
  • Añade una verificación de idempotencia para que volver a ejecutar zenovay init omita el agente cuando el tracker ya está instalado.
  • El nuevo flujo posterior a la instalación te guía por commit/push, deploy, visita y verificación.
v0.1.2

Mantenimiento y correcciones de instalación

Destacados
  • Versión de mantenimiento que cubre las primeras correcciones del asistente de instalación y del seguimiento de eventos (también incluye las subidas triviales de la 0.1.4 a la 0.1.8).
  • Los usuarios headless y de CI obtienen formato de salida universal — JSON, CSV, TSV y NDJSON.
  • zenovay events tail gana filtrado y reenvío en vivo.
v0.1.0

Versión inicial

Destacados
  • Primera versión pública del Zenovay CLI — un asistente de instalación con IA que añade el tracker a tu sitio, además de paneles de analítica en la terminal.
  • Inicia sesión con autenticación segura de flujo de dispositivo (zenovay login).
  • zenovay init te guía por la detección de tu framework y la instalación del tracker.
  • Paneles en vivo en la terminal con zenovay watch y seguimiento de eventos.
  • Salud y diagnósticos con zenovay health y zenovay doctor, además de autoactualizaciones automáticas.
  • Publicado en npm como @zenovay/cli (esta entrada cubre tanto la 0.1.0 como la 0.1.1).

Requiere una cuenta gratuita de Zenovay en app.zenovay.com.