CLI Reference

LNAI provides three commands for managing your unified AI configuration.

Installation

pnpm add -g lnai

lnai init

Initialize a new .ai/ configuration directory.

lnai init [options]

When run interactively (in a terminal), lnai init prompts you to select which tools to configure and how to handle version control. Use -y to skip prompts and use defaults.

Option	Description
`-y, --yes`	Skip prompts and use defaults
`--force`	Overwrite existing .ai/ directory
`--minimal`	Create only config.json (no subdirectories)
`-t, --tools <tools...>`	Enable only specific tools

Examples

lnai init                        # Interactive mode (prompts for tools)
lnai init -y                     # Non-interactive, use defaults
lnai init --minimal              # Create only config.json
lnai init --tools claudeCode     # Enable only Claude Code
lnai init --force                # Overwrite existing config

lnai sync

Export the unified .ai/ configuration to native tool formats.

lnai sync [options]

Option	Description
`--dry-run`	Preview changes without writing files
`--skip-cleanup`	Skip deletion of orphaned files
`-t, --tools <tools...>`	Filter to specific tools
`-v, --verbose`	Show detailed output

Output Symbols

Symbol	Meaning
`+`	File created
`~`	File updated
`-`	File deleted
`=`	File unchanged

Examples

lnai sync                        # Sync all enabled tools
lnai sync --dry-run              # Preview changes
lnai sync --tools claudeCode     # Sync only Claude Code

lnai validate

Validate the unified .ai/ configuration structure and content.

lnai validate [options]

Option	Description
`-t, --tools <tools...>`	Filter validation to specific tools

Examples

lnai validate                    # Validate all configuration
lnai validate --tools claudeCode # Validate only for Claude Code

Tool Identifiers

Identifier	Tool
`claudeCode`	Claude Code
`codex`	Codex
`cursor`	Cursor
`gemini`	Gemini CLI
`copilot`	GitHub Copilot
`opencode`	OpenCode
`windsurf`	Windsurf