### Mnemon Bootstrap Installation

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/harness/SYSTEM_FLOW.md

Commands to install Mnemon and start the daemon, binding loop templates to the host.

```bash
mnemon harness install --host codex --loop memory --loop skill --loop eval
mnemon daemon start
```

--------------------------------

### Install Command

Source: https://github.com/mnemon-dev/mnemon/blob/master/CLAUDE.md

Commands to install Mnemon and set up its environment.

```bash
make install && mnemon setup
```

--------------------------------

### Install Mnemon from source

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Clone the repository and install Mnemon from source.

```bash
git clone https://github.com/mnemon-dev/mnemon.git && cd mnemon
make install
```

--------------------------------

### Install steps

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/site/harness-ui/index.html

Steps to install a binding, involving running an install script, selecting an ops entrypoint, copying loop assets, writing host-readable surfaces, and writing status and manifest files.

```javascript
installSteps: (ctx) => [
    `Run bash harness/ops/install.sh --host ${ctx.host} --loop ${ctx.loop}`,
    `The ops entrypoint selects harness/hosts/${ctx.host}/projector.sh`,
    `The projector copies GUIDE, env, loop.json, and loop assets from harness/loops/${ctx.loop}/`,
    `The projector writes host-readable surfaces under ${ctx.projectionPath}`,
    `The projector writes .mnemon/harness/${ctx.loop}/status.json and .mnemon/hosts/${ctx.host}/manifest.json`
  ]
```

--------------------------------

### Install Mnemon using Go install

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Install Mnemon using the Go toolchain.

```bash
go install github.com/mnemon-dev/mnemon@latest
```

--------------------------------

### Common Development Commands

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/DEPLOYMENT.md

A list of common make commands for local development, including dependency installation, building, testing, and installation.

```bash
make deps
make build
make unit
make test
make install
```

--------------------------------

### Start Shell Inside Go Development Container

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/DEPLOYMENT.md

Command to start a shell session within the Go development container.

```bash
make compose-dev
```

--------------------------------

### Query Examples

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/memory/skills/memory_get.md

Examples of how to use the mnemon recall command with different parameters.

```bash
mnemon recall "project memory loop guide skill dreaming architecture" --limit 5
```

```bash
mnemon recall "user preference concise Chinese replies commit push workflow" --cat preference --limit 5
```

```bash
mnemon recall "deployment brew install mnemon setup store issue" --intent ENTITY --limit 5
```

--------------------------------

### Usage Examples

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/ops/README.md

Examples of using the shared entrypoints for new integrations.

```bash
bash harness/ops/install.sh --host claude-code --loop memory
bash harness/ops/status.sh --host claude-code
bash harness/ops/uninstall.sh --host claude-code --loop memory
bash harness/ops/install.sh --host codex --loop memory
bash harness/ops/install.sh --host codex --loop eval

```

--------------------------------

### Create Local Environment File

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/DEPLOYMENT.md

Command to copy the example environment file to create a local .env file for container development.

```bash
cp .env.example .env
```

--------------------------------

### Bootstrap Process

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/site/system-flow/index.html

Describes the initial setup and bootstrapping process of the Mnemon system, starting from installation to the daemon startup.

```bash
mnemon install / project | +--> create .mnemon canonical state +--> bind memory / skill / eval loops to host +--> render .codex / .claude projections +--> start mnemon-daemon
```

--------------------------------

### Runtime Directory Protocol Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/skill/README.md

The structure of the installed runtime files and environment configuration variables.

```text
$MNEMON_SKILL_LOOP_DIR/
├── env.sh
├── GUIDE.md
├── skills/
│   ├── active/
│   ├── stale/
│   ├── archived/
│   └── .usage.jsonl
└── proposals/
```

--------------------------------

### Example usage log

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/skill/skills/skill_observe.md

This example shows the format of a JSON object that can be appended to the usage log file.

```json
{"time":"2026-05-14T10:00:00Z","skill":"release-checklist","event":"helped","outcome":"positive","note":"Reusable release verification checklist matched the current task.","source":"agent"}
```

--------------------------------

### Install Loop

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/eval/scenarios/ops/host-projection-smoke.md

Installs the loop into the target host.

```bash
harness/ops/install.sh
```

--------------------------------

### Optional Embeddings Setup with Docker Compose

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/DEPLOYMENT.md

Commands to enable and configure Ollama-backed vector search within the Docker Compose environment.

```bash
docker compose --profile embeddings up -d ollama
docker compose exec ollama ollama pull nomic-embed-text
docker compose run --rm mnemon embed "hello"
```

--------------------------------

### Development Setup

Source: https://github.com/mnemon-dev/mnemon/blob/master/CONTRIBUTING.md

Commands to clone the repository and build the project.

```bash
git clone https://github.com/mnemon-dev/mnemon.git
cd mnemon
make build
```

--------------------------------

### Verify Mnemon installation

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Check the installed Mnemon version.

```bash
mnemon --version
```

--------------------------------

### GC Command Examples

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/design/06-lifecycle.md

Command-line examples for managing Mnemon's lifecycle, including viewing low-retention candidates and retaining specific insights.

```bash
# View low-retention candidates
mnemon gc --threshold 0.5

# Retain a specific insight (increases access_count by +3)
mnemon gc --keep <id>
```

--------------------------------

### Setup Commands

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/zh/USAGE.md

Commands for setting up Mnemon in a LLM CLI environment.

```bash
# Interactive: Detect environment and install (project local)
mnemon setup

# User-level installation (all projects)
mnemon setup --global

# Non-interactive: Specify target only
mnemon setup --target claude-code
mnemon setup --target openclaw

# Auto-confirm all prompts (CI friendly)
mnemon setup --yes

# Remove mnemon integration
mnemon setup --eject
mnemon setup --eject --target claude-code
```

--------------------------------

### Nanobot Setup

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Command to set up Mnemon with Nanobot, enabling global memory sharing.

```bash
mnemon setup --target nanobot --global --yes
```

--------------------------------

### Install Mnemon using Homebrew

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Install Mnemon on macOS or Linux using the Homebrew package manager.

```bash
brew install mnemon-dev/tap/mnemon
```

--------------------------------

### User Session Start

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/harness/SYSTEM_FLOW.md

Flowchart illustrating the initial steps when a host agent starts and the user session begins, including Prime's role.

```text
HostAgent session starts
        |
        v
prime hook reads projected env and surfaces
        |
        v
HostAgent sees GUIDE, hot memory, active skills, and protocols
```

--------------------------------

### Write Pipeline: Remember Command Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/design/05-pipelines.md

Example of the `mnemon remember` command with arguments for category, importance, and entities.

```bash
mnemon remember "Chose Qdrant as the vector database" \
  --cat decision --imp 5 --entities "Qdrant,Milvus"
```

--------------------------------

### Setup Mnemon for Codex

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Deploy Mnemon for Codex with automatic confirmation.

```bash
mnemon setup --target codex --yes
```

--------------------------------

### Setup Mnemon for OpenClaw

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Deploy Mnemon for OpenClaw with automatic confirmation.

```bash
mnemon setup --target openclaw --yes
```

--------------------------------

### Recall command examples

Source: https://github.com/mnemon-dev/mnemon/blob/master/internal/setup/assets/nanoclaw/container-skill.md

Examples of how to use the `mnemon recall` command to query private and global memory stores.

```bash
mnemon recall "<query>" --limit 5
# Also check shared knowledge:
mnemon recall "<query>" --store global --readonly --limit 5
```

--------------------------------

### Setup Mnemon for Claude Code

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Automatically detect and deploy Mnemon for Claude Code.

```bash
mnemon setup
```

--------------------------------

### Manifest Schema Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/harness/LOOP_STANDARD.md

Example of a loop.json file, defining the stable shape for a loop template manifest.

```json
{
  "schema_version": 2,
  "name": "memory",
  "version": "0.1.0",
  "description": "Connects prompt-facing working memory with Mnemon long-term memory.",
  "control_model": {
    "state": ["MEMORY.md", ".mnemon stores", "reports", "memory status"],
    "intent": "Keep useful continuity available across lifecycle boundaries.",
    "reality": ["host prompt", "current task", "recall results", "context pressure"],
    "reconcile": ["read", "write", "compact", "consolidate", "no-op"]
  },
  "entity_profiles": {
    "template": "memory",
    "controlled": ["memory binding"],
    "surface": ["MEMORY.md", "Mnemon recall/write", "host hooks", "protocol skills"],
    "evidence": ["recall usefulness", "write results", "context pressure"],
    "governance": ["memory proposals", "memory audits"]
  },
  "surfaces": {
    "projection": ["GUIDE.md", "hooks", "memory_get", "memory_set", "dreaming", "runtime env"],
    "observation": ["hook output", "MEMORY.md length", "recall results", "write outcomes"]
  },
  "lifecycle_events": ["prime", "remind", "nudge", "compact"],
  "assets": {
    "guide": "GUIDE.md",
    "env": "env.sh",
    "hooks": {
      "prime": "hooks/prime.md",
      "remind": "hooks/remind.md",
      "nudge": "hooks/nudge.md",
      "compact": "hooks/compact.md"
    },
    "skills": ["skills/memory_get.md", "skills/memory_set.md"],
    "subagents": ["subagents/dreaming.md"]
  },
  "state": {
    "canonical": [".mnemon/data", ".mnemon/reports", ".mnemon/proposals", ".mnemon/audit"],
    "loop_runtime": []
  },
  "host_adapters": {
    "claude-code": "../../hosts/claude-code"
  }
}
```

--------------------------------

### Composable Module Flow Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/harness/modular-agent/DESIGN.md

An example illustrating the flow of a composable module in a harness loop, showing the sequence of proposals and actions between different loops.

```text
Skill Loop produces a skill proposal
  -> Risk Loop scans the proposal
  -> Review Loop requests approval
  -> Audit Loop records the decision
  -> Skill Loop applies the approved change
```

--------------------------------

### Development Commands

Source: https://github.com/mnemon-dev/mnemon/blob/master/README.md

Common make targets for building, installing, testing, and setting up the Mnemon project.

```bash
make build          # build binary
make install        # build + install to $GOBIN
make test           # run E2E test suite
mnemon setup        # interactive setup
mnemon setup --eject  # remove all integrations
make help           # show all targets
```

--------------------------------

### Recall Command

Source: https://github.com/mnemon-dev/mnemon/blob/master/internal/setup/assets/nanobot/SKILL.md

Example of the 'recall' command.

```bash
mnemon recall "<query>" --limit 10
```

--------------------------------

### Remember Command

Source: https://github.com/mnemon-dev/mnemon/blob/master/internal/setup/assets/nanobot/SKILL.md

Example of the 'remember' command with various options.

```bash
mnemon remember "<fact>" --cat <cat> --imp <1-5> --entities "e1,e2" --source agent
```

--------------------------------

### Write Pipeline: JSON Output Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/design/05-pipelines.md

Example JSON output from the write pipeline, showing the action taken, replaced ID, created edges, candidate suggestions, and importance metrics.

```json
{
  "id": "abc-123",
  "action": "added",
  "diff_suggestion": "ADD",
  "replaced_id": null,
  "edges_created": {"temporal": 2, "entity": 3, "causal": 1, "semantic": 1},
  "semantic_candidates": [
    {"id": "def-456", "content": "...", "cosine": 0.72, "auto_linked": false}
  ],
  "causal_candidates": [
    {"id": "ghi-789", "content": "...", "hop": 1, "suggested_sub_type": "causes"}
  ],
  "embedded": true,
  "effective_importance": 0.85,
  "auto_pruned": 0
}
```

--------------------------------

### Link Command

Source: https://github.com/mnemon-dev/mnemon/blob/master/internal/setup/assets/nanobot/SKILL.md

Example of the 'link' command with type and weight options.

```bash
mnemon link <id> <candidate> --type <causal|semantic> --weight <0-1> [--meta '<json>']
```

--------------------------------

### Install mnemon in container image

Source: https://github.com/mnemon-dev/mnemon/blob/master/internal/setup/assets/nanoclaw/SKILL.md

Adds mnemon installation to the Dockerfile for the container image.

```dockerfile
# Install mnemon for persistent agent memory
ARG MNEMON_VERSION=0.1.1
RUN ARCH=$(dpkg --print-architecture) && \
    curl -fsSL "https://github.com/mnemon-dev/mnemon/releases/download/v${MNEMON_VERSION}/mnemon_${MNEMON_VERSION}_linux_${ARCH}.tar.gz" \
    | tar -xz -C /usr/local/bin mnemon && \
    chmod +x /usr/local/bin/mnemon
```

--------------------------------

### Setup Commands

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/USAGE.md

Commands for deploying Mnemon into LLM CLI environments, including interactive, user-wide, non-interactive, and removal options.

```bash
# Interactive: detect environments and install (project-local)
mnemon setup

# User-wide install (all projects)
mnemon setup --global

# Non-interactive: specific target only
mnemon setup --target claude-code
mnemon setup --target openclaw
mnemon setup --target nanobot --global

# Auto-confirm all prompts (CI-friendly)
mnemon setup --yes

# Remove mnemon integrations
mnemon setup --eject
mnemon setup --eject --target claude-code
```

--------------------------------

### Event Substrate Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/harness/LIFECYCLE_RUNTIME.md

An example JSON structure for a lifecycle event.

```json
{
  "id": "evt_...",
  "ts": "2026-05-23T00:00:00Z",
  "type": "memory.dreaming_requested",
  "loop": "memory",
  "host": "codex",
  "actor": "mnemon-daemon",
  "caused_by": "evt_...",
  "correlation_id": "job_...",
  "payload": {}
}
```

--------------------------------

### Build Runtime Docker Image

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/DEPLOYMENT.md

Command to build the Docker image for runtime deployment.

```bash
make docker-build
```

--------------------------------

### Conventional Commits Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/CONTRIBUTING.md

Examples of commit messages following the conventional commits style.

```bash
Add intent override flag to recall command
Fix panic in link command with short IDs
Update USAGE.md with missing recall flags
```

--------------------------------

### Embedding Vector Support Installation

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/zh/USAGE.md

Commands for installing Ollama and downloading embedding models.

```bash
brew install ollama              # Or see https://ollama.ai
ollama pull nomic-embed-text     # Download embedding model
```

--------------------------------

### Claude Code Global Install

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/memory/README.md

Command to install the memory loop globally for Claude Code.

```bash
bash harness/ops/install.sh --host claude-code --loop memory --global
```

--------------------------------

### Claude Code Install

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/memory/README.md

Command to install the memory loop into the current project for Claude Code.

```bash
bash harness/ops/install.sh --host claude-code --loop memory
```

--------------------------------

### Runtime Directory Protocol Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/memory/README.md

Environment configuration file and environment variables for the runtime directory protocol.

```bash
$MNEMON_MEMORY_LOOP_DIR/
├── env.sh
├── GUIDE.md
└── MEMORY.md
```

```bash
MNEMON_MEMORY_LOOP_ENV=<canonical-state>/harness/memory/env.sh
MNEMON_MEMORY_LOOP_DIR=<canonical-state>/harness/memory
MNEMON_MEMORY_LOOP_MAX_NON_EMPTY_LINES=200
```

--------------------------------

### Codex Install Command

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/eval/README.md

Command to install the Codex integration into the current project for the eval loop.

```bash
bash harness/ops/install.sh --host codex --loop eval

```

--------------------------------

### Signal Transparency JSON Example

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/design/05-pipelines.md

Example JSON structure showing the breakdown of retrieval signals for a result.

```json
{
  "insight": {"id": "...", "content": "..."},
  "score": 0.73,
  "intent": "ENTITY",
  "via": "keyword",
  "signals": {
    "keyword": 0.85,
    "entity": 0.60,
    "similarity": 0.72,
    "graph": 0.45
  }
}
```

--------------------------------

### Manual Local Testing with Project-Local Data Directory

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/DEPLOYMENT.md

Commands to set up and interact with Mnemon using a local data directory for manual testing.

```bash
MNEMON_DATA_DIR=.mnemon-dev ./mnemon store create default
MNEMON_DATA_DIR=.mnemon-dev ./mnemon remember --no-diff "Local development memory" --cat fact --imp 3
MNEMON_DATA_DIR=.mnemon-dev ./mnemon recall "development memory"
```

--------------------------------

### Install Ollama and download embedding model

Source: https://github.com/mnemon-dev/mnemon/blob/master/docs/USAGE.md

Commands to install Ollama via Homebrew and download the 'nomic-embed-text' embedding model.

```bash
brew install ollama              # or see https://ollama.ai
ollama pull nomic-embed-text     # download the embedding model
```

--------------------------------

### All Commands

Source: https://github.com/mnemon-dev/mnemon/blob/master/internal/setup/assets/nanobot/SKILL.md

A comprehensive list of available mnemon commands.

```bash
mnemon remember "<fact>" --cat <cat> --imp <1-5> --entities "e1,e2" --source agent
mnemon link <id1> <id2> --type <type> --weight <0-1> [--meta '<json>']
mnemon recall "<query>" --limit 10
mnemon search "<query>" --limit 10
mnemon forget <id>
mnemon related <id> --edge causal
mnemon gc --threshold 0.4
mnemon gc --keep <id>
mnemon status
mnemon log
mnemon store list
mnemon store create <name>
mnemon store set <name>
mnemon store remove <name>
```

--------------------------------

### Claude Code Global Install Command

Source: https://github.com/mnemon-dev/mnemon/blob/master/harness/loops/skill/README.md

Command to install the Mnemon skill loop integration for Claude Code globally.

```bash
bash harness/ops/install.sh --host claude-code --loop skill --global
```