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 |
| 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 |