Skip to content

docs(agentos): update docs for 0.4 - #2038

Merged
eersnington merged 18 commits into
mainfrom
docs/agentos-0-4-core
Oct 12, 2026
Merged

eersnington merged 18 commits into
mainfrom
docs/agentos-0-4-core

Conversation

@eersnington

@eersnington eersnington commented Oct 12, 2026 •

Copy link
Copy Markdown
Member

Updates the agentOS docs for 0.4.

  • Rewrites the pages around @rivet-dev/agentos-core and restores the snippets refactor(agentos): simplify the VM runtime API #2011 deleted, which has broken the docs sync since then.
  • Adds a library quickstart and a hosted quickstart that cover the same use cases, each with a "Which one should I use?" table.
  • Adds a Hosted VM HTTP API reference under Reference, plus a Hosted API section on each capability page. The hosted content comes from the 0.4 launch post and services PRs Drizzle type-safe ORM #20 and Refactor registry to interface #21; @rivet-dev/agentos with createAgentOsClient is not published yet.
  • Documents SQLite-backed root persistence (database alone does not persist the root) and installing registry software from releases.rivet.dev/agent-os/<version>/software/manifest.json.

Merge together with rivet-dev/website#132, which fixes the registry page for the 0.4 registry format.

Sree Narayanan and others added 4 commits October 12, 2026 08:54
PR #2011 removed the RivetKit actor package and the examples the docs
embedded, which broke the docs sync. Rewrite the pages around
@rivet-dev/agentos-core: restore host function snippets, drop hosted actor,
session, preview, and sleep references, document SQLite-backed root
persistence, and fix broken links and the S3 mount plugin id.

Co-authored-by: Amp <amp@ampcode.com>
Amp-Thread-ID: https://ampcode.com/threads/T-c7d08b58-92c1-4fc0-abb9-7a15f4504a4f
Add Hosted VMs and Hosted VM API pages, a software installation and
preloading architecture page, and a Hosted API section on each capability
page. Sources: the agentOS 0.4 launch post and the services PRs that add
the agentOS actor (#21) and group its actions under v1 (#20).

Amp-Thread-ID: https://ampcode.com/threads/T-c7d08b58-92c1-4fc0-abb9-7a15f4504a4f
Co-authored-by: Amp <amp@ampcode.com>
0.4 publishes registry packages and default-software.json under releases.rivet.dev/agent-os/<version>/software/. Point the Software and Publishing pages and the install example at that manifest.

Amp-Thread-ID: https://ampcode.com/threads/T-c7d08b58-92c1-4fc0-abb9-7a15f4504a4f
Co-authored-by: Amp <amp@ampcode.com>
…TP API reference

Replace the Hosted VMs sidebar group with a hosted quickstart that mirrors the library quickstart, add a which-one-to-use table to both, and merge the hosted overview and API pages into one Hosted VM HTTP API reference.

Amp-Thread-ID: https://ampcode.com/threads/T-c7d08b58-92c1-4fc0-abb9-7a15f4504a4f
Co-authored-by: Amp <amp@ampcode.com>
@railway-app

railway-app Bot commented Oct 12, 2026

Copy link
Copy Markdown

This PR was not deployed automatically as @eersnington does not have access to the Railway project.

In order to get automatic PR deploys, please add @eersnington to your workspace on Railway.

Sree Narayanan and others added 14 commits October 12, 2026 09:27
…ting

Replace the separate Hosted API sections with Hosted and Library tabs on each example, hosted first, and note hosted-only and library-only features inline. Add a Self-Hosting reference page for running the control plane and the rivetdev/services worker, linked from the quickstart comparison table.

Amp-Thread-ID: https://ampcode.com/threads/T-c7d08b58-92c1-4fc0-abb9-7a15f4504a4f
Co-authored-by: Amp <amp@ampcode.com>
…ed sleep, rename Crons & Schedules

Rework both quickstarts around the launch post's Show me the code examples, with Rivet Cloud and self-hosting setup on the hosted side. Note that hosted VMs sleep when idle unless a process is running, linking actor lifecycle. Move Crons & Schedules into Operating System above Networking.

Amp-Thread-ID: https://ampcode.com/threads/T-c7d08b58-92c1-4fc0-abb9-7a15f4504a4f
Co-authored-by: Amp <amp@ampcode.com>
@eersnington
eersnington marked this pull request as ready for review October 12, 2026 10:53
@eersnington
eersnington merged commit 221382a into main Oct 12, 2026
4 of 6 checks passed
@eersnington
eersnington deleted the docs/agentos-0-4-core branch October 12, 2026 10:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant