{
  "id": "page:docs-reference-repos-charmbracelet-crush-research",
  "_kind": "Page",
  "_file": "wiki/docs/reference-repos/charmbracelet/crush/research.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/reference-repos/charmbracelet/crush/research.md",
    "sourceKind": "repo-docs",
    "title": "charmbracelet/crush",
    "displayName": "charmbracelet/crush",
    "slug": "docs/reference-repos/charmbracelet/crush/research",
    "articlePath": "wiki/docs/reference-repos/charmbracelet/crush/research.md",
    "article": "\n# charmbracelet/crush\n\n- **Archetype**: harness-framework\n- **Stars**: 22,930\n- **Last pushed**: 2026-04-13\n- **License**: NOASSERTION (undetermined)\n- **Discovered**: 2026-04-13\n- **Source**: successor to archived opencode-ai/opencode\n- **Skills found**: 0 (harness framework)\n\n## Summary\nTerminal-based AI assistant with TUI interface, multi-provider support, and MCP extensibility. Successor to OpenCode, developed by Charmbracelet team with \"glamorous agentic coding for all.\" Features LSP integration, cross-platform support (macOS, Linux, Windows, Android, BSDs), and comprehensive Model Context Protocol support across stdio, HTTP, and SSE transports.\n\n## Assessment\nHIGH VALUE for harness assimilation - modern terminal AI interface with sophisticated MCP integration and skill system. Active development with 22K+ stars indicates strong community adoption. However, lack of stop hooks limits full babysitter integration potential.\n\n## Extraction Priority\n- High\n- Rationale: Active successor to OpenCode with modern architecture and strong MCP support. TUI patterns and session management valuable for babysitter observer dashboard improvements.\n\n## Harness Integration Ideas\n\n**Capability Assessment for Babysitter Integration:**\n\n| Capability | Status | Details |\n|------------|---------|---------|\n| **Custom Tools/MCP** | ✅ EXCELLENT | Comprehensive MCP support (stdio, HTTP, SSE transports), built-in tool disabling, environment variable expansion, per-tool configuration |\n| **Stop Hooks** | ❌ NOT SUPPORTED | Session-based architecture with LSP integration but **no interruption hooks documented** for mid-conversation stopping |\n| **Plugin System** | ✅ EXCELLENT | Agent Skills system following agentskills.io standard, discoverable SKILL.md folders, configurable skill paths, anthropics/skills integration |\n\n**Integration Viability:** PARTIAL - Excellent MCP integration and skills system but **lacks critical stop-hook capability** for babysitter's orchestration loop interruption needs.\n\n- **Harness Adapter**: New harness integration for Crush platform\n  - Adapter implementation: `createCrushAdapter` in `packages/babysitter-sdk/src/harness/adapters/`\n  - Plugin structure: `plugins/babysitter-crush/` for Charmbracelet Crush integration\n  - CLI integration: Terminal UI patterns, session management, MCP server orchestration\n  - Current limitation: **No stop hooks for conversation interruption**\n  - Integration approach: Custom conversation pause/resume mechanism required\n  - Implementation scope: Terminal UI adaptation, MCP protocol bridging, session state management\n\n## TUI/Orchestration Improvements\n\n- **Terminal Interface Patterns**: Adapt Crush's glamorous TUI design for babysitter observer dashboard\n  - Current limitation: Basic terminal output vs. polished TUI experience\n  - Integration approach: Import Charmbracelet's TUI libraries and design patterns\n  - Implementation scope: Observer dashboard visual enhancement, terminal UI modernization\n\n- **Session Management**: Multi-context session architecture for project-specific agent state\n  - Current limitation: Single-context babysitter runs vs. multi-session capability\n  - Integration approach: Implement session switching and context isolation\n  - Implementation scope: Run directory organization, session state persistence\n\n## Implicit Procedural Knowledge\n\nNone - framework rather than process repository.\n\n## Library Mapping\n\n| Extractable Process | Library Status | Action | Existing Path | Target Placement |\n|-------------------|----------------|--------|---------------|------------------|\n| TUI Design Patterns | NEW | Charmbracelet-style terminal interface patterns | - | specializations/developer-experience-ux/tui-design-patterns.js |\n| Multi-Session Management | NEW | Context isolation and session switching methodology | - | specializations/shared/multi-session-management.js |\n| MCP Transport Orchestration | NEW | Multi-transport MCP server management | - | specializations/devops-sre-platform/mcp-transport-orchestration.js |\n| Cross-Platform Terminal Adaptation | NEW | Terminal interface adaptation across platforms | - | specializations/shared/cross-platform-terminal.js |\n\n## Plugin Marketplace Mapping\n\n| Plugin Idea | Marketplace Status | Action | Existing Plugin | Target Placement |\n|-------------|-------------------|--------|-----------------|------------------|\n| Crush Harness Adapter | NEW | Charmbracelet Crush integration for babysitter | - | plugins/a5c/marketplace/blueprints/crush-harness-adapter/ |\n| Glamorous TUI Enhancement | NEW | Charmbracelet-style TUI improvements for observer dashboard | - | plugins/a5c/marketplace/blueprints/glamorous-tui-enhancement/ |\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-reference-repos",
      "to": "page:docs-reference-repos-charmbracelet-crush-research",
      "kind": "contains_page"
    }
  ]
}