Command Reference
Every Luciq CLI data command with its options, filters, and examples, covering crashes, bugs, APM, reviews, surveys, alerts, and incidents.
This page covers the CLI's data commands: querying and managing your Luciq apps from the terminal. For symbol uploads, see Uploading Symbol Files.
All data commands require authentication with your CLI token (see Getting Started). Under the hood, each command runs the same tool that powers the Luciq MCP Server, so results, permissions, and behavior match what your AI assistant sees through MCP.
Commands at a Glance
luciq apps
list
Applications you can access
luciq crashes
list, show, patterns, diagnostics, hangs, occurrence-tokens, occurrence
Crashes, ANRs, OOMs, non-fatals, and app hangs
luciq bugs
list, show, update
User-reported bugs and triage
luciq apm
groups, group, occurrence, funnel-events, funnel-create, funnel-update, funnel-delete
Performance metrics and funnels
luciq reviews
list
App store reviews and ratings
luciq surveys
list, show
Surveys and their responses
luciq insights
—
Aggregated app-health snapshot
luciq issues
list
Unified issues ranked by impact
luciq opportunities
list, show
Prioritized product opportunities
luciq alerts
list, show, init, create, update, delete
Alert rules
luciq incidents
list, show, resolve, reopen
Triggered alerts
Shared options
Most data commands target one application in one environment and share these options:
--slug
Application slug (required)
--mode
Environment: production, beta, staging, alpha, qa, or development (required)
--offset, --limit
Pagination
--sort-by, --direction
Sort field and direction (asc/desc). Some commands use --sort-direction instead — check help
--filters
Raw filter JSON object, merged with the typed filter flags
Common filters have dedicated typed flags (--status, --platform, --app-version, …). Anything a command supports that has no dedicated flag can be passed through --filters:
When a typed flag and a --filters key overlap, the typed flag wins. Run luciq <group> help <subcommand> for the full option list and the filter keys each command accepts.
Output
Responses print as pretty-printed JSON, so they pipe cleanly into jq and scripts. Commands exit with a non-zero status on any error.
Permissions and rate limits
The CLI token represents your dashboard account: each command is authorized against your role's permissions and your plan's entitlements, exactly like the corresponding MCP tool. Requests are rate-limited to 100 requests per 60 seconds; exceeding the limit returns an HTTP 429 error with a Rate limit exceeded message — back off and retry.
Crashes
luciq crashes SUBCOMMAND
list
List crashes. Flags: --status (open/closed/in_progress), --platform (IOS/ANDROID/DART/JAVASCRIPT), --type (CRASH/ANR/OOM/NON_FATAL), --app-version
show --number N
Details for one crash
patterns --number N
Grouped patterns. Flags: --pattern-key (app_versions/devices/oses/current_views/app_status/experiments), --sort-by, --direction
diagnostics --number N
Full debugging payload for one crash
hangs
List app hangs. Flags: --status, --platform, --app-version
occurrence-tokens --number N
Occurrence cursor tokens. Flags: --current-token, --direction (first/last)
occurrence --number N --ulid U
Details for a single occurrence
Sortable fields for list and hangs: last_occurred_at, first_occurred_at, occurrences_counter, affected_users_counter, max_app_version, min_app_version, severity.
Bugs
luciq bugs SUBCOMMAND
list
List bugs. Flags: --status (new/closed/in_progress), --priority (na/trivial/minor/major/blocker), --app-version
show --number N
Details for one bug
update --number N
Update a bug. Flags: --status, --priority, --tags, --tag-action, --clear-tags, --duplicate-of, --action
update requires at least one change. Duplicate marking (--duplicate-of or --action mark_as_duplicate/unmark_as_duplicate) can't be combined with --status/--priority.
--tags appends to the bug's existing tags by default. Use --tag-action to change that: append (default) keeps existing tags, replace sets --tags as the full list (removing others), remove deletes the listed tags and keeps the rest. --clear-tags removes all tags and can't be combined with --tag-action.
APM
luciq apm SUBCOMMAND
groups --metric M
Rank groups worst-first. --metric: network, launch, flows, screen_loading, frame_drop, funnels. --sort is a JSON object {"by":…,"direction":…}
group --metric M
Panels for one group; identify it with --group-uuid or --group-url. --views is a JSON array (default ["summary"]); --method applies to network
occurrence --metric M --selector S
Inspect occurrences (--selector: worst/by_token/list). Flags: --token, --current-token, --direction (first/last), --limit
funnel-events
List events pickable for funnels. Flags: --event-type (network/screen_loading), --q, --limit
funnel-create --name N --events JSON
Create a funnel from 2–20 steps
funnel-update --ulid U
Update a funnel (--name, --events)
funnel-delete --ulid U
Delete a funnel
Reviews
luciq reviews list — Flags: --rating (1–5), --country, --os (ios/android), --sort-by date, --sort-direction.
Surveys
luciq surveys SUBCOMMAND
list
List surveys. Flags: --type (0=custom, 1=NPS, 2=app store), --status (0=draft, 1=published, 2=paused)
show --id N
A survey's questions and response statistics. --page paginates responses
Apps
luciq apps list — List the applications you can access. This is the one data command with no --slug/--mode. Optional --platform (ios/android/react_native/flutter).
Insights
luciq insights --slug my-app --mode production — Aggregated app-health insights for one app. Narrow with --filters (date_ms, app_version).
Issues
luciq issues list — Unified issues across crashes, APM, AI-detected issues, and bugs, ranked by Apdex impact. Flags: --limit, --sort-by (apdex_impact/occurrences_counter), --sort-direction, --top-issues (curated shortlist), --pagination (per-source cursor tokens JSON).
Opportunities
luciq opportunities SUBCOMMAND
list
List opportunities. Flags: --status (open/in_progress/closed/dismissed), --priority (1–4/unset), --team-id
show --id N
Details for one opportunity
Alerts
luciq alerts SUBCOMMAND — Manage alert rules.
list
List rules. Flags: --sort-by (latest_creation_date/last_edit_date/highest_triggered_count), --sort-direction
show --ulid U
Show one rule
init
Show the building blocks (types, triggers, conditions, actions) for creating a rule
create --payload JSON
Create a rule
update --ulid U --payload JSON
Update a rule
delete --ulid U
Delete a rule
Run luciq alerts init first to discover the valid rule building blocks, then pass the rule body as --payload:
Incidents
luciq incidents SUBCOMMAND — Manage triggered alerts.
list
List incidents. Flags: --sort-by (first_triggered/last_triggered/count), --sort-direction, --status (open/manual_resolve/automatic_resolve), --type
show --ulid U
Show one incident
resolve --ulid U
Resolve an incident
reopen --ulid U
Reopen an incident
Last updated