> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Reference

Use reference pages when you need exact facts: support boundaries, runtime behavior, file locations, command syntax, plugin APIs, diagnostics, or security details. Reference pages are for lookup; use [Guides](/guide/index.md) when you want step-by-step task help.

## Support and diagnostics

- [Support Scope](/reference/support-scope.md) — the canonical public support contract for platforms, workspace runtimes, browser automation readiness, and issue-reporting expectations.
- [Known Limitations](/reference/known-limitations.md) — current product, platform, runtime, and distribution boundaries.
- [Environment Doctor](/reference/environment-doctor.md) — diagnostic entry points, result states, and report behavior.
- [Troubleshooting](/reference/troubleshooting.md) — symptom-oriented recovery checks and baseline reporting details.

## Runtime and system facts

- [Architecture](/reference/architecture.md) — desktop shell, workspace model, runtime modes, and plugins.
- [Containers and Host Mode](/reference/containers-host-mode.md) — runtime behavior, requirements, logs, overrides, and caveats.
- [Container Isolation](/reference/container-isolation.md) — container lifecycle, mounts, networking, and dev-server registry behavior.
- [State and Folders](/reference/state-and-folders.md) — profile paths, workspace state, app state, memory storage, and redaction guidance.
- [Output Optimizer](/reference/output-optimizer.md) — optional shell-output rewriting and compaction, bounded previews, and complete capture files.
- [Sero CLI](/reference/sero-cli.md) — command syntax, namespaces, output, side effects, batch behavior, and plugin bridging.
- [Orchestrator](/reference/orchestrator.md) — mode comparison, compatibility terms, and permission boundary.
- [Workflows](/reference/workflows.md) — commands, plan rules, recovery, triggers, limits, library, and storage.
- [Rooms](/reference/rooms.md) — statuses, member access, limits, actions, recovery, and storage.
- [Architect](/reference/architect.md) — owner tool, direct work, waits, stall recovery, records, and storage.

## Configuration facts

- [`models.json`](/reference/models-json.md) — local/custom model provider schema, examples, discovery behavior, and recovery.
- [Agent Definitions](/reference/agent-definitions.md) — subagent Markdown frontmatter, model resolution, settings, and child-session limits.
- [Security / Privacy](/reference/security-privacy.md) — safeguards, permissions, remote surfaces, and sensitive state.
- [Testing / Evals](/reference/testing-evals.md) — quality model, smoke checks, promptfoo evals, cost/auth caveats, and scenario coverage.

## Plugin author facts

- [Agent Plugins](/reference/agent-plugins.md) — portable Agent Skills, managed MCP servers, permissions, storage, and CLI exposure.
- [Plugins](/reference/plugins.md) — distribution modes, local development, and compatibility guidance.
- [App Runtime](/reference/app-runtime.md) — `@sero-ai/app-runtime` hooks, bridge APIs, and widget registry.
- [Plugin Author Quick Path](/reference/plugin-author-quick-path.md) — practical path from package shape to extension, UI, runtime, and widgets.
- [Plugin Quickstart](/reference/plugin-quickstart.md) — canonical starter example and success criteria.
- [Plugin End-to-End Example](/reference/plugin-end-to-end-example.md) — larger example with UI, background runtime, widgets, and tools.

## Catalog

- [Plugin Catalog](/plugins/catalog.md) — public catalog for built-in and external/local plugins, with selected dedicated plugin pages.
