--coding Coding partner
Repos, branches, diffs, reviews, tests, terminals, previews.
- + Git plugin
- + Subagents (scout, reviewer, test-writer)
- + Local runtime + containers
example ask
> “Add a release-checklist app for this monorepo.”
a workshop OS for agents
build the agent only_you_need
A local-first macOS workspace bringing your coding agents, tools, memory, and apps together — extensible through plugins as your work changes.
§ 01 the_pain
Generic agents make you carry the workflow.
You paste the same context, repeat the same instructions, reopen the same tools, and keep the useful parts in your head. A chat can help with one task, but it rarely becomes part of how you work.
→ Sero turns useful workflows into durable workspace capabilities.
§ 02 self_extension_loop
When Sero is missing a capability, ask it to make one.
// Ask for a capability. Turn it into a plugin. Keep it forever.
01
Ask · chat → request capability
“I need a weekly planning assistant for this project.”
02
Build · plugins/weekly-planner/{manifest, tool.ts, App.tsx}
Sero helps scaffold a plugin: shared state, tools, UI, runtime — files you can keep iterating on.
03
Activate · Admin → Plugins → Local · status: live
Local Plugin Development runs the checkout directly in Sero.
04
Use · sidebar.app: weekly-planner · tool: planner.add_task
The new tool, panel, command, or widget appears in the workspace.
05
Keep improving · diff: planner@0.2 → planner@0.3
Next week, ask Sero to extend it. The capability stays.
§ 03 what_can_it_become
build the agent you actually wanted.
// Examples — your Sero will be different.
$ sero shape [ pick one ]
--assistant Personal assistant
Reminders, recurring prompts, profiles, personal memory.
- + Scheduler plugin
- + Memory plugin
- + Web plugin
example ask
> “Remind me each Friday to log expenses, then file them.”
--research Research desk
Search, sources, bookmarks, summaries, saved context.
- + Web plugin
- + MCP plugin
- + Custom skills + agents
example ask
> “Build a paper-tracker plugin that watches arXiv categories.”
--ops Operations console
Dashboards, monitors, routines, external APIs, jobs.
- + Plugin UIs + widgets
- + Background runtimes
- + Provider plugins
example ask
> “Make a deploy console that pings my staging cluster.”
§ 04 plugin_anatomy
plugins are how sero learns new work.
{
"name": "release-checklist",
"version": "0.1.0",
"sero": {
"app": "./dist/App.js",
"tools": ["./dist/tool.js"],
"commands": ["./dist/command.js"],
"runtime": "./dist/runtime.js",
"widgets": ["./dist/Widget.js"],
"state": "./dist/state.js",
"skills": ["./skills/*.md"],
"prompts": ["./prompts/*.md"]
}
} - [ui] UI panel — React surface, persistent
- [tools] Agent tools — Pi-callable functions
- [commands] Commands — User-invoked actions
- [state] Shared state — File-backed, profile-scoped
- [runtime] Background runtime — Long-running jobs
- [widgets] Dashboard widgets — Composable surfaces
- [prompts] Prompts / skills — Reusable behaviors
- [provider] Provider / integration — External services
§ 05 starting_abilities
useful from the start. yours over time.
[memory]
Identity, profile, long-term facts, daily logs.
[scheduler]
Recurring prompts and reminders.
[web]
Search, fetch, code lookup, bookmarks.
[git]
Branches, staging, commits, diffs, history.
[mcp]
Connect external MCP tools and resources.
[admin]
Edit agents, skills, prompts, plugins, sessions.
§ 06 honest_alpha
early, useful, built in public.
source-only OSS alpha · macOS · apple silicon · profile-scoped state · container-backed workspaces when available · host-mode fallback otherwise · plugin/runtime contracts will evolve.
$ sero --version sero/0.x pi-coding-agent electron react-19 profile: dan@host macOS 14.x arm64
§ 07 make_it_yours
make sero yours.
Start with a local agent workspace. Then teach it the tools, assistants, and workflows you want to keep.
