Skip to content
NextOS
app.header.homeapp.header.docs

CLI

Run NextOS from scripts, terminals, and automation.

The CLI is the runtime entry point. It can launch the interactive TUI, run prompts non-interactively, manage providers and MCP auth, serve the local API, and inspect sessions.

Daily commands

Terminal window
nextos
nextos run "fix the failing test"
nextos serve
nextos web

Runtime management

Terminal window
nextos providers
nextos models
nextos mcp
nextos session
nextos upgrade

Use CLI for automation

nextos run is useful in scripts, CI experiments, or repeatable local checks. Prefer prompts that name the target and expected output:

Terminal window
nextos run "audit packages/nextos for permission regressions and report findings only"

For irreversible actions, let permissions stay strict. Automation should still be auditable.

Configuration locations

Project behavior is usually described by AGENTS.md and .nextos/. User-level defaults live under the NextOS config directories described in Config.