Command

nylas audit logs summary

View summary statistics of audit log entries including command counts, error rates, and top invokers.

Written by Qasim Muhammad Staff SRE

What does nylas audit logs summary do?

The nylas audit logs summary command aggregates CLI usage over a configurable time window — total commands run, error rates, most-used commands, top invokers (AI agents vs humans), and busiest hours. Use --days to set the window and --json for dashboard-ready output.

Usage

nylas audit logs summary [--days N]

Flags

FlagDescription
--jsonOutput as JSON
--no-colorDisable color output
--verbose(-v)Enable verbose output
--configCustom config file path
--help(-h)Show help for the command
--limitLimit results (most list commands)
--yes(-y)Skip confirmations
--daysNumber of days to summarize (default: 7)

Examples

The nylas audit logs summary command aggregates CLI usage over a configurable time window — total commands run, error rates, most-used commands, top invokers (AI agents vs humans), and busiest hours.

7-day summary (default)

nylas audit logs summary

30-day summary

nylas audit logs summary --days 30

JSON output for dashboards

nylas audit logs summary --days 7 --json

Example output

Audit Summary (last 7 days)

  Total commands:   142
  Succeeded:        137
  Errors:           5
  Top command:      email list (48)
  Active invokers:  3

Troubleshooting

Summary shows zero entries

Verify logging is enabled with `nylas audit logs status` and that the time range contains logged commands.

Recommended guides

Thunderbird vs Nylas: GUI vs CLI email

Thunderbird is a desktop GUI email client with OAuth and calendar built in. Compare it to a scriptable, headless CLI for servers, cron jobs, and AI agents.

Pipedream vs Nylas for Email Automation

Pipedream wires 3,000+ apps with event workflows and code steps. Nylas is a native email API with a CLI for agents and cron. Compare as a Pipedream alternative.

Detect Calendar Conflicts from the CLI

Spot double-booked meetings and overlapping events from the terminal. AI conflict detection and jq scripts catch calendar conflicts before they derail your day.

Block Focus Time on Your Calendar (CLI)

Context-switching costs 23 minutes of focus per interruption. Block focus time on Google Calendar from your terminal so meetings can't eat your deep-work slots.

Build a Strands Email Agent

Give a Strands Agents SDK agent email access using the Nylas CLI as a @tool. One function reaches Gmail, Outlook, and 4 more providers — no OAuth code needed.

Cloudflare Agents Email Tools

Use the Cloudflare Agents SDK to build a stateful email agent on Workers — connect to the Nylas MCP server over HTTP and call email tools in TypeScript.

Run nylas audit logs summary --help for full help output.