honcho

Honcho Plugins for Claude Code

A plugin marketplace for Claude Code, powered by Honcho from Plastic Labs.

Plugins

Plugin	Description
honcho	Persistent memory for Claude Code sessions
honcho-dev	Skills for building AI apps with the Honcho SDK

---

Installation

Add the marketplace to Claude Code:

/plugin marketplace add plastic-labs/claude-honcho

Then install the plugin(s) you want:

/plugin install honcho@honcho
/plugin install honcho-dev@honcho

You'll need to restart Claude Code for the plugins to take effect. Follow the instructions below for setting up each plugin.

---

honcho Plugin

Persistent memory for Claude Code using Honcho.

Give Claude Code long-term memory that survives context wipes, session restarts, and even ctrl+c. Claude remembers what you're working on, your preferences, and what it was doing — across all your projects.

Prerequisites

Bun is required to run this plugin. Install it with:

curl -fsSL https://bun.sh/install | bash

Quick Start

Step 1: Get Your Honcho API Key

1. Go to app.honcho.dev
2. Sign up or log in
3. Copy your API key (starts with hch-)

Step 2: Set Environment Variables

macOS / Linux -- add these to your shell config (~/.zshrc, ~/.bashrc, or ~/.profile):

# Required
export HONCHO_API_KEY="hch-your-api-key-here"

# Optional (defaults shown)
export HONCHO_PEER_NAME="$USER"           # Your name/identity
export HONCHO_WORKSPACE="claude_code"     # Workspace name

Then reload your shell:

source ~/.zshrc  # or ~/.bashrc

Windows (PowerShell) -- set a persistent user environment variable:

# Required
[Environment]::SetEnvironmentVariable("HONCHO_API_KEY", "hch-your-api-key-here", "User")

# Optional
[Environment]::SetEnvironmentVariable("HONCHO_PEER_NAME", $env:USERNAME, "User")
[Environment]::SetEnvironmentVariable("HONCHO_WORKSPACE", "claude_code", "User")

Then restart your terminal so the new variables take effect.

Step 3: Install the Plugin

/plugin marketplace add plastic-labs/claude-honcho
/plugin install honcho@honcho

Step 4: Restart Claude Code

# Exit Claude Code (ctrl+c or /exit)
# Start it again -- you should see the Honcho pixel art and memory loading on startup.
claude

Step 5: (Optional) Kick off your conversation with an interview

/honcho:interview

Claude will interview you about your personal preferences in order to kickstart a representation of you. What it learns will be saved in Honcho and remembered forever. The interview is specific to the peer name you chose in your environment: it will carry across different projects!

Step 6: (Recommended) Configure Your CLAUDE.md

Tell Claude how to use its memory by adding directives to your personal ~/.claude/CLAUDE.md (not a project-level CLAUDE.md). We use the personal file because Honcho is about you — your preferences and memory follow you across every project, not just one repo. A project-level CLAUDE.md would only apply when working in that specific directory.

Paste this into Claude Code:

Read your ~/.claude/CLAUDE.md (create it if it doesn't exist). Add the following directives, keeping any existing content:

# Honcho Memory

You have persistent memory via Honcho. Context about me, my preferences,
and our past work is loaded automatically at the start of every session.

## How to use it:
- Trust the Honcho context injected at session start. It contains what you
  know about me — act on it. Do not ignore it or ask me things you already know.
- Use `chat` or `search` mid-conversation when you need context beyond what
  was loaded at startup.
- Use `create_conclusion` to save new insights as you learn them: my preferences,
  decisions, patterns I like, things I've asked you not to do.
- I should never have to repeat myself. If I've told you something before,
  you should already know it.

## Honcho Integration for Projects
- When working on a Python or TypeScript project that involves AI agents or
  LLM chat but lacks persistent memory, use the `/honcho-integration` skill
  to add Honcho. Don't wait to be asked — suggest it early.

Save the file.