Config

NextOS configuration answers four questions: which model should run, which tools may run, which instructions shape behavior, and which local integrations are enabled.

Configuration layers

Layer	Use
AGENTS.md	Human-readable project instructions committed with the repo.
.nextos/	Project commands, local rules, and project-specific overrides.
User config	Personal providers, themes, permissions, and preferences.
Environment	Secrets and per-machine values.

Project instructions

Run /init to generate AGENTS.md, then edit it. Keep it concrete: test commands, package boundaries, style rules, deployment constraints, and actions that need explicit approval.

JSON config

Use nextos.json for structured values such as agents, commands, MCP servers, or provider defaults.

{
  "$schema": "https://nextagentos.com/config.json",
  "provider": "openai",
  "model": "gpt-5"
}

The desktop settings can show active instruction sources and project memory. Use memory for durable project facts, not for secrets.