# Install Cordelia

> Install Cordelia: keep Claude Code's memory in step across your machines, end-to-end encrypted.

Source: https://seeddrill.ai/install

# Install Cordelia

Keep Claude Code's memory in step across your machines, end-to-end encrypted. Cordelia runs as a small background service on each machine.

## Pre-release

`v0.2.0-alpha.3` is the current pre-release (October 2026), and two relays are running. It is an alpha: expect rough edges, and keep your own copy of anything you cannot afford to lose.

## 1a. Install

```
curl -fsSL https://seeddrill.ai/install.sh | CORDELIA_VERSION=v0.2.0-alpha.3 sh
```

macOS (Apple silicon and Intel) and Linux (x86\_64 and arm64). The script checks the download's checksum, installs `cordelia` to `~/.cordelia/bin`, sets it up as a background service (launchd or systemd), and runs `cordelia init`. Pre-releases are installed only when pinned, as above. Running it again upgrades.

## 1b. Or build from source

```
git clone https://github.com/seed-drill/cordelia-node.git
cd cordelia-node
cargo build --release          # Rust toolchain pinned in rust-toolchain.toml
./target/release/cordelia init
./target/release/cordelia start
```

## 2\. Pair your machines

One key copied in each direction, so each machine has been told by you which key is the other's.

```
laptop$  cordelia id
         # prints cordelia_pk1...
desktop$ cordelia add-device cordelia_pk1... --name laptop
         # On the other device, run: cordelia accept cordelia_pk1...
laptop$  cordelia accept cordelia_pk1...
```

## 3\. Say what to sync

On each machine, turn sync on and map the folders you want. Nothing syncs until you map it.

```
cordelia sync claude                  # on: lists what it found, syncs nothing yet
cordelia sync map ~/Work/my-project   # a git project, named by its remote
cordelia sync map ~/notes lab-notes   # any other folder, under a name you choose
cordelia sync map ~ --home            # home memory
cordelia sync status                  # what syncs, what was found, what your other devices sync
```

The name is what your devices share: map the same name on each machine and Claude's memory for it stays in step. A git project is named by its remote, so the same clone at different paths needs no name. A machine that has never mapped a name holds neither its memory nor its key.

To sync everything Claude Code has memory for instead (home memory and every git project found), use `cordelia sync claude --all`.

## 4\. See it at a glance

**Claude Code.** Add a status line to `~/.claude/settings.json`. It shows `● memory synced`, `◐ memory sending 3`, or `▲ memory: 1 conflict`.

```
{ "statusLine": { "type": "command", "command": "~/.cordelia/bin/cordelia status --line" } }
```

**Omarchy.** The [Cordelia panel](https://github.com/seed-drill/omarchy-cordelia) puts an icon in the bar that says whether memory is in step, and opens a panel to turn sync on and off, choose what syncs, pair devices and open conflicts.

```
omarchy plugin add https://github.com/seed-drill/omarchy-cordelia.git --enable
```

For Waybar and other bars, `cordelia status --waybar` prints an icon, a tooltip and a state class as JSON. For scripts and agents, `cordelia status --json` has everything.

## Everyday commands

Command

What it does

`cordelia status`

This device, its relays and whether memory is in step

`cordelia sync status`

What syncs, what was found, and what your other devices sync

`cordelia sync unmap <folder or name>`

Stop syncing a folder from this machine; its files stay

`cordelia devices`

List your devices

`cordelia invites`

Invites waiting for `accept`

`cordelia remove-device <key>`

Remove a lost or old device everywhere, and rotate the keys it held

`cordelia sync off`

Stop syncing; files already synced stay where they are

## Relays

Your node connects to these by default. They store and forward ciphertext only, and hold no keys.

Relay

Address

Status

relay1

`relay1.cordelia.seeddrill.ai:9474`

Running

relay2

`relay2.cordelia.seeddrill.ai:9474`

Running

QUIC over UDP port 9474. Your node only dials out and opens no listening port, so it works behind home routers and firewalls, and nothing on a network you join can connect to it.

## What stays on your machine

Your device key and your channels' keys live in `~/.cordelia`, readable only by you, and never leave the machine. Claude Code's memory files stay plain files on your disk, exactly as they are without Cordelia. Keep that disk as safe as you would keep the memory itself.