ensue-auto-memory

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# Ensue Auto-Memory

Automatic persistent memory for Claude Code sessions. Remembers your preferences, corrections, and project context across sessions.

## Features

- **Automatic retrieval**: Your context is loaded at session start
- **Pattern detection**: Preferences and corrections are detected and saved automatically
- **Project awareness**: Project-specific context is loaded based on your working directory
- **Invisible operation**: Works in the background without manual commands

## Quick Start

### 1. Set Environment Variables

Add to your shell profile (`~/.zshrc`, `~/.bashrc`, etc.):

```bash
export ENSUE_API_KEY="your-api-key-here"
export ENSUE_USERNAME="your-username"
```

Get a free API key at https://www.ensue-network.ai/dashboard so memories are saved to your own (private) network.

Alternatively, use a Guest API key:

```bash
export ENSUE_API_KEY="lmn_af9e0d32ae044e5faf084d957da9b60b"
export ENSUE_USERNAME="your-username"
```

### 2. Start Claude Code

```bash
claude
```

### 3. Install the Plugin

```bash
/plugin marketplace add https://github.com/christinetyip/ensue-auto-memory
```

```bash
/plugin install ensue-auto-memory
```

And restart Claude to load the new plugins.

## How It Works

### At Session Start

While you're using Claude Code, the plugin automatically saves and loads:
- Your identity (name, role, etc.)
- Your preferences (code style, tools, workflows)
- Your corrections (things you've told Claude NOT to do)
- Project-specific context (based on current directory)

### During Sessions

When you express preferences or make corrections, they're automatically saved:

```
You: "I prefer early returns over nested conditionals"
→ Saved to @yourname/preferences/code-style

You: "No, don't add emojis to commit messages"
→ Saved to @yourname/corrections/no-emojis

You: "We're using JWT for authentication in this project"
→ Saved to @yourname/projects/my-api/auth
```

### At Session End

A final check ensures any significant learnings are saved before the session ends.

## Memory Categories

| Category | What's Stored | Example Key |
|----------|---------------|-------------|
| `identity/` | Name, role, company, timezone | `@you/identity/role` |
| `preferences/` | Code style, tools, workflows | `@you/preferences/testing` |
| `corrections/` | Things NOT to do | `@you/corrections/no-emojis` |
| `projects/{name}/` | Project-specific context | `@you/projects/api/stack` |

## Configuration

Optional environment variables to customize behavior:

| Variable | Default | Description |
|----------|---------|-------------|
| `ENSUE_RELEVANCY_THRESHOLD` | `0.7` | Minimum score for discovered memories (0-1) |
| `ENSUE_PROJECT_LIMIT` | `5` | Max project memories to load (can be increased for long-running tasks) |
| `ENSUE_PREFERENCES_LIMIT` | `10` | Max preferences to load |
| `ENSUE_CORRECTIONS_LIMIT` | `5` | Max corrections to load |


## Privacy & Security

- Memories are stored on your own Ensue network if you create a new API key at https://www.ensue-network.ai/dashboard
- Memories are stored on a public Ensue network if you use the Guest API key
- Only you and anyone you grant access to can access the memories on your network (set permissions in the dashboard)
- API keys are never logged or exposed
- Don't store credentials or secrets in memories

## Troubleshooting

### Memories not loading?

1. Verify environment variables are set:
   ```bash
   echo $ENSUE_API_KEY
   echo $ENSUE_USERNAME
   ```

2. Check plugin is installed:
   ```bash
   /plugin
   ```

3. Restart Claude Code after setting environment variables

## Links

- [Ensue Dashboard](https://www.ensue-network.ai/dashboard)
- [Ensue Documentation](https://www.ensue-network.ai/docs)
- [Ensue Homepage](https://ensue.dev)

Ensue Auto-Memory

Automatic persistent memory for Claude Code sessions. Remembers your preferences, corrections, and project context across sessions.

Features

Automatic retrieval: Your context is loaded at session start
Pattern detection: Preferences and corrections are detected and saved automatically
Project awareness: Project-specific context is loaded based on your working directory
Invisible operation: Works in the background without manual commands

Quick Start

1. Set Environment Variables

Add to your shell profile (~/.zshrc, ~/.bashrc, etc.):

export ENSUE_API_KEY="your-api-key-here"
export ENSUE_USERNAME="your-username"

Get a free API key at https://www.ensue-network.ai/dashboard so memories are saved to your own (private) network.

Alternatively, use a Guest API key:

export ENSUE_API_KEY="lmn_af9e0d32ae044e5faf084d957da9b60b"
export ENSUE_USERNAME="your-username"

2. Start Claude Code

claude

3. Install the Plugin

/plugin marketplace add https://github.com/christinetyip/ensue-auto-memory

/plugin install ensue-auto-memory

And restart Claude to load the new plugins.

How It Works

At Session Start

While you're using Claude Code, the plugin automatically saves and loads:

Your identity (name, role, etc.)
Your preferences (code style, tools, workflows)
Your corrections (things you've told Claude NOT to do)
Project-specific context (based on current directory)

During Sessions

When you express preferences or make corrections, they're automatically saved:

You: "I prefer early returns over nested conditionals"
→ Saved to @yourname/preferences/code-style

You: "No, don't add emojis to commit messages"
→ Saved to @yourname/corrections/no-emojis

You: "We're using JWT for authentication in this project"
→ Saved to @yourname/projects/my-api/auth

At Session End

A final check ensures any significant learnings are saved before the session ends.

Memory Categories

Category	What's Stored	Example Key
`identity/`	Name, role, company, timezone	`@you/identity/role`
`preferences/`	Code style, tools, workflows	`@you/preferences/testing`
`corrections/`	Things NOT to do	`@you/corrections/no-emojis`
`projects/{name}/`	Project-specific context	`@you/projects/api/stack`

Configuration

Optional environment variables to customize behavior:

Variable	Default	Description
`ENSUE_RELEVANCY_THRESHOLD`	`0.7`	Minimum score for discovered memories (0-1)
`ENSUE_PROJECT_LIMIT`	`5`	Max project memories to load (can be increased for long-running tasks)
`ENSUE_PREFERENCES_LIMIT`	`10`	Max preferences to load
`ENSUE_CORRECTIONS_LIMIT`	`5`	Max corrections to load

Privacy & Security

Memories are stored on your own Ensue network if you create a new API key at https://www.ensue-network.ai/dashboard
Memories are stored on a public Ensue network if you use the Guest API key
Only you and anyone you grant access to can access the memories on your network (set permissions in the dashboard)
API keys are never logged or exposed
Don't store credentials or secrets in memories

Troubleshooting

Memories not loading?

Verify environment variables are set:

echo $ENSUE_API_KEY
echo $ENSUE_USERNAME

Check plugin is installed:
```
/plugin
```
Restart Claude Code after setting environment variables