Atomic Storage

1. Install the Atomic CLI

One command to download and install the latest Atomic CLI for your platform.

curl -sSf https://atomic.storage/install.sh | sh

2. Create and Register Your Identity with the Server

Now create your identity — Atomic uses Ed25519 keypairs for authentication, no passwords required.

atomic identity new alice --email alice@example.com

Registration creates a tenant for your identity. Your public key is stored server-side and used to authenticate future requests.

atomic identity register https://atomic.storage --identity alice

3. Create a Workspace & Project

Workspaces group related projects together. Each project maps to a single Atomic repository on the server. Use the Atomic CLI to create them.

atomic workspace create demos --description "Demo Workspace"

atomic project create hello-world --workspace demos

Looking to collaborate with others? See Getting started with teams in the Atomic documentation.

4. Clone & Initialize a Vault

atomic project create registered the project on the server. Clone it locally, then initialize a vault — the .vault/ directory holds skills, prompts, and memory used by AI agents.

atomic clone https://alice.atomic.storage/workspaces/demos/projects/hello-world/code
cd hello-world
atomic vault init

5. Record & Push Changes

Make changes, record them, then push to the server. Pull updates from collaborators with atomic pull.

echo 'fn main() { println!("Hello!"); }' > main.rs
atomic add .
atomic record -m "Initial record"
atomic push

6. What to Read Next

Keep going with the Atomic quickstart for the full CLI walkthrough, or jump to AI agent workflows to wire your vault into an agent.