honcho

name	honcho
description	AI-native cross-session user modeling — builds a persistent, growing model of who you are, your expertise, preferences, and working style across all Claude sessions.
version	1.0.0
author	hermes-CCC (ported from Hermes Agent by NousResearch)
license	MIT
metadata	{"hermes":{"tags":["User-Modeling","Memory","Cross-Session","Personalization","Honcho","Dialectic"],"related_skills":["hermes-memory","hermes-persona"],"homepage":"https://docs.honcho.dev"}}

Honcho — Cross-Session User Modeling

"The agent that grows with you." Honcho builds a persistent model of who you are across every session — your expertise, communication style, recurring topics, and working preferences.

Philosophy

Unlike simple memory (saving facts), Honcho models the user as a person — updating its understanding through dialectic reasoning: observing patterns, forming hypotheses about your preferences, and refining them over time.

This is the core of what makes Hermes Agent feel like it "knows" you.

---

hermes-CCC Implementation

In hermes-CCC, Honcho runs as a structured user profile in the memory system. Full Honcho (honcho.dev) adds a cloud backend with dialectic reasoning.

User Profile Structure

Profile stored at: ~/.claude/projects/*/memory/user_honcho_profile.md

---
name: honcho-user-profile
type: user
description: Cross-session user model built by Honcho
updated: 2026-04-07
---

## Identity
- Name: [inferred or stated]
- Role: [developer / researcher / executive / etc.]
- Timezone: [UTC+9 / Korea]
- Primary language: [Korean/English]

## Expertise
- Deep expertise: [Python, AI/ML, ontology design, business strategy]
- Intermediate: [Next.js, Neo4j, blockchain]
- Learning: [Rust, Solana]

## Communication Style
- Preferred verbosity: terse (skip explanations I know)
- Output format: code-first, then explanation
- Language mix: Korean for strategy, English for code
- Tone: direct, no fluff

## Working Patterns
- Session length: typically 2-4 hours
- Recurring projects: [OpenCrab SaaS, hermes-CCC, Ontology workspace]
- Tools always in use: [Claude Code, Discord, Obsidian, Neo4j, LM Studio]
- Peak hours: [evening KST]

## Recurring Interests
- Multi-agent systems and orchestration
- Knowledge graphs / ontology
- AI infrastructure (vLLM, GRPO training)
- SaaS monetization strategy

## Preferences
- Never explain basics I already know
- Always show full code, not snippets
- When blocked, say so immediately
- Prioritize speed over perfection on first pass
- Delegate heavy builds to Codex

## Session History Patterns
- Often starts: checking project status
- Common requests: code generation, architecture review, Discord automation
- Frequently uses: /hermes-route, /hermes-memory, codex:rescue

---

Commands

/honcho profile

Display the current user model. Claude reads the profile and summarizes key facts about how it understands you.

/honcho update

After a session, analyze what was discussed and update the profile:

1. New expertise demonstrated?
2. New tools or projects mentioned?
3. Communication preferences revealed?
4. New recurring topics?

Then write updates to user_honcho_profile.md.

/honcho calibrate

Run a quick 5-question calibration:

1. What's your primary role?
2. What are your strongest technical areas?
3. How do you prefer explanations? (terse/detailed)
4. What projects are you currently working on?
5. Any specific preferences for how I should behave?

/honcho reset

Clear the user model and start fresh.

/honcho export

Export profile as JSON for backup or transfer.

---

How Claude Uses the Profile

When Honcho profile is loaded, Claude should:

• Skip explanations of tools/concepts the user knows deeply
• Use preferred verbosity level in all responses
• Reference current projects when suggesting approaches
• Adapt language mix (Korean/English as preferred)
• Assume expertise level from profile when writing code
• Prioritize working patterns (e.g., "delegate to Codex")

---

Full Honcho Integration (Optional)

For cloud-backed dialectic reasoning:

pip install honcho-ai

from honcho import Honcho

honcho = Honcho(app_id="your-app-id", api_key="your-api-key")

# Create/get user session
user = honcho.apps.users.get_or_create(app_id="hermes-ccc", name="alexlee")
session = honcho.apps.users.sessions.create(app_id="hermes-ccc", user_id=user.id)

# Add observation
honcho.apps.users.sessions.messages.create(
    app_id="hermes-ccc",
    user_id=user.id,
    session_id=session.id,
    is_user=True,
    content="User prefers terse responses with code-first approach"
)

# Dialectic inference — Honcho reasons about the user
response = honcho.apps.users.sessions.chat(
    app_id="hermes-ccc",
    user_id=user.id,
    session_id=session.id,
    query="What communication style does this user prefer?"
)
print(response.content)

See docs.honcho.dev for full API reference.