calm

1import type { Register } from "claude-code";
2
3type Mode = "off" | "normal" | "zen";
4
5const modes: readonly Mode[] = ["off", "normal", "zen"];
6
7const isMode = (value: unknown): value is Mode =>
8  typeof value === "string" && (modes as readonly string[]).includes(value);
9
10const field = ({ input, key }: { input: unknown; key: string }): string | undefined => {
11  if (typeof input !== "object" || input === null) return undefined;
12  const value: unknown = Reflect.get(input, key);
13  return typeof value === "string" && value.length > 0 ? value : undefined;
14};
15
16const basename = (path: string): string => path.split("/").filter(Boolean).pop() ?? path;
17
18const shorten = (text: string): string => {
19  const line = text.split("\n")[0] ?? "";
20  return line.length > 60 ? `${line.slice(0, 57)}...` : line;
21};
22
23type Verb = { present: string; past: string };
24
25const describe = ({ tool, input }: { tool: string; input: unknown }): Verb => {
26  const path = field({ input, key: "file_path" }) ?? field({ input, key: "notebook_path" });
27  const target = path ? ` ${basename(path)}` : "";
28  switch (tool) {
29    case "Read":
30      return { present: `Reading${target}`, past: `Read${target}` };
31    case "Edit":
32    case "MultiEdit":
33    case "NotebookEdit":
34      return { present: `Editing${target}`, past: `Edited${target}` };
35    case "Write":
36      return { present: `Writing${target}`, past: `Wrote${target}` };
37    case "Bash": {
38      const what = shorten(field({ input, key: "description" }) ?? field({ input, key: "command" }) ?? "command");
39      return { present: `Running ${what}`, past: `Ran ${what}` };
40    }
41    case "Grep":
42    case "Glob":
43      return { present: "Searching the codebase", past: "Searched the codebase" };
44    case "Agent":
45    case "Task":
46      return { present: "Delegating to an agent", past: "Delegated to an agent" };
47    case "WebFetch":
48    case "WebSearch":
49      return { present: "Researching the web", past: "Researched the web" };
50    default:
51      return { present: `Using ${tool}`, past: `Used ${tool}` };
52  }
53};
54
55export const register: Register = (on) => {
56  let mode: Mode = "normal";
57
58  on("session.start", async ($, e, next) => {
59    const stored = await $.store.get("mode");
60    if (isMode(stored)) mode = stored;
61    await $.command.register({
62      name: "calm",
63      description: "Set how much tool activity Claude Code shows",
64      argumentHint: "[off|normal|zen]",
65      immediate: true,
66    });
67    return next(e);
68  });
69
70  on("command.run", { command: "calm" }, async ($, e) => {
71    const requested = e.args.trim();
72    if (requested === "") return { text: `Mode: ${mode}. Use /calm off, /calm normal or /calm zen.` };
73    if (!isMode(requested)) return { text: `Unknown mode "${requested}". Use off, normal or zen.` };
74    mode = requested;
75    await $.store.set("mode", mode);
76    if (mode === "off") $.ui.status(undefined);
77    // Render answers are cached per input, so rows already on screen keep the old mode until invalidated.
78    $.ui.invalidate("ui.render");
79    return { text: `Mode: ${mode}.` };
80  });
81
82  on("tool.call", async ($, e, next) => {
83    // A subagent's calls would make the status line flicker between two streams of work.
84    if (mode === "off" || e.agentId !== undefined) return next(e);
85    $.ui.status(describe({ tool: e.tool, input: e }).present);
86    return next(e);
87  });
88
89  on("turn.complete", ($, e, next) => {
90    $.ui.status(undefined);
91    return next(e);
92  });
93
94  on("ui.render", { component: "ToolUse" }, ($, e, next) => {
95    const { tool, input, isRunning, isErrored, isInterrupted } = e.props;
96    if (mode === "off" || isErrored || isInterrupted) return next(e);
97    const { Box, Text } = $.ui.resolve(e);
98    if (mode === "zen" || isRunning) return <Box />;
99    return (
100      <Box>
101        <Text color="green">✓ </Text>
102        <Text dimColor>{describe({ tool, input }).past}</Text>
103      </Box>
104    );
105  });
106
107  on("ui.render", { component: "ToolResult" }, ($, e, next) => {
108    if (mode === "off" || e.props.isErrored) return next(e);
109    const { Box } = $.ui.resolve(e);
110    return <Box />;
111  });
112
113  on("ui.render", { component: "ToolGroup" }, ($, e, next) => {
114    if (mode !== "zen" || e.props.calls.some((call) => call.isErrored)) return next(e);
115    const { Box } = $.ui.resolve(e);
116    return <Box />;
117  });
118
119  on("ui.render", { component: "TurnDuration" }, ($, e, next) => {
120    if (mode !== "zen") return next(e);
121    const { Box } = $.ui.resolve(e);
122    return <Box />;
123  });
124};
125