Skip to content

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.

Name a session after its title, with Claude Code's own as a fallback

NikitaBulichevb0e0d78c01d9
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index a0e7716d..0e50ff77 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -36,6 +36,9 @@ jobs:
- name: Test question queue
run: bash scripts/test-question-queue.sh
+ - name: Test session titles in the relay
+ run: python3 scripts/test-session-title.py
+
- name: Test Flow dictation keys
run: bash scripts/test-flow-keys.sh
diff --git a/NotchBuddy/Sources/App/HookServer.swift b/NotchBuddy/Sources/App/HookServer.swift
index 10e52ec1..8798114d 100644
--- a/NotchBuddy/Sources/App/HookServer.swift
+++ b/NotchBuddy/Sources/App/HookServer.swift
@@ -3380,9 +3380,12 @@ def normalize_tool_fields(payload):
payload['cwd'] = payload['workdir']
def add_session_name(payload):
- # Name the pill after the folder the session started in, not the current cwd (the
- # agent may cd into subfolders), or after the session's /rename title. Both come
- # from the transcript: its first lines and the last custom-title entry.
+ # Name the pill after the session's title, else the folder the session started in,
+ # not the current cwd (the agent may cd into subfolders). Both come from the
+ # transcript: its first lines, and its last custom-title entry (/rename), else its
+ # last ai-title one (the title Claude Code gives a session; VS Code sessions only
+ # have that). Entries are told by their type: a message that merely quotes one is not
+ # a title. Claude Code writes the title again every 40-80 KB, hence a 256 KB tail.
path = payload.get('transcript_path') or ''
if not path:
return
@@ -3397,15 +3400,24 @@ def add_session_name(payload):
payload['session_root'] = root
break
f.seek(0, os.SEEK_END)
- start = max(0, f.tell() - 65536)
+ start = max(0, f.tell() - 262144)
f.seek(start)
lines = f.read().splitlines()
+ ai_title = ''
for line in reversed(lines[1:] if start else lines):
- if b'"custom-title"' in line:
- title = json.loads(line).get('customTitle')
- if title:
- payload['session_title'] = title
- break
+ if b'"type":"custom-title"' not in line and b'"type":"ai-title"' not in line:
+ continue
+ try:
+ entry = json.loads(line)
+ except Exception:
+ continue
+ if entry.get('type') == 'custom-title' and entry.get('customTitle'):
+ payload['session_title'] = entry['customTitle']
+ return
+ if entry.get('type') == 'ai-title' and not ai_title:
+ ai_title = entry.get('aiTitle') or ''
+ if ai_title:
+ payload['session_title'] = ai_title
except Exception:
pass
@@ -3733,9 +3745,12 @@ def normalize_tool_fields(payload):
payload['cwd'] = payload['workdir']
def add_session_name(payload):
- # Name the pill after the folder the session started in, not the current cwd (the
- # agent may cd into subfolders), or after the session's /rename title. Both come
- # from the transcript: its first lines and the last custom-title entry.
+ # Name the pill after the session's title, else the folder the session started in,
+ # not the current cwd (the agent may cd into subfolders). Both come from the
+ # transcript: its first lines, and its last custom-title entry (/rename), else its
+ # last ai-title one (the title Claude Code gives a session; VS Code sessions only
+ # have that). Entries are told by their type: a message that merely quotes one is not
+ # a title. Claude Code writes the title again every 40-80 KB, hence a 256 KB tail.
path = payload.get('transcript_path') or ''
if not path:
return
@@ -3750,15 +3765,24 @@ def add_session_name(payload):
payload['session_root'] = root
break
f.seek(0, os.SEEK_END)
- start = max(0, f.tell() - 65536)
+ start = max(0, f.tell() - 262144)
f.seek(start)
lines = f.read().splitlines()
+ ai_title = ''
for line in reversed(lines[1:] if start else lines):
- if b'"custom-title"' in line:
- title = json.loads(line).get('customTitle')
- if title:
- payload['session_title'] = title
- break
+ if b'"type":"custom-title"' not in line and b'"type":"ai-title"' not in line:
+ continue
+ try:
+ entry = json.loads(line)
+ except Exception:
+ continue
+ if entry.get('type') == 'custom-title' and entry.get('customTitle'):
+ payload['session_title'] = entry['customTitle']
+ return
+ if entry.get('type') == 'ai-title' and not ai_title:
+ ai_title = entry.get('aiTitle') or ''
+ if ai_title:
+ payload['session_title'] = ai_title
except Exception:
pass
diff --git a/scripts/test-session-title.py b/scripts/test-session-title.py
new file mode 100644
index 00000000..8b35243a
--- /dev/null
+++ b/scripts/test-session-title.py
@@ -0,0 +1,119 @@
+#!/usr/bin/env python3
+"""Check the title the nb-hook relays give a session, read from its transcript.
+
+Both relays come out of HookServer.swift and send one event each to a stand-in socket:
+the /rename title (custom-title) wins, else the title Claude Code gave the session
+(ai-title, all VS Code sessions have), else none (the pill takes the folder). Only real
+entries count, not a line that only mentions one, and a title up to 256 KB back is found.
+"""
+import json
+import os
+from pathlib import Path
+import re
+import shutil
+import socket
+import subprocess
+import sys
+import tempfile
+import threading
+
+ROOT = Path(__file__).resolve().parent.parent
+SOURCE = ROOT / "NotchBuddy/Sources/App/HookServer.swift"
+SOCKETS = {
+ "nbHookPythonGitHub": "Library/Application Support/NotchBuddy/nb.sock",
+ "nbHookPythonAppStore": "Library/Containers/fr.louisraille.Coucou/Data/nb.sock",
+}
+
+
+def swift_literal(source, name):
+ match = re.search(rf'^private let {name} = """\n(.*?)^"""$', source, re.S | re.M)
+ if not match:
+ sys.exit(f"{name} not found in {SOURCE.name}")
+ return match.group(1).replace("\\\\", "\\")
+
+
+def line(entry):
+ return json.dumps(entry, ensure_ascii=False, separators=(",", ":"))
+
+
+def transcript(*entries, pad=0):
+ first = line({"type": "user", "cwd": "/srv/project", "message": {"role": "user", "content": "hi"}})
+ filler = [line({"type": "assistant", "message": {"content": "x" * 900}})] * (pad // 1000)
+ return "\n".join([first, *entries[:1], *filler, *entries[1:]]) + "\n"
+
+
+CUSTOM = line({"type": "custom-title", "customTitle": "Renamed by me", "sessionId": "s"})
+AI = line({"type": "ai-title", "aiTitle": "Title from Claude", "sessionId": "s"})
+AI_OLD = line({"type": "ai-title", "aiTitle": "Older title", "sessionId": "s"})
+# Lines that are about titles without being one: a search for "custom-title", and a tool
+# call carrying a title entry as data. The relay once stopped at the first of these.
+QUOTE = "\n".join([
+ line({"type": "assistant", "message": {"content": [
+ {"type": "tool_use", "name": "Grep", "input": {"pattern": "custom-title"}}]}}),
+ line({"type": "assistant", "message": {"content": [
+ {"type": "tool_use", "name": "Write", "input": {"entry": {"type": "custom-title", "customTitle": "not me"}}}]}}),
+])
+
+CASES = [
+ ("the /rename title wins", transcript(AI_OLD, CUSTOM, AI), "Renamed by me"),
+ ("else the title Claude Code gave", transcript(AI_OLD, AI), "Title from Claude"),
+ ("a line that mentions a title is not one", transcript(CUSTOM, QUOTE), "Renamed by me"),
+ ("nor for the title Claude Code gave", transcript(AI, QUOTE), "Title from Claude"),
+ ("a title 200 KB back is found", transcript(AI, pad=200_000), "Title from Claude"),
+ ("no title: the pill takes the folder", transcript(QUOTE), None),
+]
+
+
+def main():
+ source = SOURCE.read_text(encoding="utf-8")
+ wrapper = swift_literal(source, "nbHookShellWrapper")
+ python3 = shutil.which("python3")
+ work = Path(tempfile.mkdtemp(prefix="nbt", dir="/tmp"))
+ try:
+ for variant, sock_rel in SOCKETS.items():
+ print(f"-- {variant}")
+ home = work / variant
+ hook = home / "hook"
+ hook.mkdir(parents=True)
+ (hook / "nb-hook").write_text(wrapper)
+ (hook / "nb-hook.py").write_text(swift_literal(source, variant))
+ sock_path = home / sock_rel
+ sock_path.parent.mkdir(parents=True)
+ server = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+ server.bind(str(sock_path))
+ server.listen(4)
+ for label, text, expected in CASES:
+ path = home / "transcript.jsonl"
+ path.write_text(text, encoding="utf-8")
+ event = {"hook_event_name": "SessionStart", "session_id": "s", "cwd": "/srv/project/sub",
+ "transcript_path": str(path)}
+ received = {}
+
+ def serve():
+ conn, _ = server.accept()
+ with conn:
+ data = b""
+ while b"\n" not in data:
+ chunk = conn.recv(65536)
+ if not chunk:
+ break
+ data += chunk
+ received.update(json.loads(data))
+ t = threading.Thread(target=serve, daemon=True)
+ t.start()
+ # Straight to the relay with this python3: the wrapper's own checks are not the point here.
+ subprocess.run([python3, str(hook / "nb-hook.py")], input=json.dumps(event), text=True,
+ env={"HOME": str(home), "PATH": os.environ.get("PATH", "")}, timeout=10, check=True)
+ t.join(5)
+ got = received.get("session_title")
+ if got != expected or received.get("session_root") != "/srv/project":
+ sys.exit(f"FAIL: {label}: title {got!r}, root {received.get('session_root')!r}")
+ print(f"ok {label}")
+ server.close()
+ finally:
+ shutil.rmtree(work, ignore_errors=True)
+ print("session titles: all checks passed")
+
+
+if __name__ == "__main__":
+ main()