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

# Settings and Admin

Sero's Admin app is provided by the built-in `@sero-ai/plugin-admin` package. It
collects profile-level configuration, local agent resources, session inspection,
and other support-oriented surfaces. Use this page as the entry point for
Admin-related documentation.

## What lives here

Admin-related docs are split into a few focused pages:

- **This page** — configuration files, agents, skills, prompts, and sessions.
- [Agent Sessions and Context](/guide/agent-sessions-and-context.md) — composer
  controls, context editor, workspace snapshots, steering, queues, and voice.
- [Subagents](/guide/subagents.md) — user workflows for delegated child sessions.
- [Agent Definitions](/reference/agent-definitions.md) — profile-scoped agent
  definition file format.
- [Models and Providers](/guide/models-and-providers.md) — provider catalog,
  provider health, auth modes, model selection, tiers, and recovery.
- [Local LLMs with LM Studio](/guide/local-llms-lm-studio.md) — task guide for
  configuring a local OpenAI-compatible LM Studio server.
- [`models.json` Reference](/reference/models-json.md) — exact local/custom model
  provider schema.
- [Themes](/guide/themes.md) — theme selection and editing.
- [MCP](/guide/mcp.md) — MCP server management.
- [Plugin Catalog](/plugins/catalog.md) — built-in versus external/local plugin inventory.

## Configuration files

The Admin configuration view exposes profile-scoped files such as layout,
settings, auth-related configuration, workspace/profile registries, and
environment-derived values. Treat these files as sensitive when sharing
screenshots or support reports.

![Admin settings](/static/image/admin-settings.bac2926dd8.jpg)
## Agents, skills, and prompts

Agent resources live under the Sero agent directory for the active profile:
`<SERO_HOME>/agent/`. Agent definitions are Markdown files under
`<SERO_HOME>/agent/agents/` (default `~/.sero-ui/agent/agents/`). The Admin app
can help inspect configured agents, installed skills, and prompt templates
without leaving the desktop shell. See [Agent Definitions](/reference/agent-definitions.md)
for the file format and [Subagents](/guide/subagents.md) for the
user workflow.

The Agents view shows the configured agent definitions available to the active
profile.

![Admin agents](/static/image/admin-agents.eb8d049a28.jpg)
Skills are reusable instruction bundles. Use the Skills view to inspect what is
installed before assuming a workflow-specific skill is available.

![Admin skills](/static/image/admin-skills.76cf6a7523.jpg)
Prompt management is for profile-scoped prompt templates. Prompts may include
private workflow details, so review them before sharing screenshots.

![Prompt management](/static/image/prompt-management.cc612016eb.jpg)
## Sessions

The Sessions view is for inspecting local agent session metadata and history
while troubleshooting or resuming work. Session data can include private prompts,
paths, outputs, and tool activity, so redact it carefully before sharing.

![Admin sessions](/static/image/admin-sessions.d0e81af1ea.jpg)
## Models, plugins, and logs

Select **Model** to inspect model configuration and provider state. Select **Plugins** to manage installed plugins, local plugin sources, Agent Plugins, and plugin development sessions. Select **Logs** to inspect desktop and plugin logs.

These sections can show credentials, local paths, repository details, prompts, and model names. Remove private values before you share an image or log excerpt.

## Built-in plugin notes

Admin is built in to the Sero source tree. It can be hidden or unfavorited like
other app surfaces, but it is not a third-party plugin that users remove through
Plugin Manager. Admin state and screenshots can expose private paths, prompts,
model names, and configuration values; redact them before sharing.

## Related docs

- [Plugin Catalog](/plugins/catalog.md)
- [Profiles and Onboarding](/guide/profiles-and-onboarding.md)
- [Models and Providers](/guide/models-and-providers.md)
- [Agent Sessions and Context](/guide/agent-sessions-and-context.md)
- [Subagents](/guide/subagents.md)
- [Agent Definitions](/reference/agent-definitions.md)
- [Local LLMs with LM Studio](/guide/local-llms-lm-studio.md)
- [`models.json` Reference](/reference/models-json.md)
- [Themes](/guide/themes.md)
- [MCP](/guide/mcp.md)
- [Workspace and Chat](/guide/workspace-and-chat.md)
- [State and Folders](/reference/state-and-folders.md)
- [Security / Privacy](/reference/security-privacy.md)
