Every command acts as the account it signed in with, on any site that account can open. Add --help to a command
to see all of its options. The options of the reading commands come from the server, so they always match it.
The site to ask about. Without it, the CLI uses $SNOWANALYTICS_SITE, then this project's site from snowanalytics use, then your only site if you have one.
--period <period>
today, yesterday, 7d, 30d (the default), 90d, 180d, 365d, month, lastmonth, ytd, all, or a range like 2026-10-01..2026-10-31 in the site's time zone.
--json
Print JSON. It is the default whenever the output goes to a program, a pipe or a file rather than a terminal.
--server <url>
Another MCP server, for a staging copy. Also $SNOWANALYTICS_MCP_URL.
--read-only
Refuse every change for this one command, whatever the sign-in allows.
In a terminal, answers print as aligned fields and tables that fit its width. Columns that don't fit are named
under the table; --json has every field.
Every site you can open, by workspace, with your role, whether tracking is live and who is on it now.
snowanalytics overview
Headline numbers against the period before, the daily trend, and the top sources, pages, countries and devices.
snowanalytics query <dimension>
One dimension ranked: referrers, channels, campaigns, pages, entryPages, exitPages, countries, cities, browsers, operatingSystems, devices or actions.
snowanalytics explain
What drove a rise or drop. --metric visitors or revenue, --compare-to another period.
snowanalytics errors [issue]
Error issues ranked by impact. With an issue ID: its stack with the code around the failing line, breadcrumbs, a typical visit, linked feedback and a fix brief.
snowanalytics feedback [note]
Notes visitors sent. With a note's ID: the whole note. Its screenshots are saved as files and their paths printed.
snowanalytics sessions [session]
Recordings. With a session's ID: the visit as a timeline; --at-seconds centres it on a moment.
snowanalytics status
Whether the site's tracking is waiting, detected or live, and which features report. --wait checks every 5 seconds until the first visit counts, for up to --timeout minutes (10 by default).
Marks issues fixed. --release names the release with the fix, or --deployed-at says when it went live (now or an ISO time). --link and --note go into the issue's history.
snowanalytics actions [words]
Searches the dashboard's other actions, such as goals, funnels, alert rules, tags and settings, and shows the arguments each takes.
snowanalytics run <action> [json]
Runs one of them. Give the arguments as one JSON object, as flags, or both.
snowanalytics actions chart notesnowanalytics run notes.create --date 2026-11-14 --body "Shipped the new checkout"
Changes need Make changes for you on the sign-in or key. Some things stay in the dashboard whoever asks:
What stays in the dashboard.