Documentation
Guides mirrored from the native-cli-ai repository. Start with Overview or jump to a topic below. These pages cover install, the TUI, sessions, providers, skills, and orchestration for the terminal-native AI coding agent.
Guides
- OverviewOverview of nca, the Rust-native terminal AI coding agent: quick start, feature map, and documentation index.
- Getting StartedInstall nca on macOS, Linux, or Windows, run first-time setup, and configure providers for the terminal AI coding agent.
- CommandsComplete nca CLI command and flag reference for run, spawn, sessions, attach, logs, skills, models, and doctor.
- Interactive Modenca TUI and REPL guide: live busy activity, slash commands, keyboard shortcuts, command palette, and image paste.
- Configurationnca configuration files, unified product home paths, TOML format, smart compaction, and environment variables.
- ProvidersConfigure MiniMax, Anthropic, OpenAI, OpenRouter, and custom OpenAI/Anthropic-compatible endpoints in nca.
- Toolsnca agent tools reference: file operations, structured search, shell, web, ask_question, spawn_subagent, and MCP.
- Sessionsnca session lifecycle under the unified product home: spawn, resume, attach, logs, status, and persistence.
- Permissionsnca approval system, permission modes, safe mode, and how tool approvals work in the interactive TUI.
- SkillsDiscover, install, and author nca skills from AGENTS.md, workspace directories, user skill dirs, and built-ins.
- AdvancedAdvanced nca topics: sub-agents, git worktrees, MCP servers, hooks, JSON/NDJSON orchestration, and Unix IPC.
Suggested path
New users should install from Get started, then readGetting Started, Interactive Mode, andProviders. Automation and multi-agent workflows live inAdvanced.