# honcho-memory

The honcho-memory skill explains how a connected Honcho instance stores user context and feeds it back to an agent. It fits conversations that need continuity across sessions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 214 installs · ★ 8222 repo stars
- Author: plastic-labs
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/plastic-labs/honcho/tree/HEAD/skills/honcho-memory/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/honcho-memory

## What it does

honcho-memory lays out a working loop for Honcho memory: retrieve relevant context before a reply, produce the response, then save both sides of the exchange. Honcho reasons over recorded messages and builds a user representation that carries across sessions.

The skill covers peers, sessions, messages, conclusions, and representations. Use `get_representation`, `get_session_context`, or `search` for quick reads; use `chat` when a question needs a reasoned answer. Its reasoning level runs from `minimal` to `max`, while representation updates happen asynchronously.

Honcho must already be connected, and an API key beginning with `hch-` is required. For Claude Code, install the skill with the commands below; a raw MCP connection can use `https://mcp.honcho.dev`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill honcho-memory -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/honcho-memory/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/honcho-memory/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill honcho-memory -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/honcho-memory/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill honcho-memory -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/honcho-memory/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install plastic-labs/honcho skills/honcho-memory
```

2. **Manually: put the files in place**
- File: `.github/skills/honcho-memory/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill honcho-memory -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/plastic-labs/honcho --path skills/honcho-memory
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/honcho-memory/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add plastic-labs/honcho --skill honcho-memory -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/plastic-labs/honcho/tree/HEAD/skills/honcho-memory/SKILL.md

## When to use it
- retain user context across conversations
- retrieve preferences before generating a reply
- record both sides of each exchange
- keep separate conversation and project sessions
- ask Honcho for a reasoned user profile

## Example prompts
- Read the user’s current context with `get_session_context` before answering.
- Use the user representation to tailor this reply to prior preferences.
- After replying, record the user message and your response in Honcho.

## Similar
- [codex-honcho](https://affpapa.org/en/nevibecode/plugins/codex-honcho.md) — plugin · ★ 1596 repo stars
- [deep-agents-memory](https://affpapa.org/en/nevibecode/skills/deep-agents-memory.md) — skill · 20000 installs
- [memory-discipline](https://affpapa.org/en/nevibecode/skills/memory-discipline.md) — skill · 4900 installs
- [memory-md-management](https://affpapa.org/en/nevibecode/skills/memory-md-management.md) — skill · 3700 installs
- [parallel-memory](https://affpapa.org/en/nevibecode/skills/parallel-memory.md) — skill · 2900 installs
- [claude-memory-curator](https://affpapa.org/en/nevibecode/skills/claude-memory-curator.md) — skill · 2700 installs

From the same set: [plastic-labs/honcho](https://affpapa.org/en/nevibecode/by/plastic-labs/honcho.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
