Merge pull request #7 from illegalstudio/feature/rename-sessions

Feature/rename sessions

Author: nahime0

README.md

@@ -41,6 +41,7 @@ It also surfaces:
 | Recent conversation (last 5 messages) | JSONL |
 | Last 20 tools used | JSONL |
 | Last activity timestamp | JSONL |
+| Custom session name | `~/.config/lazyagent/session-names.json` |
 
 ## Three interfaces, one binary
 
@@ -115,7 +116,7 @@ lazyagent --help                 Show help
 | `f` | Cycle activity filter |
 | `/` | Search sessions by project path |
 | `o` | Open session CWD in editor (see below) |
-| `r` | Force refresh |
+| `r` | Rename session (empty name resets) |
 | `q` / `ctrl+c` | Quit |
 
 ### macOS Menu Bar App
@@ -135,7 +136,7 @@ The tray process detaches automatically — your terminal returns immediately. T
 | `+` / `-` | Adjust time window (±10 minutes) |
 | `f` | Cycle activity filter |
 | `/` | Search sessions |
-| `r` | Force refresh |
+| `r` | Rename session (empty name resets) |
 | `esc` | Close detail / dismiss search |
 
 #### Right-click menu
@@ -157,6 +158,8 @@ Starts a read-only HTTP API server on `http://127.0.0.1:7421` (default port, wit
 | `GET /api` | Interactive playground (open in browser) |
 | `GET /api/sessions` | List visible sessions (`?search=`, `?filter=`) |
 | `GET /api/sessions/{id}` | Full session detail |
+| `PUT /api/sessions/{id}/name` | Rename session (`{"name": "..."}`, empty resets) |
+| `DELETE /api/sessions/{id}/name` | Remove custom name |
 | `GET /api/stats` | Summary stats (total, active, window) |
 | `GET /api/config` | Current configuration |
 | `GET /api/events` | SSE stream for real-time updates |
@@ -280,6 +283,7 @@ make clean
 - [x] Token usage and cost estimation in detail panel
 - [x] Animated braille spinner for active sessions
 - [x] `o` key to open session CWD in editor
+- [x] Rename sessions with persistent custom names (`r` key)
 - [ ] Display file diff for last written file
 
 ### v0.3 — macOS menu bar app
@@ -306,6 +310,7 @@ make clean
 - [x] Default port with automatic fallback (7421–7431)
 - [x] Custom bind address (`--host`)
 - [x] Combinable with TUI and tray (`--tui --tray --api`)
+- [x] Session rename endpoints (`PUT`/`DELETE /api/sessions/{id}/name`)
 
 ### Future ideas
 - [ ] Outbound webhooks on status changes

docs/API.md

@@ -1,6 +1,6 @@
 # lazyagent API
 
-lazyagent exposes an HTTP API for monitoring Claude Code sessions. The API is read-only and designed for building external clients (mobile apps, dashboards, integrations).
+lazyagent exposes an HTTP API for monitoring and managing Claude Code sessions, designed for building external clients (mobile apps, dashboards, integrations).
 
 ## Starting the API server
 
@@ -47,6 +47,7 @@ List all visible sessions within the configured time window.
     "session_id": "abc123",
     "cwd": "/Users/me/projects/myapp",
     "short_name": "…/projects/myapp",
+    "custom_name": "my-api-project",
     "activity": "thinking",
     "is_active": true,
     "model": "claude-sonnet-4-20250514",
@@ -73,6 +74,7 @@ Get full details for a specific session.
   "session_id": "abc123",
   "cwd": "/Users/me/projects/myapp",
   "short_name": "…/projects/myapp",
+  "custom_name": "my-api-project",
   "activity": "writing",
   "is_active": true,
   "model": "claude-sonnet-4-20250514",
@@ -107,6 +109,50 @@ Get full details for a specific session.
 
 ---
 
+### PUT /api/sessions/{id}/name
+
+Set a custom name for a session. Names are persisted in `~/.config/lazyagent/session-names.json` and synced across TUI, tray, and API in real-time.
+
+**Request body:**
+
+```json
+{
+  "name": "my-api-project"
+}
+```
+
+An empty `"name"` resets the session to its default path-based name.
+
+**Response:** `200 OK`
+
+```json
+{
+  "session_id": "abc123",
+  "custom_name": "my-api-project"
+}
+```
+
+Triggers an SSE `update` event to all connected clients.
+
+---
+
+### DELETE /api/sessions/{id}/name
+
+Remove the custom name from a session (reset to default path-based name).
+
+**Response:** `200 OK`
+
+```json
+{
+  "session_id": "abc123",
+  "custom_name": ""
+}
+```
+
+Triggers an SSE `update` event to all connected clients.
+
+---
+
 ### GET /api/stats
 
 Summary statistics.

frontend/src/App.svelte

@@ -73,9 +73,6 @@
     } else if (e.key === "-") {
       e.preventDefault();
       adjustWindow(-10);
-    } else if (e.key === "r") {
-      e.preventDefault();
-      loadSessions();
     }
   }
 
@@ -185,7 +182,7 @@
     <span><kbd class="text-text/60">/</kbd> search</span>
     <span><kbd class="text-text/60">f</kbd> filter</span>
     <span><kbd class="text-text/60">+/−</kbd> window</span>
-    <span><kbd class="text-text/60">r</kbd> refresh</span>
+    <span><kbd class="text-text/60">r</kbd> rename</span>
     <span><kbd class="text-text/60">esc</kbd> back</span>
   </footer>
 </div>

frontend/src/bindings/github.com/nahime0/lazyagent/internal/tray/models.ts

@@ -48,6 +48,7 @@ export class SessionFull {
     "sessionId": string;
     "cwd": string;
     "shortName": string;
+    "customName": string;
     "activity": string;
     "isActive": boolean;
     "model": string;
@@ -82,6 +83,9 @@ export class SessionFull {
         if (!("shortName" in $$source)) {
             this["shortName"] = "";
         }
+        if (!("customName" in $$source)) {
+            this["customName"] = "";
+        }
         if (!("activity" in $$source)) {
             this["activity"] = "";
         }
@@ -156,18 +160,18 @@ export class SessionFull {
      * Creates a new SessionFull instance from a string or object.
      */
     static createFrom($$source: any = {}): SessionFull {
-        const $$createField10_0 = $$createType0;
-        const $$createField23_0 = $$createType2;
-        const $$createField24_0 = $$createType4;
+        const $$createField11_0 = $$createType0;
+        const $$createField24_0 = $$createType2;
+        const $$createField25_0 = $$createType4;
         let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
         if ("sparklineData" in $$parsedSource) {
-            $$parsedSource["sparklineData"] = $$createField10_0($$parsedSource["sparklineData"]);
+            $$parsedSource["sparklineData"] = $$createField11_0($$parsedSource["sparklineData"]);
         }
         if ("recentTools" in $$parsedSource) {
-            $$parsedSource["recentTools"] = $$createField23_0($$parsedSource["recentTools"]);
+            $$parsedSource["recentTools"] = $$createField24_0($$parsedSource["recentTools"]);
         }
         if ("recentMessages" in $$parsedSource) {
-            $$parsedSource["recentMessages"] = $$createField24_0($$parsedSource["recentMessages"]);
+            $$parsedSource["recentMessages"] = $$createField25_0($$parsedSource["recentMessages"]);
         }
         return new SessionFull($$parsedSource as Partial<SessionFull>);
     }
@@ -180,6 +184,7 @@ export class SessionItem {
     "sessionId": string;
     "cwd": string;
     "shortName": string;
+    "customName": string;
     "activity": string;
     "isActive": boolean;
     "model": string;
@@ -200,6 +205,9 @@ export class SessionItem {
         if (!("shortName" in $$source)) {
             this["shortName"] = "";
         }
+        if (!("customName" in $$source)) {
+            this["customName"] = "";
+        }
         if (!("activity" in $$source)) {
             this["activity"] = "";
         }
@@ -232,10 +240,10 @@ export class SessionItem {
      * Creates a new SessionItem instance from a string or object.
      */
     static createFrom($$source: any = {}): SessionItem {
-        const $$createField10_0 = $$createType0;
+        const $$createField11_0 = $$createType0;
         let $$parsedSource = typeof $$source === 'string' ? JSON.parse($$source) : $$source;
         if ("sparklineData" in $$parsedSource) {
-            $$parsedSource["sparklineData"] = $$createField10_0($$parsedSource["sparklineData"]);
+            $$parsedSource["sparklineData"] = $$createField11_0($$parsedSource["sparklineData"]);
         }
         return new SessionItem($$parsedSource as Partial<SessionItem>);
     }

frontend/src/bindings/github.com/nahime0/lazyagent/internal/tray/sessionservice.ts

@@ -43,6 +43,13 @@ export function GetSessionDetail(id: string): $CancellablePromise<$models.Sessio
     });
 }
 
+/**
+ * GetSessionName returns the custom name for a session.
+ */
+export function GetSessionName(sessionID: string): $CancellablePromise<string> {
+    return $Call.ByID(3799911173, sessionID);
+}
+
 /**
  * GetSessions returns all visible sessions for the list view.
  */
@@ -61,6 +68,9 @@ export function GetWindowMinutes(): $CancellablePromise<number> {
 
 /**
  * OpenInEditor opens a directory in the user's editor.
+ * It follows POSIX semantics: $VISUAL is a GUI editor (launched directly),
+ * $EDITOR is a terminal editor (opened inside a Terminal.app window).
+ * The config "editor" field is treated as VISUAL (GUI) for backward compatibility.
  */
 export function OpenInEditor(cwd: string): $CancellablePromise<void> {
     return $Call.ByID(1983870972, cwd);
@@ -80,6 +90,13 @@ export function SetSearchQuery(q: string): $CancellablePromise<void> {
     return $Call.ByID(2439661330, q);
 }
 
+/**
+ * SetSessionName stores a custom name for a session. Empty name resets it.
+ */
+export function SetSessionName(sessionID: string, name: string): $CancellablePromise<void> {
+    return $Call.ByID(602820185, sessionID, name);
+}
+
 /**
  * SetWindowMinutes updates the time window.
  */

frontend/src/lib/SessionDetail.svelte

@@ -12,27 +12,94 @@
 
   let detail = $derived($selectedDetail);
   let color = $derived(detail ? activityColor(detail.activity) : "var(--color-activity-idle)");
+  let displayName = $derived(detail ? (detail.customName || detail.shortName) : "");
+
+  let renaming = $state(false);
+  let renameValue = $state("");
+  let renameInput = $state<HTMLInputElement | null>(null);
 
   function openEditor() {
     if (detail) {
       SessionService.OpenInEditor(detail.cwd).catch(() => {});
     }
   }
+
+  function startRename() {
+    if (!detail) return;
+    renaming = true;
+    renameValue = detail.customName || "";
+    requestAnimationFrame(() => renameInput?.focus());
+  }
+
+  function confirmRename() {
+    if (detail && renaming) {
+      SessionService.SetSessionName(detail.sessionId, renameValue.trim()).catch(() => {});
+    }
+    renaming = false;
+    renameValue = "";
+  }
+
+  function cancelRename() {
+    renaming = false;
+    renameValue = "";
+  }
+
+  function handleRenameKey(e: KeyboardEvent) {
+    e.stopPropagation(); // Prevent App.svelte from intercepting rename input keys
+    if (e.key === "Enter") { e.preventDefault(); confirmRename(); }
+    else if (e.key === "Escape") { e.preventDefault(); cancelRename(); }
+  }
+
+  function handleKeydown(e: KeyboardEvent) {
+    if (renaming) return; // Already renaming, let handleRenameKey deal with it
+    const tag = (e.target as HTMLElement)?.tagName;
+    if (tag === "INPUT" || tag === "TEXTAREA") return;
+    if (e.key === "r" && detail) {
+      e.preventDefault();
+      startRename();
+    }
+  }
 </script>
 
+<svelte:window onkeydown={handleKeydown} />
+
 {#if detail}
   <div class="flex flex-col h-full overflow-y-auto px-4 py-3 gap-3">
     <!-- Header -->
     <div>
       <div class="flex items-center justify-between gap-2">
-        <h2 class="text-[15px] font-semibold text-text truncate">{detail.shortName}</h2>
-        <button
-          class="shrink-0 rounded px-2 py-1 text-[11px] font-medium text-accent bg-accent/10 hover:bg-accent/20 transition-colors no-drag"
-          onclick={openEditor}
-          title="Open in editor"
-        >
-          Open
-        </button>
+        {#if renaming}
+          <input
+            bind:this={renameInput}
+            bind:value={renameValue}
+            onkeydown={handleRenameKey}
+            onblur={confirmRename}
+            class="flex-1 min-w-0 bg-surface text-text text-[15px] font-semibold px-1 py-0 rounded border border-accent outline-none"
+            placeholder={detail.shortName}
+          />
+        {:else}
+          <h2
+            class="text-[15px] font-semibold text-text truncate cursor-pointer hover:text-accent transition-colors"
+            ondblclick={startRename}
+            title="Double-click to rename"
+          >{displayName}</h2>
+        {/if}
+        <div class="flex gap-1 shrink-0">
+          <button
+            class="rounded px-2 py-1 text-[11px] font-medium text-subtext bg-surface-hover hover:text-text transition-colors no-drag"
+            onclick={startRename}
+            title="Rename session"
+          >
+            Rename
+          </button>
+          <button
+            class="rounded px-2 py-1 text-[11px] font-medium text-accent bg-accent/10 hover:bg-accent/20 transition-colors no-drag"
+            onclick={openEditor}
+            title="Open in editor"
+          >
+            Open
+          </button>
+        </div>
       </div>
       <div class="flex items-center gap-2 mt-1">
         <ActivityBadge activity={detail.activity} isActive={detail.isActive} />