Command
nylas audit init
Initialize audit logging for the Nylas CLI. Creates the log directory, default configuration, and optionally enables logging immediately.
Written by Qasim Muhammad Staff SRE
What does nylas audit init do?
The nylas audit init command sets up audit logging to record every CLI command execution with timestamps, arguments, and outcomes. Logs are stored locally in JSON or text format with configurable retention (default 90 days) and max file size (default 50 MB). Use audit logs to track AI agent activity, meet compliance requirements, or debug automation pipelines.
Usage
nylas audit init [--path DIR] [--retention DAYS] [--enable]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 |
| --path | Custom directory for audit log storage |
| --retention | Log retention period in days (default: 90) |
| --max-size | Maximum log file size in MB (default: 50) |
| --format | Log format: json or text (default: json) |
| --enable | Enable logging immediately after initialization |
| --no-prompt | Skip interactive prompts (use defaults) |
Examples
The nylas audit init command sets up audit logging to record every CLI command execution with timestamps, arguments, and outcomes.
Interactive setup
nylas audit init
# Follow prompts to configure retention, format, and storageNon-interactive (CI/automation)
nylas audit init --retention 30 --format json --enable --no-promptCustom storage path
nylas audit init --path /var/log/nylas-audit --max-size 100 --enableExample output
✓ Audit logging initialized
Log directory: ~/.config/nylas/audit
Format: jsonl
Retention: 90 days
Max size: 50 MB
Status: enabledTroubleshooting
Permission denied when creating log directory
Ensure you have write permissions to the target path, or use --path to specify an accessible directory.
Audit already initialized
Run `nylas audit config show` to see current settings. Use `nylas audit config set` to modify individual values.
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 init --help for full help output.