memory-install - SKILL.md Agent Skill

name: memory-install description: | Wizard-style installation guide for agent-memory (macOS/Linux). Helps users choose an install path, check prerequisites, and set PATH. Always confirm before any file edits or copying binaries. Provide verification commands only. license: MIT metadata: version: 1.0.0 author: SpillwaveSolutions

Memory Install Skill

Install agent-memory with a guided, step-by-step wizard. Supports two install paths: source build or prebuilt binaries. This skill never runs verification commands automatically; it only provides them for the user to run if desired.

When to Use

User asks to install agent-memory
User wants to choose between source build and prebuilt binaries
User needs help adding binaries to PATH

When Not to Use

Configuration changes (use memory-configure)
Verifying an existing install (use memory-verify)
Troubleshooting failures (use memory-troubleshoot)

Wizard Principles

Ask one question at a time
Confirm before any write/copy/edit action
Provide verification commands but do not run them
macOS and Linux only

Wizard Flow

Step 1: Confirm platform

Agent Memory Install
====================

Which platform are you on?

1. macOS
2. Linux

Enter selection [1-2]:

If not macOS/Linux, stop and explain platform support.

Step 2: Prerequisites check

Ask whether these are installed:

protoc
Rust (only required for source builds)

Provide verification commands only:

Optional verify commands:
  protoc --version
  rustc --version

Step 3: Choose install path

How would you like to install agent-memory?

1. Build from source (requires Rust)
2. Prebuilt binaries (fastest)

Default: 1 if Rust is available, else 2

Enter selection [1-2]:

Step 4: Confirm install location

Where should the binaries live?

1. ~/.local/bin (recommended)
2. ~/.cargo/bin
3. /usr/local/bin (requires sudo)
4. Other path

Default: 1

Enter selection [1-4]:

Step 5: Execute installation (with confirmation)

Before making changes, ask for confirmation:

I will:
  - Create the install directory (if needed)
  - Copy or unpack memory-daemon and memory-ingest
  - Set executable permissions

Proceed? (yes/no)

Provide commands based on choice:

Source build

git clone https://github.com/SpillwaveSolutions/agent-memory.git
cd agent-memory
cargo build --release
mkdir -p ~/.local/bin
cp target/release/memory-daemon ~/.local/bin/
cp target/release/memory-ingest ~/.local/bin/

Prebuilt binaries

mkdir -p ~/.local/bin
PLATFORM=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m)
curl -L "https://github.com/SpillwaveSolutions/agent-memory/releases/latest/download/memory-daemon-${PLATFORM}-${ARCH}.tar.gz" | tar xz -C ~/.local/bin
curl -L "https://github.com/SpillwaveSolutions/agent-memory/releases/latest/download/memory-ingest-${PLATFORM}-${ARCH}.tar.gz" | tar xz -C ~/.local/bin
chmod +x ~/.local/bin/memory-daemon ~/.local/bin/memory-ingest

Step 6: PATH guidance

Ask before editing shell profiles. If the user wants automation, confirm the specific file before any edit.

I can add ~/.local/bin to your PATH in your shell profile.
Which file should I edit?

1. ~/.zshrc
2. ~/.bashrc
3. ~/.bash_profile
4. Skip (show command only)

Enter selection [1-4]:

If user chooses to edit, confirm again:

I will add:
  export PATH="$HOME/.local/bin:$PATH"

Proceed? (yes/no)

Step 7: Verification commands (optional)

Provide commands only:

Optional verify commands:
  memory-daemon --version
  memory-ingest --version

Step 8: Next steps

Guide users to configuration and agent setup:

Use memory-configure for config
Use memory-verify for health checks
Use the agent-specific setup guide for hooks