---
title: "Agentic Development"
icon: "wand-magic-sparkles"
description: "Let your coding agent help you integrate Honcho"
sidebarTitle: "Agentic Development"
keywords: ['vibecoding', 'vibe coding', 'ai coding', 'autonomous development']
---

Building a Honcho integration? These tools let your AI assistant do the scaffolding while you focus on the product.

## Agent Skills

Install the Honcho skill in Claude Code, Cursor, Windsurf, or any agent:

<CodeGroup>
```bash Install via npx (Recommended)
npx skills add plastic-labs/honcho
```

```bash Install as Claude Skill Manually
curl -o ~/.claude/skills/honcho-integration.md https://raw.githubusercontent.com/plastic-labs/honcho/main/docs/SKILL.md
```
</CodeGroup>

### `/honcho-integration`

**For new integrations.** Guided integration for adding Honcho to an existing Python or TypeScript codebase. The skill:

1. **Explores your codebase** to understand your language, framework, and existing AI/LLM integrations
2. **Interviews you** about which entities should be peers, your preferred integration pattern, and session structure
3. **Implements the integration** based on your answers—installing the SDK, creating peers, configuring sessions, and wiring up the chat endpoint
4. **Verifies the setup** to ensure everything is configured correctly

### `/migrate-honcho-py` / `/migrate-honcho-ts`

**For SDK upgrades.** Migrates code from v1.6.0 to v2.0.0 (required for Honcho 3.0.0+). Use when upgrading the SDK or seeing errors about removed APIs like `observations`, `Representation`, `.core`, or `get_config`.

Both skills handle: terminology changes (`Observation` → `Conclusion`), `Representation` class removal, method renames, and streaming API updates.

| Python | TypeScript |
|--------|------------|
| `/migrate-honcho-py` | `/migrate-honcho-ts` |
| `AsyncHoncho` → `.aio` accessor | `@honcho-ai/core` removal |
| | `snake_case` → `camelCase` |

---

## MCP Server

Give your coding agent (or any MCP client) direct access to Honcho during development.

### Bespoke Flow (High-Level)
For agents that just need memory without managing sessions:

| Tool | What it does |
| --- | --- |
| `start_conversation` | Creates a peer + session in one call |
| `add_turn` | Logs a user/assistant exchange |
| `get_personalization_insights` | Retrieves learned context about the peer |

### General Tools (Full API)
For fine-grained control over the Honcho data model:

- **Workspace:** `inspect_workspace`, `list_workspaces`, `search_workspace`, `get/set_workspace_metadata`
- **Peers:** `create_peer`, `list_peers`, `chat`, `get_peer_card`, `get_peer_context`, `get_representation`, `search_peer_messages`
- **Sessions:** `create_session`, `list_sessions`, `clone_session`, `add_messages`, `get_session_context`, `inspect_session`, `get_session_summaries`
- **Conclusions:** `list_conclusions`, `query_conclusions`, `create_conclusions`, `delete_conclusion`
- **System:** `schedule_dream`, `get_queue_status`

### Setup

Connect via SSE or Streamable HTTP transport:
```
URL: https://mcp.honcho.dev/mcp
Headers:
  Authorization: Bearer <your-api-key>
  X-Honcho-User-Name: <user-identifier>
```

Works with Claude Desktop, Cursor, Codeium, and any MCP-compatible client.


---

## CLI

Quick commands for local development and testing.

Coming soon.

---

## LLM-Friendly Docs

These docs are designed to be easily consumable by LLMs. Each page has a button that lets you copy the page as Markdown or paste directly into ChatGPT or Claude.

We follow the llms.txt standard:

- [llms.txt](/llms.txt)
- [llms-full.txt](/llms-full.txt)