charm-crush

Orchestrate LLM conversations, tool execution, streaming, and permission flows in a Charm-based TUI.

12|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/alxxpersonal/forge --skill charm-crush
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: charm-crush
Source: https://github.com/alxxpersonal/forge/tree/main/skills/charm-crush
Command: npx skills add https://github.com/alxxpersonal/forge --skill charm-crush

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Crush captures production-ready architectural patterns for a Charm-based agentic TUI, providing a reference implementation of a centralized model, streaming LLM integration, tool orchestration, permission flows, and a modular UI component system.

Core Features & Use Cases

  • Architecture overview: centralized UI model, multi-provider tool integration, and a cohesive agent loop.
  • Tool system and MCP: dynamic tool loading, nested tool containers, and a configurable permission system.
  • Streaming UI: real-time LLM streaming into a Bubble Tea UI with dialogs and overlays.
  • Coordinator & workflows: end-to-end lifecycle management of sessions, models, and prompts.

Quick Start

Initialize a Crush project locally to explore production-grade TUI patterns and start experimenting with the agent workflow.

Frequently Asked Questions about charm-crush

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a production-grade Bubble Tea TUI for LLM agent workflows?

Structure a Bubble Tea TUI using a centralized UI model, a coordinator for session lifecycle management, and a publish/subscribe event bus to handle streaming LLM conversations and tool execution.

What is the best way to manage dynamic MCP tools in a Go TUI application?

Manage dynamic MCP tools in a Go TUI by implementing nested tool containers and a configurable permission system, allowing multi-provider tool integration within a centralized model orchestration architecture.

How do I handle real-time LLM streaming and dialog overlays in a Bubble Tea application?

Handle real-time LLM streaming in Bubble Tea by routing tokens through a publish/subscribe event bus into modular UI components, rendering dialogs and overlays while maintaining a cohesive agent loop.

Can I use a dialog-driven permission system for tool execution within a Charm-based TUI?

Yes, you can implement a dialog-driven permission system within a Charm-based TUI by utilizing a configurable permission flow that intercepts tool execution requests across a complex component hierarchy.

Does this approach support centralized model orchestration across multiple LLM providers?

Yes, this approach supports centralized model orchestration across multiple LLM providers by enforcing a robust workflow with a coordinator that manages end-to-end lifecycles of sessions, models, and prompts.

How do I scale and test a complex Charm TUI component hierarchy without losing maintainability?

Scale and test a Charm TUI component hierarchy by applying modular UI patterns, a centralized state model, and a publish/subscribe event bus to decouple components and ensure maintainability.