Hooks

Hooks manage daemon communication, chat session state, logging, modal control, and terminal-aware UI utilities. Each hook requires specific context providers to be mounted.

Quick Start

The most commonly used hooks are useChat (bind to a chat session) and useDaemon (send commands, subscribe to events):

import { useChat, useDaemon } from "@comma-agents/tui";

function ChatView() {
  const chat = useChat();
  const { status } = useDaemon();

  return (
    <>
      <MessageList messages={chat.messages} />
      <StatusBar status={chat.status} />
    </>
  );
}

Provider Dependency

Hooks depend on context providers. The provider tree is:

UserConfigContextProvider → ThemeContextProvider → DaemonContextProvider → ChatSessionsContextProvider → ModalContextProvider

Most hooks require at least DaemonContextProvider. Chat hooks additionally require ChatSessionsContextProvider.

Hook Inventory