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 — composer controls, context editor, workspace snapshots, steering, queues, and voice.
    • Subagents — user workflows for delegated child sessions.
    • Agent Definitions — profile-scoped agent definition file format.
    • Models and Providers — provider catalog, provider health, auth modes, model selection, tiers, and recovery.
    • Local LLMs with LM Studio — task guide for configuring a local OpenAI-compatible LM Studio server.
    • models.json Reference — exact local/custom model provider schema.
    • Themes — theme selection and editing.
    • MCP — MCP server management.
    • Plugin Catalog — 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

    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 for the file format and Subagents for the user workflow.

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

    Admin agents

    Skills are reusable instruction bundles. Use the Skills view to inspect what is installed before assuming a workflow-specific skill is available.

    Admin skills

    Prompt management is for profile-scoped prompt templates. Prompts may include private workflow details, so review them before sharing screenshots.

    Prompt management

    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

    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.