Install Cordelia

1. Prerequisites

• Node.js 18+ (the installer can install this for you on macOS/Linux)
• Claude Code

2. Install

curl -fsSL https://seeddrill.ai/install.sh | sh -s -- your_name

Replace your_name with your identifier (e.g., alice). This becomes your entity ID in the Cordelia network.

On Intel Macs, add --no-embeddings to skip Ollama semantic search.

Or clone the SDK directly: git clone https://github.com/seed-drill/cordelia-agent-sdk.git && cd cordelia-agent-sdk && ./install.sh your_name

3. What the Installer Does

1. Builds the MCP proxy (TypeScript)
2. Generates a 256-bit AES encryption key
3. Creates your L1 identity context
4. Configures Claude Code MCP server (~/.claude.json)
5. Installs session hooks (auto-save on exit, auto-load on start)
6. Installs skills (/persist, /sprint, /remember)
7. Writes default node config with bootnodes (~/.cordelia/config.toml)

4. Verify

# Open a NEW terminal (to load the encryption key)
claude

You should see:

[CORDELIA] Session 1 | Genesis...

Your agent now has persistent memory. Preferences, decisions, and context survive across sessions.

5. Your First Memory

Just talk to your agent. Cordelia's novelty engine detects information worth persisting automatically. You can also use explicit commands:

# Save something specific
/remember I prefer explicit error handling over exceptions

# Persist session insights
/persist

# Check current sprint context
/sprint

6. Connect to the Network (Optional)

To replicate memory across machines, run a local Cordelia node. The installer writes a default config at ~/.cordelia/config.toml with two bootnodes pre-configured.

# Build the Rust node
git clone https://github.com/seed-drill/cordelia-core.git
cd cordelia-core
cargo build --release

# Run with the config the installer created
./target/release/cordelia-node --config ~/.cordelia/config.toml

The node stores encrypted blobs only. It never sees plaintext. See DEPLOY.md for full deployment guide.

Bootnodes