From 5d55c98140ce4c420005e69b306c49ad9bdc72d6 Mon Sep 17 00:00:00 2001 From: Vincent Date: Thu, 6 Aug 2026 15:06:02 -0400 Subject: [PATCH 1/4] docs: point the server reference at atomic-storage, mark atomic-enterprise legacy MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit atomic-enterprise is the old server and is no longer in use, but README and AGENTS.md still named it as the HTTP API — which routes anyone (human or agent) building server integrations at a dead codebase. Point at atomic-storage, note atomic-remote lives in this repo, and record the team's design stance: the server is primarily transport; clients have everything locally, so server-side read surface is added deliberately. --- AGENTS.md | 5 +++-- README.md | 6 ++++-- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 8da778cf..6ddc0421 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,8 +28,9 @@ atomic/ ### Related Projects -- **atomic-remote-client** (`atomic-enterprise/atomic-remote`) - Clean-room HTTP client for remote operations -- **atomic-api** (`atomic-enterprise/atomic-api`) - Server-side HTTP API for remote operations +- **atomic-storage** (`atomicdotdev/atomic-storage`) - The live multi-tenant storage server. Primarily transport (push/pull/clone protocol, provenance/attestation storage); clients keep everything they need locally, so server-side read surface is added only deliberately. +- **atomic-remote** (`atomic-remote/`, this repo) - HTTP client for the storage server (wire protocol + management API) +- **atomic-enterprise** - LEGACY server, no longer in use. Do not build against it. ## Core Concepts diff --git a/README.md b/README.md index 353d5c89..f9609e48 100644 --- a/README.md +++ b/README.md @@ -402,10 +402,12 @@ atomic/ | Project | Location | Description | |---------|----------|-------------| -| **atomic-api** | `atomic-enterprise/atomic-api` | HTTP API for remote operations and multi-tenant hosting | -| **atomic-remote-client** | `atomic-enterprise/atomic-remote` | HTTP client library for push/pull/clone | +| **atomic-storage** | `atomicdotdev/atomic-storage` | The live multi-tenant storage server (Axum + PostgreSQL). Primarily transport — push/pull/clone protocol plus provenance and attestation storage. Everything a client needs lives locally; be deliberate before adding server-side read surface. | +| **atomic-remote** | `atomic-remote/` (this repo) | HTTP client library for push/pull/clone and the storage management API | | **atomic-docs** | `atomic-docs/` | Documentation site ([docs.atomic.dev](https://docs.atomic.dev/)) | +> `atomic-enterprise` is the **legacy** server and is no longer in use — do not build against it. + ## Atomic + smolvm: Concurrent Agent Sandboxes When several agents work a repository at once, each needs an isolated build From bf8cf394e2f6125a30c9283ff9c4ac49d743fd18 Mon Sep 17 00:00:00 2001 From: Vincent Date: Thu, 6 Aug 2026 16:16:00 -0400 Subject: [PATCH 2/4] docs: drop private-repo references from public docs entirely MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Review feedback: the public repo should not link private repos at all — outsiders just hit 404s. Instead of swapping one private pointer for another, remove them: name only in-repo crates, describe the hosted server generically as a separate closed-source product that is primarily transport, and route internal contributors to the sibling checkout in the team workspace. --- AGENTS.md | 10 +++++++--- README.md | 7 +++++-- 2 files changed, 12 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 6ddc0421..c710f2a2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,9 +28,13 @@ atomic/ ### Related Projects -- **atomic-storage** (`atomicdotdev/atomic-storage`) - The live multi-tenant storage server. Primarily transport (push/pull/clone protocol, provenance/attestation storage); clients keep everything they need locally, so server-side read surface is added only deliberately. -- **atomic-remote** (`atomic-remote/`, this repo) - HTTP client for the storage server (wire protocol + management API) -- **atomic-enterprise** - LEGACY server, no longer in use. Do not build against it. +- **atomic-remote** (`atomic-remote/`, this repo) - HTTP client for the Atomic storage server (wire protocol + management API) + +The storage server itself is a separate, closed-source product and is +**primarily transport** — clients keep everything they need locally, so +nothing in this repo should assume server-side read surface. Internal +contributors: the server lives as a sibling checkout in the team workspace; +its own README/AGENTS.md are authoritative for server work. ## Core Concepts diff --git a/README.md b/README.md index f9609e48..5d31b3e7 100644 --- a/README.md +++ b/README.md @@ -402,11 +402,14 @@ atomic/ | Project | Location | Description | |---------|----------|-------------| -| **atomic-storage** | `atomicdotdev/atomic-storage` | The live multi-tenant storage server (Axum + PostgreSQL). Primarily transport — push/pull/clone protocol plus provenance and attestation storage. Everything a client needs lives locally; be deliberate before adding server-side read surface. | | **atomic-remote** | `atomic-remote/` (this repo) | HTTP client library for push/pull/clone and the storage management API | | **atomic-docs** | `atomic-docs/` | Documentation site ([docs.atomic.dev](https://docs.atomic.dev/)) | -> `atomic-enterprise` is the **legacy** server and is no longer in use — do not build against it. +This repository contains everything needed to run Atomic locally — repositories, +views, the vault, provenance, and the knowledge graph all live on your machine. +The hosted storage server is a separate product and is primarily **transport**: +it moves changes, attestations, and provenance between machines. See +[atomic.dev](https://atomic.dev) for hosted offerings. ## Atomic + smolvm: Concurrent Agent Sandboxes From 56007c775849fa179c5d33ab72b66880d81b2ac8 Mon Sep 17 00:00:00 2001 From: Vincent Date: Thu, 6 Aug 2026 16:24:23 -0400 Subject: [PATCH 3/4] docs: tighten the server note to two lines --- AGENTS.md | 9 +++------ README.md | 9 +++------ 2 files changed, 6 insertions(+), 12 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c710f2a2..be3f1d8c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,13 +28,10 @@ atomic/ ### Related Projects -- **atomic-remote** (`atomic-remote/`, this repo) - HTTP client for the Atomic storage server (wire protocol + management API) +- **atomic-remote** (`atomic-remote/`) - HTTP client for the storage server -The storage server itself is a separate, closed-source product and is -**primarily transport** — clients keep everything they need locally, so -nothing in this repo should assume server-side read surface. Internal -contributors: the server lives as a sibling checkout in the team workspace; -its own README/AGENTS.md are authoritative for server work. +The server is a separate closed-source product, primarily transport — +clients have everything locally. Server work happens in its own repo. ## Core Concepts diff --git a/README.md b/README.md index 5d31b3e7..d723a853 100644 --- a/README.md +++ b/README.md @@ -402,14 +402,11 @@ atomic/ | Project | Location | Description | |---------|----------|-------------| -| **atomic-remote** | `atomic-remote/` (this repo) | HTTP client library for push/pull/clone and the storage management API | +| **atomic-remote** | `atomic-remote/` | HTTP client for push/pull/clone | | **atomic-docs** | `atomic-docs/` | Documentation site ([docs.atomic.dev](https://docs.atomic.dev/)) | -This repository contains everything needed to run Atomic locally — repositories, -views, the vault, provenance, and the knowledge graph all live on your machine. -The hosted storage server is a separate product and is primarily **transport**: -it moves changes, attestations, and provenance between machines. See -[atomic.dev](https://atomic.dev) for hosted offerings. +Everything runs locally. The hosted server is a separate product and is +primarily transport — see [atomic.dev](https://atomic.dev). ## Atomic + smolvm: Concurrent Agent Sandboxes From bf822f3b1d668559279ef2829b77b4c22b633fdc Mon Sep 17 00:00:00 2001 From: Vincent Date: Thu, 6 Aug 2026 16:26:06 -0400 Subject: [PATCH 4/4] docs: drop the hosted-server mention entirely --- AGENTS.md | 5 +---- README.md | 3 --- 2 files changed, 1 insertion(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index be3f1d8c..473a00de 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,10 +28,7 @@ atomic/ ### Related Projects -- **atomic-remote** (`atomic-remote/`) - HTTP client for the storage server - -The server is a separate closed-source product, primarily transport — -clients have everything locally. Server work happens in its own repo. +- **atomic-remote** (`atomic-remote/`) - HTTP client for push/pull/clone ## Core Concepts diff --git a/README.md b/README.md index d723a853..9ac2d79b 100644 --- a/README.md +++ b/README.md @@ -405,9 +405,6 @@ atomic/ | **atomic-remote** | `atomic-remote/` | HTTP client for push/pull/clone | | **atomic-docs** | `atomic-docs/` | Documentation site ([docs.atomic.dev](https://docs.atomic.dev/)) | -Everything runs locally. The hosted server is a separate product and is -primarily transport — see [atomic.dev](https://atomic.dev). - ## Atomic + smolvm: Concurrent Agent Sandboxes When several agents work a repository at once, each needs an isolated build