DEV Community: Qasim Muhammad

Show the current audit configuration, including log path, retention, rotation, and compression settings with nylas audit conf...

Qasim Muhammad — Tue, 14 Apr 2026 00:25:29 +0000

Show the current audit configuration, including log path, retention, rotation, and compression settings. Essential for SOC 2 compliance and AI agent oversight.

The nylas audit config show command displays every audit setting in effect — log file path, retention period, max file size, daily rotation, compression, and whether request IDs and API details are recorded. Use it to verify your audit setup before enabling logging or to troubleshoot why logs aren't appearing where expected.

Syntax

nylas audit config show

When to Use This

Reach for nylas audit config show for compliance reporting, AI agent oversight, or debugging automation failures. Combine with --json to pipe output into other tools.

Examples

Display current audit configuration:

nylas audit config show

Check configuration as JSON for scripting:

nylas audit config show --json

How It Works

Every entry in the audit log captures: the exact command, all arguments (with secrets redacted), the invoker identity (human or AI agent name), the exit code, and a nanosecond timestamp. This level of detail is what compliance auditors expect.

Full docs: nylas audit config show reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

Using nylas audit logs disable to disable audit logging. Stops recording CLI activity to the audit log file

Qasim Muhammad — Tue, 14 Apr 2026 00:25:21 +0000

When AI agents send emails on your behalf, you need a record of what happened. nylas audit logs disable is part of that audit trail.

The nylas audit logs disable command turns off audit logging so the CLI no longer writes activity records to the log file. Existing log data is preserved — only new entries stop being written.

Examples

Disable audit logging:

nylas audit logs disable

Disable and verify status:

nylas audit logs disable
nylas audit logs status

Syntax

nylas audit logs disable

How It Works

Common Issues

Logs still being written after disable
Restart any long-running CLI processes (e.g., TUI or AIR). The disable takes effect on new CLI invocations.

Command not found
Update to the latest CLI version. Audit commands were added in v0.10.0. Run brew upgrade nylas-cli or re-run the install script.

Full docs: nylas audit logs disable reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

nylas audit logs enable: Developer Reference with Examples

Qasim Muhammad — Tue, 14 Apr 2026 00:25:14 +0000

Compliance and debugging both need logs. nylas audit logs enable handles the enable audit logging. records all cli activity to a local log file for compliance and debugging.

The nylas audit logs enable command activates audit logging, recording every CLI action — email sends, calendar reads, auth changes — to a local file. By default logs are written to ~/.

Quick Start

brew install nylas/nylas-cli/nylas
nylas init
nylas audit logs enable

Syntax

nylas audit logs enable [--output PATH]

How It Works

Key Flags

Run nylas audit logs enable --help to see all available flags. Add --json for machine-readable output — useful when piping into jq or feeding data to scripts.

nylas audit logs enable --help

Examples

Enable audit logging to default location:

nylas audit logs enable

Enable logging to a custom file:

nylas audit logs enable --output /var/log/nylas-audit.log

Related Commands

nylas audit init — Initialize audit logging for the Nylas CLI. Creates the log directory, default c
nylas audit logs show — View and filter audit log entries. Supports filtering by date range, command, st
nylas audit logs summary — View summary statistics of audit log entries including command counts, error rat
nylas audit logs clear — Clear all audit log entries. This is a destructive action — consider exporting l

Full docs: nylas audit logs enable reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

nylas audit logs status Explained — Flags, Examples, Tips

Qasim Muhammad — Tue, 14 Apr 2026 00:24:58 +0000

Check whether audit logging is enabled and show the current log file location. Essential for SOC 2 compliance and AI agent oversight.

The nylas audit logs status command reports whether audit logging is active, the path to the current log file, its size on disk, and the number of entries recorded. Use it to confirm logging is working or to find the log file for review.

Syntax

nylas audit logs status

How It Works

Examples

Check audit logging status:

nylas audit logs status

Get status as JSON for monitoring scripts:

nylas audit logs status --json

Tips

Combine with other commands: Chain nylas audit logs status with other Nylas CLI commands using shell pipes and variables for complex workflows.

Debug mode: Add --verbose to see the underlying API requests and responses — useful when something doesn't behave as expected.

Related Commands

nylas audit init — Initialize audit logging for the Nylas CLI. Creates the log directory, default c
nylas audit logs show — View and filter audit log entries. Supports filtering by date range, command, st
nylas audit logs summary — View summary statistics of audit log entries including command counts, error rat
nylas audit logs clear — Clear all audit log entries. This is a destructive action — consider exporting l

Full docs: nylas audit logs status reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

Show DST transition dates for a timezone, including the next spring-forward and fall-back dates — nylas timezone dst Guide

Qasim Muhammad — Tue, 14 Apr 2026 00:24:50 +0000

Timezone operations that work offline, with zero API calls. nylas timezone dst runs entirely on your machine.

The nylas timezone dst command displays Daylight Saving Time transition dates for any IANA timezone. It shows the next spring-forward and fall-back timestamps, the UTC offset before and after each transition, and how many minutes shift.

Quick Start

brew install nylas/nylas-cli/nylas
nylas init
nylas timezone dst

Syntax

nylas timezone dst --zone TIMEZONE

Examples

Check US Eastern DST transitions:

nylas timezone dst --zone America/New_York

Check EU DST transitions:

nylas timezone dst --zone Europe/London

JSON output for scripting:

nylas timezone dst --zone Asia/Tokyo --json

How It Works

These timezone commands use the IANA timezone database compiled into the binary. No network calls, no API keys, no rate limits. They work on airplanes.

Common Issues

Unknown timezone error
Use full IANA timezone names (America/New_York, not EST). Run nylas timezone list to see all valid identifiers.

No DST transitions shown
Some timezones don't observe DST (e.g., Asia/Tokyo, America/Phoenix). The command correctly reports no transitions for these zones.

Full docs: nylas timezone dst reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

nylas timezone find-meeting in Practice: Find overlapping business hours across multiple timezones to schedule a meeting

Qasim Muhammad — Tue, 14 Apr 2026 00:24:32 +0000

Find overlapping business hours across multiple timezones to schedule a meeting. No internet connection or API key needed.

The nylas timezone find-meeting command calculates available meeting windows when participants span multiple timezones. Pass two or more IANA zones and an optional duration, and it returns time slots where all participants fall within business hours (9 AM - 5 PM local).

Syntax

nylas timezone find-meeting --zones ZONE1,ZONE2 [--duration MINUTES]

Examples

Find meeting time for US and EU teams:

nylas timezone find-meeting --zones America/New_York,Europe/London

Find 60-minute slot across three timezones:

nylas timezone find-meeting --zones America/Los_Angeles,America/New_York,Asia/Kolkata --duration 60

How It Works

These timezone commands use the IANA timezone database compiled into the binary. No network calls, no API keys, no rate limits. They work on airplanes.

When to Use This

Reach for nylas timezone find-meeting when scheduling meetings across time zones or converting times in scripts. Combine with --json to pipe output into other tools.

Tips

Script-friendly: Add --json for machine-readable output and --yes (where supported) to skip confirmations in automated pipelines.

CI/CD ready: This command works in non-interactive mode. Set NYLAS_API_KEY as an environment variable and it picks up credentials automatically.

Full docs: nylas timezone find-meeting reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

A Practical Guide to nylas timezone info

Qasim Muhammad — Sun, 12 Apr 2026 12:09:00 +0000

Distributed teams deal with timezones constantly. nylas timezone info solves that from the terminal.

The nylas timezone info command displays the current UTC offset, timezone abbreviation, DST status, and standard/daylight names for any IANA timezone. Pass the zone as a positional argument.

How It Works

These timezone commands use the IANA timezone database compiled into the binary. No network calls, no API keys, no rate limits. They work on airplanes.

Syntax

nylas timezone info <ZONE>

Examples

Show Pacific Time details:

nylas timezone info America/Los_Angeles

Check UTC offset for a zone:

nylas timezone info Europe/Berlin

Full docs: nylas timezone info reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

nylas air — What It Does and How to Use It

Qasim Muhammad — Sun, 12 Apr 2026 12:08:42 +0000

AI-powered email assistant. Opens an interactive REPL where you can draft, reply, search, and manage email with natural language.

The nylas air command starts an interactive AI-powered email session.

Quick Start

brew install nylas/nylas-cli/nylas
nylas init
nylas air

Examples

Start the AI email assistant:

nylas air

Draft and send in a session:

nylas air
# > Draft a meeting recap to team@company.com
# > Make it shorter and add action items
# > Send it

How It Works

The Nylas CLI includes several utilities beyond the core email, calendar, and contacts commands. These are designed to complement your workflow without requiring separate tools.

Syntax

nylas air

Related Commands

nylas config reset — Reset all CLI configuration and credentials to a clean state
nylas ui — Start web configuration UI
nylas completion bash — Generate shell completion script for bash, zsh, fish, or PowerShell
nylas demo email list — List emails from a built-in demo account. No authentication or API key required

Full docs: nylas air reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

List emails from a built-in demo account. No authentication or API key required from the Command Line

Qasim Muhammad — Sat, 11 Apr 2026 20:43:23 +0000

The nylas demo email list command displays sample emails from a pre-configured demo mailbox, letting you explore the CLI's email features without connecting a real account.

The nylas demo email list command displays sample emails from a pre-configured demo mailbox, letting you explore the CLI's email features without connecting a real account. No API key or OAuth flow needed — run it right after installing.

Syntax

nylas demo email list [--limit N]

Examples

Browse demo emails without any setup:

nylas demo email list

Show 5 demo emails as JSON:

nylas demo email list --limit 5 --json

When to Use This

Reach for nylas demo email list as part of your CLI workflow. Combine with --json to pipe output into other tools.

How It Works

The Nylas CLI includes several utilities beyond the core email, calendar, and contacts commands. These are designed to complement your workflow without requiring separate tools.

Related Commands

nylas config reset — Reset all CLI configuration and credentials to a clean state
nylas ui — Start web configuration UI
nylas air — AI-powered email assistant. Opens an interactive REPL where you can draft, reply
nylas completion bash — Generate shell completion script for bash, zsh, fish, or PowerShell

Full docs: nylas demo email list reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

nylas tui for Developers — Quick Reference

Qasim Muhammad — Sat, 11 Apr 2026 20:42:49 +0000

Launch the terminal UI for browsing email, calendar, and contacts in an interactive interface.

The nylas tui command opens a full-screen terminal interface for managing email, calendar events, and contacts. Navigate your inbox with keyboard shortcuts, read and reply to messages, and switch between accounts — all without leaving the terminal.

Syntax

nylas tui

How It Works

The Nylas CLI includes several utilities beyond the core email, calendar, and contacts commands. These are designed to complement your workflow without requiring separate tools.

Examples

Launch the terminal UI:

nylas tui

Launch with verbose logging for debugging:

nylas tui --verbose

Common Issues

TUI shows blank screen or garbled output
Ensure your terminal supports 256 colors and is at least 80x24 characters. Try a different terminal emulator if the issue persists.

No emails shown in TUI
Run nylas auth whoami to verify an account is connected. The TUI requires an active grant — run nylas auth login if needed.

Full docs: nylas tui reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

Hands-On with nylas completion bash: Generate shell completion script for bash, zsh, fish, or PowerShell

Qasim Muhammad — Sat, 11 Apr 2026 20:41:07 +0000

The Nylas CLI includes utilities beyond email and calendar. nylas completion bash is one of them.

The nylas completion bash command outputs a shell completion script that enables tab-completion for all Nylas CLI commands, flags, and arguments. Pipe the output into your shell's completion directory or source it from your profile.

Syntax

nylas completion bash

How It Works

The Nylas CLI includes several utilities beyond the core email, calendar, and contacts commands. These are designed to complement your workflow without requiring separate tools.

Examples

Add completions to .bashrc:

nylas completion bash >> ~/.bashrc
source ~/.bashrc

Add completions to .zshrc:

nylas completion zsh >> ~/.zshrc
source ~/.zshrc

Fish shell completions:

nylas completion fish > ~/.config/fish/completions/nylas.fish

Common Issues

Completions not working after sourcing
Open a new terminal session. Some shells cache completions and won't pick up changes until restart.

Completions outdated after CLI update
Regenerate the completion script after each CLI update. The script is tied to the installed version's command set.

Tips

Pipe to jq: nylas completion bash --json | jq '.' gives you structured data you can filter and transform.

Combine with other commands: Chain nylas completion bash with other Nylas CLI commands using shell pipes and variables for complex workflows.

Full docs: nylas completion bash reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods

Working with nylas workflow otp list: List one-time password emails, extracting OTP codes from recent messages

Qasim Muhammad — Sat, 11 Apr 2026 20:39:41 +0000

The Nylas CLI includes utilities beyond email and calendar. nylas workflow otp list is one of them.

The nylas workflow otp list command scans your inbox for emails containing one-time passwords and verification codes. It extracts the numeric codes from subject lines and message bodies, displaying them alongside sender, subject, and timestamp.

Syntax

nylas workflow otp list [--limit N] [--json]

Examples

Find recent OTP codes:

nylas workflow otp list

Extract the latest OTP code for automation:

nylas workflow otp list --limit 1 --json | jq -r '.[0].code'

Scan last 20 messages for verification codes:

nylas workflow otp list --limit 20

Tips

Combine with other commands: Chain nylas workflow otp list with other Nylas CLI commands using shell pipes and variables for complex workflows.

Debug mode: Add --verbose to see the underlying API requests and responses — useful when something doesn't behave as expected.

How It Works

The Nylas CLI includes several utilities beyond the core email, calendar, and contacts commands. These are designed to complement your workflow without requiring separate tools.

Related Commands

nylas config reset — Reset all CLI configuration and credentials to a clean state
nylas ui — Start web configuration UI
nylas air — AI-powered email assistant. Opens an interactive REPL where you can draft, reply
nylas completion bash — Generate shell completion script for bash, zsh, fish, or PowerShell

Full docs: nylas workflow otp list reference — all flags, advanced examples, and troubleshooting.

All commands: Nylas CLI Command Reference

Get started: brew install nylas/nylas-cli/nylas — other install methods