A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.
Swift ai-agentsanthropicantigravityclaudeclaude-codecodexcursordynamic-islandgemini-cliiosiphonlinuxmacosmacos-appmenubar-appnotchopen-sourceswiftswiftuiwindows
// The Coucou window: a sidebar with Flow (dictation, the Notetaker, the
// statistics, the dictionary, the snippets, the styles and their settings)
// and Notch (every setting of the island), and the page on the right, under
// its coloured band. Port of FlowHub.swift.
import "./hub.css";
import { h, clear } from "../views/dom";
import { t, onLanguageChange } from "../i18n/i18n";
import { onEvent } from "../core/bridge";
import { FlowBridge, type FlowPrefs, type FlowStatus, type ModelsStatus } from "../core/flow";
import { hero, liveMochi, setWindowShown } from "./hero";
import { icon, keyLabel } from "./ui";
import { searchSettings, type SettingsSearchHit } from "./search";
export type PageId =
| "dictation" | "notes" | "insights" | "dictionary" | "snippets" | "styles" | "flowsettings"
| "general" | "pills" | "agents" | "chat" | "voice" | "integrations" | "phone" | "shortcuts"
| "mailOverview" | "mailRules" | "mailBanned" | "mailVIP";
interface PageDef {
id: PageId;
icon: string;
title: () => string;
/** The band's line; none for pages that draw their own band. */
subtitle?: () => string;
}
export const FLOW_PAGES: PageDef[] = [
{ id: "dictation", icon: "mic", title: () => t("Dictation") },
{ id: "notes", icon: "record", title: () => t("Notetaker") },
{ id: "insights", icon: "chart", title: () => t("Statistics") },
{ id: "dictionary", icon: "book", title: () => t("Dictionary") },
{ id: "snippets", icon: "bolt", title: () => t("Snippets") },
{ id: "styles", icon: "text", title: () => t("Styles") },
{ id: "flowsettings", icon: "sliders", title: () => t("Settings") },
];
export const NOTCH_PAGES: PageDef[] = [
{ id: "general", icon: "gear", title: () => t("General"), subtitle: () => t("Mochi, his sounds and how the island behaves.") },
{ id: "pills", icon: "grid", title: () => t("Active pills"), subtitle: () => t("The pills shown in the island, their order and their colours.") },
{ id: "agents", icon: "terminal", title: () => t("Agents"), subtitle: () => t("Claude Code, Codex and the other agents Mochi follows.") },
{ id: "chat", icon: "chat", title: () => t("Chat"), subtitle: () => t("The AI of the island's chat, with your own keys.") },
{ id: "voice", icon: "wave", title: () => "OK Coucou" },
{ id: "integrations", icon: "puzzle", title: () => t("Integrations"), subtitle: () => t("Stripe, GitHub, Vercel, n8n, Notion and the rest.") },
{ id: "phone", icon: "phone", title: () => t("Android phone"), subtitle: () => t("Your agents and their approvals on your Android phone, over your Wi-Fi.") },
{ id: "shortcuts", icon: "keyboard", title: () => t("Shortcuts"), subtitle: () => t("The keys that open the island and its actions.") },
];
/** Mail (classic Outlook): Windows only, Linux has no Outlook. */
export const MAIL_PAGES: PageDef[] = [
{ id: "mailOverview", icon: "tray", title: () => t("Overview") },
{ id: "mailRules", icon: "filter", title: () => t("Rules") },
{ id: "mailBanned", icon: "nosign", title: () => t("Banned words") },
{ id: "mailVIP", icon: "star", title: () => t("VIP") },
];
const ALL = [...FLOW_PAGES, ...NOTCH_PAGES, ...MAIL_PAGES];
/** What a page gets to draw itself and reach the rest of the window. */
export interface HubContext {
status: FlowStatus;
navigate(page: PageId): void;
/** Reads the status again (prefs, models) and redraws the sidebar's line. */
refresh(): Promise<FlowStatus>;
/** Saves new preferences and keeps them as the window's. */
setPrefs(change: (p: FlowPrefs) => void): Promise<void>;
/** The band of a page, its Mochis walking. */
hero(page: PageId, title: string, subtitle: string | null, actions?: HTMLElement[], compact?: boolean): HTMLElement;
/** Set by a page: called when the page is left. */
onLeave?: () => void;
}
export type FlowPageRenderer = (container: HTMLElement, ctx: HubContext) => void | Promise<void>;
export interface HubOptions {
version: string;
flowPages: Partial<Record<PageId, FlowPageRenderer>>;
/** Draws the island's settings for one of the Notch pages into `container`. */
renderNotch(page: PageId, container: HTMLElement): Promise<void>;
}
const DEFAULT_STATUS: FlowStatus = {
prefs: {
enabled: false, key: "right_ctrl", edge: "bottom", mic: "", keepDays: 30, cleanup: false,
defaultStyle: "natural", summaryEngine: "claude", openAtLaunch: true, voice: false, voiceOutput: "system", voiceGender: "female",
},
models: { parakeet: { state: "missing" }, downloadMb: 700 },
keys: "ok",
hasClaudeKey: false,
mics: [],
platform: navigator.userAgent.includes("Windows") ? "windows" : "linux",
autostarted: false,
};
export async function startHub(root: HTMLElement, opts: HubOptions) {
document.body.classList.add("hub-window");
// The window is created hidden and only shown and hidden afterwards: its
// canvases animate only while it is on screen (#792).
await onEvent<boolean>("hub-visible", setWindowShown);
const shown = await FlowBridge.hubShown();
if (shown !== null) setWindowShown(shown);
let current: PageId = "dictation";
let activeAnchor: string | null = null;
let searchHits: SettingsSearchHit[] = [];
let status: FlowStatus = (await FlowBridge.status()) ?? DEFAULT_STATUS;
const items = new Map<PageId, HTMLElement>();
const labels = new Map<PageId, HTMLElement>();
const searchRows = new Map<string, HTMLElement>();
const statusLine = h("div", { class: "hub-status" });
const scroll = h("div", { class: "hub-scroll" });
let rendering = 0;
const ctx: HubContext = {
get status() {
return status;
},
navigate: (page) => void show(page),
refresh: async () => {
status = (await FlowBridge.status()) ?? status;
drawStatus();
return status;
},
setPrefs: async (change) => {
const next = { ...status.prefs };
change(next);
status = { ...status, prefs: next };
drawStatus();
await FlowBridge.setPrefs(next);
},
hero: (page, title, subtitle, actions = [], compact = false) => hero(page, title, subtitle, actions, compact),
};
function drawStatus() {
clear(statusLine);
const models = status.models.parakeet.state;
let color = "#6b7079";
let text: string;
if (!status.prefs.enabled) {
text = t("Dictation is off");
} else if (models !== "ready") {
color = "#f7b32b";
text = models === "downloading" ? t("Downloading the voice model…") : t("Download the voice model to dictate");
} else if (status.keys !== "ok" && status.keys !== "wayland") {
color = "#f7b32b";
text = t("Use the pill's microphone to dictate");
} else {
color = "#34d399";
text = t("Ready · hold {0}", { 0: keyLabel(status.keys === "wayland" ? "wayland" : status.prefs.key, status.platform) });
}
statusLine.append(h("i", { class: "dot", style: `background:${color}` }), h("span", { text }));
}
function updateSearchRowHighlights() {
for (const [id, rowEl] of searchRows) {
rowEl.classList.toggle("on", id === activeAnchor);
}
}
async function show(page: PageId, targetAnchor?: string) {
const def = ALL.find((p) => p.id === page) ?? FLOW_PAGES[0];
ctx.onLeave?.();
ctx.onLeave = undefined;
current = def.id;
activeAnchor = targetAnchor ?? null;
for (const [id, el] of items) el.classList.toggle("on", id === current);
updateSearchRowHighlights();
const token = ++rendering;
const page_ = h("div", { class: "hub-page" });
const renderer = opts.flowPages[def.id];
if (renderer) {
await renderer(page_, ctx);
} else {
page_.append(hero(def.id, def.title(), def.subtitle?.() ?? null));
const container = h("div", { id: "settings-root" });
page_.append(container);
await opts.renderNotch(def.id, container);
}
if (token !== rendering) return;
clear(scroll);
scroll.append(page_);
if (targetAnchor) {
const el = page_.querySelector(`[data-anchor="${targetAnchor}"]`) as HTMLElement | null;
if (el) {
el.scrollIntoView({ behavior: "smooth", block: "center" });
el.classList.remove("hub-card-glowing");
void el.offsetWidth;
el.classList.add("hub-card-glowing");
} else {
scroll.scrollTop = 0;
}
} else {
scroll.scrollTop = 0;
}
}
// ── The sidebar ──
const side = h("nav", { class: "hub-side" });
const logo = h("canvas", {});
side.append(h("div", { class: "hub-brand" }, logo, h("span", { text: "Coucou" })));
liveMochi(logo as HTMLCanvasElement);
// Settings search field
const searchInput = h("input", {
class: "hub-search-input",
type: "text",
placeholder: t("Search settings"),
spellcheck: "false",
}) as HTMLInputElement;
const searchClear = h("button", {
class: "hub-search-clear",
title: t("Close"),
style: "display:none",
}, icon("x"));
const searchBox = h("div", { class: "hub-search" },
icon("search"),
searchInput,
searchClear,
);
searchBox.querySelector("svg")?.classList.add("hub-search-icon");
side.append(searchBox);
const groupsContainer = h("div", { class: "hub-groups" });
const resultsContainer = h("div", { class: "hub-search-results", style: "display:none" });
side.append(groupsContainer, resultsContainer);
const group = (title: string, pages: PageDef[]) => {
const heading = h("div", { class: "hub-group", text: title });
groupsContainer.append(heading);
for (const p of pages) {
const b = h("button", { class: "hub-item", onclick: () => void show(p.id) });
const label = h("span", { text: p.title() });
b.append(icon(p.icon), label);
items.set(p.id, b);
labels.set(p.id, label);
groupsContainer.append(b);
}
return heading;
};
group("Flow", FLOW_PAGES);
const notchGroup = group(t("Notch"), NOTCH_PAGES);
if (status.platform === "windows") group("Mail", MAIL_PAGES);
function renderSearchResults() {
clear(resultsContainer);
searchRows.clear();
const query = searchInput.value.trim();
if (!query) {
searchClear.style.display = "none";
resultsContainer.style.display = "none";
groupsContainer.style.display = "";
searchHits = [];
return;
}
searchClear.style.display = "";
groupsContainer.style.display = "none";
resultsContainer.style.display = "";
searchHits = searchSettings(query, (pageId) => ALL.find((p) => p.id === pageId)?.title() ?? pageId);
if (searchHits.length === 0) {
resultsContainer.append(h("div", { class: "hub-search-empty", text: t("No setting found") }));
return;
}
for (const hit of searchHits) {
const pageDef = ALL.find((p) => p.id === hit.entry.page);
const row = h("button", { class: "hub-search-row" });
if (activeAnchor === hit.entry.id && current === hit.entry.page) {
row.classList.add("on");
}
row.append(icon(pageDef?.icon ?? "sliders"));
const textContainer = h("div", { class: "hub-search-row-text" });
const rowTitle = h("div", { class: "hub-search-row-title", text: hit.label ?? t(hit.entry.title) });
const rowSubtitle = h("div", {
class: "hub-search-row-subtitle",
text: hit.label
? `${pageDef?.title() ?? ""} › ${t(hit.entry.title)}`
: (pageDef?.title() ?? ""),
});
textContainer.append(rowTitle, rowSubtitle);
row.append(textContainer);
row.addEventListener("click", () => {
void show(hit.entry.page, hit.entry.id);
});
searchRows.set(hit.entry.id, row);
resultsContainer.append(row);
}
}
searchInput.addEventListener("input", renderSearchResults);
searchInput.addEventListener("keydown", (e) => {
if (e.key === "Escape") {
searchInput.value = "";
renderSearchResults();
} else if (e.key === "Enter") {
if (searchHits.length > 0) {
void show(searchHits[0].entry.page, searchHits[0].entry.id);
}
}
});
searchClear.addEventListener("click", () => {
searchInput.value = "";
renderSearchResults();
searchInput.focus();
});
onLanguageChange(() => {
searchInput.placeholder = t("Search settings");
if (searchInput.value.trim()) renderSearchResults();
});
side.append(h("div", { class: "spacer" }), statusLine, h("div", { class: "hub-version", text: `Coucou ${opts.version}` }));
clear(root);
root.append(side, h("main", { class: "hub-panel" }, scroll));
drawStatus();
await show(current);
void onEvent<string>("hub-page", (page) => {
const id = (page === "settings" ? "flowsettings" : page) as PageId;
if (ALL.some((p) => p.id === id)) void show(id);
});
void onEvent<FlowPrefs>("flow-prefs", (prefs) => {
status = { ...status, prefs };
drawStatus();
});
void onEvent<ModelsStatus>("speech-models", (models) => {
status = { ...status, models };
drawStatus();
});
return {
redraw: () => {
for (const p of ALL) {
const label = labels.get(p.id);
if (label) label.textContent = p.title();
}
notchGroup.textContent = t("Notch");
drawStatus();
void show(current);
},
current: () => current,
};
}