Everything the copilot knows
Official docs plus lessons from apps built on NovaOS. The same guides power novaos_docs inside your AI app.
NovaOS overview and glossary
What NovaOS is, the IDs you will meet, and how this MCP server's tools are organized.
Setting up a computer for NovaOS
Install Python, Docker, novaos-cli and the SDK on macOS, Linux or Windows; version matrix and install pitfalls.
Environments, sign-in, organizations and scopes
How novaos-cli resolves environments, how sign-in works, org context, roles, token scopes and the traps around them.
Building agents with the Python SDK
AgentBuilder, the one-skill rule, SkillResult statuses, progress and heartbeats, turn budgets, LLM/MCP/RAG calls inside an agent, manifest v2.0 and Dockerfile rules.
MCP tool servers on NovaOS
Building, naming, publishing and activating MCP servers that agents call through the NovaOS MCP gateway; the read/write name classifier and -32042.
Knowledge base: RAG, parsers, GraphRAG
Collections, parsing, ingest, search vs query, GraphRAG, limits and the RAG quirks that bite in production.
Publish, review, approval, installation and instances
From a local agent to a running instance: publish flow, review states, platform-admin approval, deployment targets, user vs service-account installs, versions and release order.
Service accounts and calling agents from an app backend
Creating and rotating service accounts, scopes, token minting, run-as-user vs service account, capacity limits and the backend integration pattern.
Runs, events and streaming
Execute, event stream, run states, stream cuts and recovery, threads, input limits and what callers actually see.
Chat, memory and databases
Conversation management, NovaOS Memory (and why apps keep their own), app databases with org isolation, and where state may live.
LLM gateway and models
Calling models through NovaOS: model ids, scopes, fallbacks, cost headers, rate limits, grounded web search, thinking tokens, and the prompt-injection filter.
Testing, evaluation, observability and metering
Local tests, eval suites, post-publish smoke tests, logs and traces, cost per run and org spending.
Troubleshooting by symptom
Symptom -> cause -> fix for the failures people actually hit with NovaOS. Use novaos_explain_error for any error text.
Known NovaOS platform issues and gaps (Nov 2026)
Platform-side limitations and bugs observed in production apps, with workarounds. Check before reporting a "new" bug.