Commands overview
Every command supports --help for full options:
loguro <command> --help
Setup & diagnostics
| Command | Description |
|---|
loguro init | Interactive setup wizard (auth → project → key → link → first-log examples) |
loguro doctor | Health check: auth, backend, env, configured apps, all linked dirs, version |
Querying logs
| Command | Description |
|---|
loguro logs | Query logs with filters |
loguro tail | Follow new logs (poll) |
loguro count | Count logs (total or filtered) |
loguro get | Fetch a single log by ID with full context |
loguro distinct | List unique values for a field |
loguro timeline | Logs around a specific log ID |
loguro trace | All logs sharing a trace ID, in chronological order |
loguro slow | Slow requests above duration threshold |
loguro sample | Random sample of logs |
loguro group | Group logs by field |
loguro replay | Replay a window of logs as if streaming live, at adjustable speed |
loguro investigate | AI investigation of a log (uses your plan AI quota) |
Visualizations
| Command | Description |
|---|
loguro top | Top N values for a field with horizontal bars (level, message, context.X) |
loguro chart | Volume over time as compact sparkline or chunky bars (--bars) |
loguro analytics | Aggregated dashboard: levels, daily timeline, top errors, endpoints |
loguro health | Project health badge: error rate now vs previous, optional 24h trend |
loguro diff | Compare log patterns between two windows (new / spiked / dropped) |
Local config
| Command | Description |
|---|
loguro config | Manage app configurations (slug aliases) |
loguro link | Link current dir to a slug or app |
loguro unlink | Remove .loguro link |
Auth
| Command | Description |
|---|
loguro login | Save a PAT |
loguro logout | Remove the saved PAT |
loguro whoami | Show current user / token info |
Account & projects
| Command | Description |
|---|
loguro projects | List / create / rename / delete projects |
loguro keys | Manage project ingestion keys (used by your SDK) |
loguro tokens | Manage CLI tokens (PATs) |
loguro usage | Current month usage + plan caps |
loguro billing | Subscription, current plan, available plans |
Alerts & notifications
| Command | Description |
|---|
loguro channels | Manage notification channels (webhook \| discord \| slack \| telegram) |
loguro alerts | Manage project alerts |
loguro integrations | Connect issue trackers (jira / linear / github) and message integrations (slack / discord / telegram) |
Workflow helpers
| Command | Description |
|---|
loguro pin | Pin recurring logs to track (marker auto-shown on lists) |
loguro share | Create / list / revoke public markdown shares of logs (single or multi-log) |
Interactive mode
loguro logs --interactive # or -i
Opens a TUI navigator over your logs with keyboard navigation, fuzzy search, multi-select, AI investigation, alert creation, sharing, and pinning — all wired to the same backend endpoints as the standalone commands.
| Key | Action |
|---|
↑↓ / jk | Navigate |
enter | Inspect a log |
esc | Back |
/ | Live fuzzy search (prefix = for exact substring) |
space | Multi-select rows |
s | Share selected as one markdown page |
p | Bulk pin |
c | Copy all IDs |
r | Refresh |
? | Keybindings overlay |
q | Quit |
In log detail:
| Key | Action |
|---|
e | AI explain (light) |
i | AI investigate (deep, code-aware) |
a | Create alert from this log (runs full alert wizard, returns) |
p | Pin / unpin toggle (shows encounter count for recurring logs) |
t | Show all logs sharing the same trace ID |
s | Create public share (URL auto-copied) |
c | Copy log ID |
o | Open in web console |
j | Toggle JSON-colored context |
Pipe-friendly: without -i everything stays plain text streamable.