Skip to content

Latest commit

 

History

History
214 lines (171 loc) · 9.68 KB

File metadata and controls

214 lines (171 loc) · 9.68 KB

Documentation Index

Website: cli.nylas.com

Quick navigation guide to find the right documentation for your needs.


🎯 I want to...

Get Started

Understand the Project

Development

Add Features

Testing

Fix Issues

Quality & Security

Maintenance

Command Guides

AI & MCP

Development Guides

Security & Troubleshooting


📂 Documentation Structure

docs/
├── INDEX.md               # This file - start here
├── COMMANDS.md            # CLI quick reference
├── ARCHITECTURE.md        # System design
├── DEVELOPMENT.md         # Development setup
│
├── commands/              # Detailed command guides (16 files)
│   ├── ai.md              # AI features
│   ├── mcp.md             # MCP integration
│   ├── calendar.md        # Calendar events
│   ├── email.md           # Email operations
│   ├── email-signing.md   # GPG/PGP email signing
│   ├── encryption.md      # Email encryption
│   ├── explain-gpg.md     # GPG explained
│   ├── contacts.md        # Contact management
│   ├── webhooks.md        # Webhook setup
│   ├── scheduler.md       # Booking pages
│   ├── admin.md           # API management
│   ├── timezone.md        # Timezone utilities
│   ├── audit.md           # Audit logging & invoker tracking
│   ├── tui.md             # Terminal UI
│   ├── templates.md       # Email templates
│   └── workflows.md       # OTP & automation
│
├── ai/                    # AI configuration (8 files)
│   ├── configuration.md   # Setup guide
│   ├── providers.md       # Provider options
│   ├── privacy-security.md # Privacy controls
│   └── ...
│
├── development/           # Dev guides (4 files)
│   ├── adding-command.md  # Add CLI commands
│   ├── adding-adapter.md  # Add API adapters
│   ├── testing-guide.md   # Testing patterns
│   └── debugging.md       # Debug tips
│
├── security/              # Security (2 files)
│   ├── overview.md        # Quick reference
│   └── practices.md       # Detailed practices
│
├── troubleshooting/       # Debug guides (5 files)
│   ├── faq.md             # Common questions
│   ├── auth.md            # Auth issues
│   ├── api.md             # API errors
│   ├── email.md           # Email issues
│   └── timezone.md        # Timezone issues
│
└── images/                # Screenshots (5 PNGs)

🔍 By Role

New Contributors

  1. README.md - Project overview
  2. CONTRIBUTING.md - How to contribute
  3. DEVELOPMENT.md - Setup instructions
  4. CLAUDE.md - Code navigation

Developers Adding Features

  1. ARCHITECTURE.md - Understand the design
  2. .claude/commands/add-command.md - Add CLI commands
  3. .claude/rules/testing.md - Testing requirements
  4. .claude/rules/documentation-maintenance.md - Doc updates

Bug Fixers

  1. .claude/commands/debug-test-failure.md - Test debugging
  2. troubleshooting/ - Common issues & FAQ
  3. .claude/commands/fix-build.md - Fix build errors

Maintainers

  1. .claude/commands/security-scan.md - Security checks
  2. .claude/commands/review-pr.md - PR review
  3. .claude/rules/go-quality.md - Go quality & linting

Users

  1. README.md - Getting started
  2. COMMANDS.md - Command reference
  3. cli.nylas.com/guides - Step-by-step tutorials
  4. troubleshooting/faq.md - Common questions

💡 Quick Tips

  • For AI (Claude): Most docs are in CLAUDE.md and .claude/ directory
  • For humans: Start with README.md and COMMANDS.md
  • Need help? Check troubleshooting/faq.md
  • Adding code? Follow workflows in .claude/commands/
  • Security concern? See security/overview.md

Last Updated: February 5, 2026