← sero-ai.dev
Start Here
Workspace
Agents
Plugins
Reference
← sero-ai.dev
Start Here
Workspace
Agents
Plugins
Reference

Start Here

Sero is a local-first, agent-first desktop workspace for macOS. It brings project workspaces, Pi-backed agent chat, plugins, terminals, previews, and local runtime orchestration into one desktop shell.

If you just want to run it, skip to Getting started. If you want the product model first, read the overview below.

Overview

Sero is built for users who want fewer context switches between editor, terminals, AI tooling, app-specific workflows, and project coordination.

The project goal is not just “AI in an editor.” It is a workspace layer where:

  • Pi is the coding agent
  • workspaces are first-class
  • runtime mode can be container-backed or host-based
  • plugins can extend both UI and agent capabilities

Current alpha scope

The current OSS alpha is intentionally narrow:

  • platform: macOS on Apple Silicon
  • distribution: source-only
  • preferred runtime: Apple container-backed workspaces
  • fallback runtime: host mode with reduced capabilities

Sero does not currently promise official binaries, Linux support, Windows support, or fully stable internal runtime/plugin contracts.

Getting started

Who this alpha is for

Sero OSS alpha is aimed at:

  • technically comfortable macOS developers
  • early adopters who are okay with alpha-quality workflows
  • contributors interested in agent-first tooling
  • plugin authors working with evolving APIs

Fast path

From the repo root:

pnpm install
pnpm dev

That is the canonical first-run path for contributors.

Core root commands

pnpm typecheck
pnpm build
pnpm test
pnpm test:ci
pnpm eval:snapshot

Learn the workspace

After the repo boots, these guides explain the main product surfaces:

  • Workspace and Chat explains the shell, sidebar, workspaces, sessions, global chat panel, and onboarding flow.
  • Explorer Workspace maps files, editor previews, browser tabs, terminals, and dev-server surfaces.
  • Settings and Admin and Models and Providers explain Admin, model/provider, prompt, skill, and context management surfaces.
  • Themes explains profile-scoped theme selection and editing.
  • MCP explains MCP server management and sensitive server configuration.
  • Memory explains durable local context, scratchpad workflows, storage, and recall limits.
  • Web explains web search, content fetching, bookmarks, provider prerequisites, and workspace-scoped web state.
  • Remote Control explains the optional, security-sensitive gateway pairing surface.
  • Scheduler and Reminders explains recurring agent jobs, reminders, notification caveats, and conservative recovery.
  • Git Integration explains repository status, changes, branch context, remote origins, and conservative agent/Git workflows.
  • Plugins and Apps explains core apps, bundled plugins, installed plugins, and app-runtime concepts.
  • App Store and Favorites explains plugin discovery, sidebar favorites, compatibility, install/uninstall, and retained state.

What to read next

Before filing issues

Please redact tokens, auth files, and private local paths from logs, screenshots, and reproduction notes.

Canonical source material

This docs site is the curated public surface for alpha. The current source material it draws from includes:

ON THIS PAGE