# Honcho Memory

Concepts and strategy for using a connected Honcho as persistent memory of the user, ...

- Repository: https://github.com/plastic-labs/honcho (7877 stars)
- Category: Design
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add plastic-labs/honcho --skill honcho-memory -g -a claude-code -y`
Codex: `npx skills add plastic-labs/honcho --skill honcho-memory -g -a codex -y`
Cursor: `npx skills add plastic-labs/honcho --skill honcho-memory -g -a cursor -y`
Gemini CLI: `npx skills add plastic-labs/honcho --skill honcho-memory -g -a gemini-cli -y`

## Description

Concepts and strategy for using a connected Honcho as persistent memory of the user, the recall/record loop and session and peer design. Start here to understand how Honcho memory works, then connect, via a first-class integration for your environment if one exists (preferred), or raw MCP tools (covered here) or the honcho-cli skill (CLI). For embedding the SDK into a codebase, use honcho-integration.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Using Honcho as Memory

Honcho is a memory layer for agents. You feed it the messages from your conversations; in the background it reasons over them and builds a **representation** of each participant. At any point you can ask it natural-language questions about the user ("How technical are they?", "What are they trying to do?") and get grounded, reasoned answers.

This skill is for when Honcho is **already connected** to you and you want to use it. If you're instead adding Honcho to a codebase from scratch, use the `honcho-integration` skill.

> **What's durable vs. what to look up.** The concepts and the recall/record loop below change rarely, rely on them. Specifics that change often, the exact set of integrations, tool names, install commands, headers, and defaults, are illustrative here; treat the linked docs (and your own live tool list) as authoritative and fetch them when the details matter.

## The mental model

The rest: https://github.com/plastic-labs/honcho/blob/HEAD/skills/honcho-memory/SKILL.md