migrate-honcho-ts

Official

Migrate Honcho TS SDK to v2 safely

Authorplastic-labs
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This skill guides engineers through upgrading Honcho TypeScript SDK code from v1.6.0 to v2.0.0, addressing breaking changes and removed APIs to reduce integration risk.

Core Features & Use Cases

  • Migrate core API names (e.g., getConfig -> getConfiguration, setConfig -> setConfiguration) across client, peer, and session layers.
  • Replace .core usages with .http and adapt to the new HTTP client model.
  • Convert snake_case properties to camelCase (e.g., created_at -> createdAt, token_count -> tokenCount) and update related data structures.
  • Update streaming to chatStream() and remove deprecated features like pollDeriverStatus(), with guidance for queueStatus() usage.
  • Support structured migrations with step-by-step examples and a migration checklist to ensure no breaking changes are missed.

Quick Start

  1. Review the MIGRATION-CHECKLIST.md and align your project with the new API surface.
  2. Update dependencies by removing @honcho-ai/core and installing the v2 SDK.
  3. Refactor code to replace deprecated APIs; for example, call honcho.getConfiguration() and peer.context({ ... }) instead of legacy methods.
  4. Ensure all property names follow camelCase conventions for messages and configurations.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: migrate-honcho-ts
Download link: https://github.com/plastic-labs/honcho/archive/main.zip#migrate-honcho-ts

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.