pi-honcho-memory

Persistent memory extension for pi using Honcho.

Features

• Automatic memory injection — cached user profile and project summary injected into the system prompt with zero network latency
• Conversational persistence — user/assistant messages saved to Honcho after each agent response
• Flexible session strategies — choose repo, git-branch, or directory scoped memory
• LLM tools — honcho_search, honcho_chat, honcho_remember for active memory operations
• Commands — /honcho-status, /honcho-setup
• Graceful degradation — pi works normally if Honcho is unavailable

Install

pi install npm:pi-honcho-memory

Or try without installing:

pi -e npm:pi-honcho-memory

Setup

1. Get an API key from honcho.dev
2. Run /honcho-setup inside pi to configure interactively

Or set environment variables:

export HONCHO_API_KEY=hch-...

Honcho agent skills

Honcho already ships its own installable agent skills. Install those separately from this pi extension with:

npx skills add plastic-labs/honcho

Docs: https://docs.honcho.dev/v3/documentation/introduction/vibecoding#agent-skills

Configuration

Config is read from (highest priority first):

1. Environment variables: HONCHO_API_KEY, HONCHO_URL, HONCHO_WORKSPACE_ID, HONCHO_PEER_NAME, HONCHO_AI_PEER, HONCHO_SESSION_STRATEGY, HONCHO_ENABLED, HONCHO_CONTEXT_TOKENS, HONCHO_MAX_MESSAGE_LENGTH, HONCHO_SEARCH_LIMIT, HONCHO_TOOL_PREVIEW_LENGTH
2. Config file: ~/.honcho/config.json

HONCHO_SESSION_STRATEGY / hosts.pi.sessionStrategy supports:

• repo — share memory across git worktrees of the same repo
• git-branch — keep separate memory per branch
• directory — keep separate memory per working directory

Config file properties (~/.honcho/config.json):

| Prop | Environment variable | Description | Default | | ---------------------------- | ---------------------------- | ---------------------------------------------------------------------- | ------------------ | | apiKey | HONCHO_API_KEY | Honcho API key | none | | peerName | HONCHO_PEER_NAME | User peer name | $USER | | hosts.pi.workspace | HONCHO_WORKSPACE_ID | Honcho workspace ID | pi | | hosts.pi.aiPeer | HONCHO_AI_PEER | AI peer name | pi | | hosts.pi.endpoint | HONCHO_URL | Honcho API base URL | default Honcho API | | hosts.pi.sessionStrategy | HONCHO_SESSION_STRATEGY | Session scope for memory sharing | repo | | hosts.pi.contextTokens | HONCHO_CONTEXT_TOKENS | Token budget requested from Honcho for injected project memory | 1200 | | hosts.pi.maxMessageLength | HONCHO_MAX_MESSAGE_LENGTH | Maximum length of a synced user/assistant message before it is skipped | 8000 | | hosts.pi.searchLimit | HONCHO_SEARCH_LIMIT | Maximum number of search results returned by honcho_search | 8 | | hosts.pi.toolPreviewLength | HONCHO_TOOL_PREVIEW_LENGTH | Character preview length per search result returned by honcho_search | 500 |

All numeric options must be positive integers. Invalid values fall back to defaults.

Tools

| Tool | Description | | ----------------- | -------------------------------------------------------------- | | honcho_search | Search persistent memory for prior conversations and decisions | | honcho_chat | Ask Honcho to reason over memory for deeper questions | | honcho_remember | Save a durable fact, preference, or decision |

Commands

| Command | Description | | ---------------- | --------------------------------- | | /honcho-status | Show connection status and config | | /honcho-setup | Interactive configuration wizard |

Contributing

See CONTRIBUTING.md.

License

MIT