Source: https://cli.nylas.com/docs/commands/audit-logs-summary

# nylas audit logs summary

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

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## 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

```bash
nylas audit logs summary [--days N]
```

## Flags

| Flag | Description |
| --- | --- |
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --limit | Limit results (most list commands) |
| --yes(-y) | Skip confirmations |
| --days | Number 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)

```bash
nylas audit logs summary
```

### 30-day summary

```bash
nylas audit logs summary --days 30
```

### JSON output for dashboards

```bash
nylas audit logs summary --days 7 --json
```

## Example output

```text
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.

## Related commands

[nylas audit config setSet an audit configuration value. Valid keys: retention_days, max_size_mb, rotate_daily, compress_old, log_request_id, log_api_details.](https://cli.nylas.com/docs/commands/audit-config-set)

[nylas audit config showShow the current audit configuration, including log path, retention, rotation, and compression settings.](https://cli.nylas.com/docs/commands/audit-config-show)

[nylas audit exportExport audit logs to JSON or CSV for compliance, analysis, or backup.](https://cli.nylas.com/docs/commands/audit-export)

[nylas audit initInitialize audit logging for the Nylas CLI. Creates the log directory, default configuration, and optionally enables logging immediately.](https://cli.nylas.com/docs/commands/audit-init)

[nylas audit logs clearClear all audit log entries. This is a destructive action — consider exporting logs first with `nylas audit export`.](https://cli.nylas.com/docs/commands/audit-logs-clear)

[nylas audit logs disableDisable audit logging. Stops recording CLI activity to the audit log file.](https://cli.nylas.com/docs/commands/audit-logs-disable)

## Recommended guides

[ai-catalog.json: Agent Discovery for Your SitePublish ai-catalog.json at /.well-known so AI agents can discover your MCP servers, APIs, and knowledge files. The draft Google-backed spec, schema, and a live example.](https://cli.nylas.com/guides/ai-catalog-json-agent-discovery)

[Thunderbird vs Nylas: GUI vs CLI emailThunderbird 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.](https://cli.nylas.com/guides/nylas-vs-thunderbird)

[Pipedream vs Nylas for Email AutomationPipedream 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.](https://cli.nylas.com/guides/pipedream-vs-nylas)

[Detect Calendar Conflicts from the CLISpot double-booked meetings and overlapping events from the terminal. AI conflict detection and jq scripts catch calendar conflicts before they derail your day.](https://cli.nylas.com/guides/detect-calendar-conflicts-cli)

[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.](https://cli.nylas.com/guides/block-focus-time-cli)

[Build a Strands Email AgentGive 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.](https://cli.nylas.com/guides/strands-email-agent)

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