Skip to content

What is built

What runs on main today, area by area, each with a status chip and where it is decided. built

Planned work and ideas are on the roadmap; each reef's commands are in the reef pages.

A chip says how far a feature is: built is code on main, planned has an issue that builds it, idea is still being refined.

The CLI and the model

Feature What it gives Status
nereus init Prepares a cluster and installs nothing else; settings kept in a file. ADR 0003 built
Time limit for init A time SLO for nereus init, checked in CI. spec 0004 built
Installation identity One Installation object per cluster, written by the first init. spec 0006 built
Reefs at runtime nereus reef create | apply | list | delete. ADR 0010 built
Nereids at runtime nereus nereid apply reads the image's labels from the registry. ADR 0003 built
Required reefs A Nereid is refused when a reef it requires is missing. spec 0003 built
Commands from a Nereid A reef's command group is built from data in the Nereid's status. ADR 0004 built
The CLI design commands reef, nereid, mandate and the conventions. ADR 0013 built
One writer per field The CLI writes spec, a Nereid writes only status. ADR 0005 built
Profiles core and internal-developer-platform; nereus profile apply. ADR 0014 built
nereus doctor Whether an instance is healthy, from GET /v1/doctor. #799 built
Swap checked in CI Swapping a Nereid changes no command. #124 built
Untrusted Nereid output What a Nereid publishes is untrusted input, with a test. #134 built
Nereid recovery A Nereid that stops is reported and recovers by itself. #133 built

The Nereus API and MCP

Feature What it gives Status
Nereus API nereus-api in the cluster; nereus whoami calls GET /v1/me. #607 built
MCP tools from reefs A reef declares tools; the API serves them at /mcp. ADR 0029 built
Chosen MCP tools nereus mcp tool enable | disable in the Installation. #1809 built
/mcp in Claude Code nereus mcp client add claude-code. #1880 built
nereus-mcp retired The instance's entrance serves /mcp. #1810 built

Cloud and identity

Feature What it gives Status
Reef kinds shipped by a reef The cloud reef ships its kind Cloud and its Mandate. spec 0005 built
Cloud plans A Nereid's plan is checked, approved and run with the person's login. #307 built
Requester tags Every cloud resource says which installation created it and why. #155 built
Undercloud nereus init --target <name> brings up the k3d undercloud. #263 built
Cloud grants A Nereid that requires cloud is granted access by the person. #310 built

Reefs

Feature What it gives Status
secrets Vault and Secret, encrypted on the client. #530 built
release Repository, Source, Target and Release. ADR 0010 built
environment An Environment per agent, with an expiry; the kept cluster naxos. ADR 0026 built
catalog Workload, Package, WorkloadType and PackageType. ADR 0016 built
database A PostgreSQL per Database. ADR 0017 built
messaging Topics and queues on NATS. ADR 0019 built
registry Registry, Repository, publish and purge, with the zot Nereid. ADR 0021 built
build Builds of a Workload's source and Triggers on new commits. spec 0009 built
scm A GitHub App Mandate, a Forgejo Mirror and a one-hour Token. ADR 0024 built
metrics The victoriametrics Nereid. #742 built
ideas The doris Nereid and Tide, its portal tab. #1106 built
portal A PWA that says who you are. spec 0008 built
usage A coding agent's quota window and its forecast. #1590 built
teams Team and Member on the tenancy tree. #1646 built
presentations A deck kept by the platform and a Session to follow. ADR 0028 built
authorization Role and Binding, asked before every read and write. ADR 0027 built

Building Nereids and the platform

Feature What it gives Status
nereid-sdk The Nereids' shared library, used by five Nereids. #754 built
Nereid template scripts/nereid/new --reef <reef> --tool <tool>. #752 built
Reference Nereids reference-build, reference-delivery, reference-registry. #1502 built
Checks on every pull request Tests, deck tests, strict docs build, shellcheck. #49 built
Deploy main to live scripts/deploy/live, and the line of main. #162 built