Documentation / @agentick/react / useContextInfo

Function: useContextInfo()

useContextInfo(options?): UseContextInfoResult

Defined in: react/src/hooks/use-context-info.ts:93

Subscribe to context utilization info from the server.

Receives context_update events after each tick with:

• Token usage (input, output, total)
• Context utilization percentage
• Model capabilities (vision, tools, reasoning)
• Cumulative usage across ticks

Parameters

options?

UseContextInfoOptions = {}

Returns

UseContextInfoResult

Examples

import { useContextInfo } from '@agentick/react';

function ContextBar() {
  const { contextInfo } = useContextInfo();

  if (!contextInfo) return null;

  return (
    <div className="context-bar">
      <span>{contextInfo.modelId}</span>
      <span>{contextInfo.utilization?.toFixed(1)}% used</span>
      <progress value={contextInfo.utilization} max={100} />
    </div>
  );
}

function SessionContext({ sessionId }: { sessionId: string }) {
  const { contextInfo } = useContextInfo({ sessionId });

  if (!contextInfo) return <span>No context yet</span>;

  return (
    <span>
      {contextInfo.inputTokens.toLocaleString()} /
      {contextInfo.contextWindow?.toLocaleString() ?? '?'} tokens
    </span>
  );
}