claude-code-station 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -4,7 +4,24 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.2.4] — 2026-10-21
+
+### Added
+- **Group headers (`launch: false`)** — a repos.yml entry with `launch: false` is listed as a display-only header row (`KIND=group:<name>`) for a parent folder that must not be launched; the repos inside its `path` nest under it by the existing deepest-path rule. Enter (and double-click) on a header keeps the picker open (fzf 0.45+ `transform` binding, detected from `fzf --version`; older fzf accepts the row and ccs exits quietly, like the separator). `^I` copies the header's path, `^Y` copies nothing, `^D` shows the same "edit repos.yml" note as repo rows. The preview shows the header's path, description, a not-launchable note, and its entries (display names + relative dirs). Headers carry no badges and are skipped by the repo scan. `path` is required for a header; `launch` must be a real boolean (a quoted `"false"` is rejected instead of being coerced to `true`).
+- **Display names (`label`)** — an optional `label` is shown instead of `name` in the repo row, the `‹parent›` hint and the preview title (with the `name` dimmed after it). `name` stays the unique key everywhere else; past-session rows keep showing `name`. Display-only like `description`: shell metacharacters are allowed and control characters are stripped at render time.
+
+### Changed
+- **Nested repos render as a tree** — children use `├ ` for earlier siblings and `└ ` for the last one, and deeper levels draw a `│ ` rail while an ancestor still has later siblings (previously every child used `└ `). The dim `‹parent›` hint uses the parent's display name and is omitted when it equals the row's own display name.
+- **Schema v3** — `repos.launch INTEGER NOT NULL DEFAULT 1` and `repos.label TEXT NOT NULL DEFAULT ''` (plain `ADD COLUMN`). ccs-list / ccs-preview (readonly, no migration) synthesize the defaults on a not-yet-migrated v2 cache, and 0.2.3 keeps working against a v3 cache: its repos statements name explicit columns, so the new columns take their defaults on insert and are never read.
+
+### Fixed
+- **Empty columns no longer shift the picked row** — `bin/ccs` parsed the picked row with `IFS=$'\t' read`, and TAB is IFS whitespace, so an empty column was merged away: a repo with no `description` could not be launched (`Unknown row kind`, because KIND:KEY held the cwd). Tabs are now swapped for `\x1f` before the read, which keeps empty fields.
+- A repos.yml entry without `path` no longer counts as the parent of every other repo in the list nesting (an empty path matched every absolute path as a prefix).
+
+## [0.2.3] — 2026-10-14
+
+### Added
+- **Nested repos are grouped in the list** — a repo whose `path` sits inside another listed repo's `path` now comes right after that repo, indented (`  └ 📁 child  ‹parent›`), instead of wherever its name sorts. The nearest enclosing path wins (the same deepest-path rule that maps sessions to repos), deeper nesting indents further, and siblings stay name-sorted. The dim `‹parent›` suffix keeps the relation readable when a fzf query hides the parent row, and a query for the parent's name matches its children too. Derived from `path` at list time — no `repos.yml` key and no cache migration. A disabled parent is not listed, so its children stay top-level.
 
 ## [0.2.2] — 2026-06-21
 

package/README.md

@@ -39,7 +39,7 @@ A fast, fzf-powered launcher and session picker for [Claude Code](https://docs.a
 ### Prerequisites / 前提条件
 
 - [Node.js](https://nodejs.org/) **20+**
-- [fzf](https://github.com/junegunn/fzf) **≥ 0.42.0** — fuzzy finder (the `change-header` binding used by the copy-toast requires 0.42+; released Aug 2023)
+- [fzf](https://github.com/junegunn/fzf) **≥ 0.42.0** — fuzzy finder (the `change-header` binding used by the copy-toast requires 0.42+; released Aug 2023). With **0.45+** Enter on a group header (`launch: false`) keeps the list open; on older fzf it just closes ccs without launching anything / 0.45 以上なら、グループ見出しの上で Enter を押してもリストは開いたまま（それより古い fzf では何も起動せずに閉じる）
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI (`claude`)
 - [tsx](https://github.com/privatenumber/tsx) — TypeScript runner. **Bundled** as a package dependency; a global `tsx` (`npm install -g tsx`) is only needed for the bare-checkout workflow. / npmインストール時は同梱されるため、グローバルtsxは checkout 直接運用時のみ必要
 
@@ -156,6 +156,46 @@ repos:
 
 Precedence: `repos[].command` > `defaults.command` > `$CCS_CMD` > `"claude"`.
 
+### Group headers and labels / グループ見出しと表示名
+
+For a parent folder that should only hold its children — never be launched itself — mark it `launch: false`. Its children nest under it by `path` (no extra key), and `label` gives any entry a display name of its own. / 中の子を束ねるだけで、自分は起動しない親フォルダには `launch: false` を付ける。子は `path` で自動的にその下に並ぶ（追加のキーは不要）。`label` で行に出す名前を `name` と別にできる。
+
+| Key | Type | Default | Meaning |
+|---|---|---|---|
+| `launch` | bool | `true` | `false` = display-only **group header**: listed with its children under it, but Enter does not launch it (`command`/`cwd` are ignored). `path` is still required — it decides which repos nest under the header. Must be a real boolean (`"false"` in quotes is an error). / `false` で表示だけの見出し行になる（Enter で起動しない。`command`/`cwd` は使われない）。`path` は必須（どの子がこの下に並ぶかを決める）。引用符付きの `"false"` はエラー |
+| `label` | string | `""` (show `name`) | Name shown in the repo row and the preview title instead of `name`. `name` stays the unique key (it is still what past-session rows show), so two entries may share a label. Display-only: control characters are stripped. / 行とプレビューの見出しに `name` の代わりに出す名前。一意のキーは `name` のまま（過去セッションの行も `name` で出る）なので、同じ `label` を複数の項目に付けてもよい。表示専用で、制御文字は取り除かれる |
+
+```yaml
+repos:
+  - name: Studio
+    path: ~/studio
+    launch: false               # header only — Enter does not launch ~/studio
+    icon: "🎬"
+    description: Production team
+  - name: Studio-hq
+    path: ~/studio/hq
+    label: Studio               # shown instead of "Studio-hq"
+    icon: "🎬"
+    description: Coordination hq/
+  - name: Studio-web
+    path: ~/studio/web
+    label: Web team
+    icon: "🌐"
+    description: Website web/
+  - name: Studio-app
+    path: ~/studio/app
+    label: App team
+    icon: "📱"
+    description: Mobile app/
+```
+
+```
+🎬 Studio │                    Production team         ← header: Enter does nothing
+  ├ 📱 App team  ‹Studio› │    Mobile app/
+  ├ 🎬 Studio │                Coordination hq/
+  └ 🌐 Web team  ‹Studio› │    Website web/
+```
+
 ### Preview pane sample / プレビュー表示例
 
 ```
@@ -192,9 +232,9 @@ Notion:   ✅ abc123
 
 | Key | Action |
 |---|---|
-| Enter | Launch (NEW) or resume (RESUME) / 起動または再開 |
-| Ctrl-Y | Copy `cd … && cmd [--resume …]` to clipboard; fzf stays open with a "📋 Copied" header / クリップボードコピー後もfzfは開いたまま、ヘッダーに📋通知 |
-| Ctrl-I | Copy session UUID or repo path; fzf stays open / コピー後も開いたまま |
+| Enter | Launch (NEW) or resume (RESUME); does nothing on a group header / 起動または再開（グループ見出しの上では何もしない） |
+| Ctrl-Y | Copy `cd … && cmd [--resume …]` to clipboard; fzf stays open with a "📋 Copied" header (nothing to copy on a group header) / クリップボードコピー後もfzfは開いたまま、ヘッダーに📋通知（グループ見出しはコピーする物なし） |
+| Ctrl-I | Copy session UUID or repo path (group headers too); fzf stays open / コピー後も開いたまま（グループ見出しはパス） |
 | Ctrl-R | Refresh DB and reload list / DB再走査してリロード |
 | Ctrl-D | Delete session (RESUME rows only). To remove a repo, edit `~/.config/ccs/repos.yml` directly / セッション削除はRESUME行のみ。リポ削除は`repos.yml`を直接編集 |
 | Esc / Ctrl-C | Cancel / キャンセル |
@@ -202,6 +242,15 @@ Notion:   ✅ abc123
 **Visual cues / 見た目のガイド:**
 - NEW rows and RESUME rows are separated by a dim `── Past Sessions ──` divider. Selecting the divider is a no-op.
 - RESUME sessions mapped to a registered repo show that repo's icon (e.g., `🔄 📁 ClaudeCode`). Unmapped sessions (cwd that isn't in `repos.yml`) show `❓` — a visual cue that the session was either a one-off or that the repo isn't registered yet.
+- A repo whose `path` sits inside another registered repo's `path` is listed right under that repo as a tree (`├` / `└`, with `│` continuing past deeper levels), with the parent's name dimmed at the end. Nothing to configure — the nesting follows from `path`. The dim `‹parent›` keeps the relation visible when a search hides the parent row, and searching for the parent's name lists its children too; it is left out when it would just repeat the row's own name. A parent marked `launch: false` is a [group header](#group-headers-and-labels--グループ見出しと表示名). / `path` が別の登録リポの `path` の中にあるリポは、そのリポのすぐ下にツリー（`├` / `└`、深い段は `│` でつなぐ）で並び、行の末尾に親の名前が薄く出る。設定は要らない（`path` から決まる）。絞り込みで親の行が隠れても `‹親›` で親子がわかり、親の名前で絞り込むと子も一緒に出る。行の名前と同じになる時は `‹親›` を出さない。`launch: false` の親はグループ見出しになる。
+
+  ```
+  📁 my-company
+    ├ 📁 mobile-app  ‹my-company›
+    │ └ 📁 ios  ‹mobile-app›
+    └ 📁 web-app  ‹my-company›
+  📁 side-project
+  ```
 
 ### Workflows / 主な使い方
 

package/bin/ccs

@@ -106,9 +106,10 @@ Usage:
   ccs [options]       Unknown options pass through to launched command
 
 Controls:
-  Enter               Launch (or resume) selected entry
+  Enter               Launch (or resume) selected entry; does nothing on a
+                      group header (an entry with launch: false)
   Ctrl-Y              Copy the effective shell command to clipboard
-  Ctrl-I              Copy session UUID (resume) or repo path (new)
+  Ctrl-I              Copy session UUID (resume) or repo path (new/group)
   Ctrl-R              Refresh DB and reload list
   Ctrl-D              Delete session (resume rows only)
   Esc / Ctrl-C        Cancel
@@ -230,6 +231,8 @@ if [[ -n "$CLIP_CMD" ]]; then
   # cwd/uuid are %q-quoted: the clipboard line gets pasted into a live shell,
   # so a tainted cwd must arrive as an inert literal, never as syntax (audit
   # H-1 defense-in-depth — intake sanitization in ccs-scan is the first gate).
+  # group:* (display-only header) and separator rows have no command, so
+  # nothing is built or copied for them.
   CLIP_BINDS+=(--bind "ctrl-y:execute-silent(
     kk={4}; cwd={5}; cmd={6};
     case \"\$kk\" in
@@ -237,26 +240,48 @@ if [[ -n "$CLIP_CMD" ]]; then
       new:*)    printf 'cd %q && %s' \"\$cwd\" \"\$cmd\" | ${CLIP_CMD} ;;
     esac
   )+change-header(📋 Copied command to clipboard — ⏎: launch | ^Y: copy again)")
-  # ctrl-i: copy UUID (resume) or repo path (new)
+  # ctrl-i: copy UUID (resume) or repo path (new, group header)
   CLIP_BINDS+=(--bind "ctrl-i:execute-silent(
     kk={4};
     case \"\$kk\" in
-      resume:*) printf '%s' \"\${kk#resume:}\" | ${CLIP_CMD} ;;
-      new:*)    printf '%s' {5} | ${CLIP_CMD} ;;
+      resume:*)      printf '%s' \"\${kk#resume:}\" | ${CLIP_CMD} ;;
+      new:*|group:*) printf '%s' {5} | ${CLIP_CMD} ;;
     esac
   )+change-header(📋 Copied ID/path to clipboard — ⏎: launch | ^I: copy again)")
 fi
 
-# ctrl-d: delete session (resume only). Repo (new) rows cannot be deleted
-# from ccs — repos.yml is the source of truth; edit it directly to remove.
+# ctrl-d: delete session (resume only). Repo (new) rows and group headers
+# cannot be deleted from ccs — repos.yml is the source of truth; edit it
+# directly to remove.
 DELETE_BIND=(--bind "ctrl-d:execute(
   kk={4};
   case \"\$kk\" in
-    resume:*) bash '${CCS_DELETE}' \"\${kk#resume:}\" ;;
-    new:*)    echo '[ccs] Repos can only be removed by editing ~/.config/ccs/repos.yml (press any key)'; read -r -n1 _ ;;
+    resume:*)      bash '${CCS_DELETE}' \"\${kk#resume:}\" ;;
+    new:*|group:*) echo '[ccs] Repos can only be removed by editing ~/.config/ccs/repos.yml (press any key)'; read -r -n1 _ ;;
   esac
 )+reload('${TSX}' '${CCS_LIST}'${LIST_ARGS_STR})")
 
+# enter / double-click on a group header (KIND=group, a repos.yml entry with
+# `launch: false`) keep the picker open instead of accepting the row. That
+# needs fzf's transform action (0.45+); on an older fzf the row is accepted
+# as usual and the post-selection check below exits quietly, like the
+# separator row. The `transform:` form takes the rest of the string as its
+# argument, so the `)` of the case patterns cannot end it early. fzf runs the
+# command with $SHELL -c; the test itself goes through `bash -c` so a
+# non-POSIX login shell (fish) cannot break Enter on every row.
+fzf_has_transform() {
+  local v
+  v=$(fzf --version 2>/dev/null) || return 1
+  [[ "$v" =~ ^([0-9]+)\.([0-9]+) ]] || return 1
+  (( 10#${BASH_REMATCH[1]} > 0 || 10#${BASH_REMATCH[2]} >= 45 ))
+}
+GROUP_BINDS=()
+if fzf_has_transform; then
+  for key in enter double-click; do
+    GROUP_BINDS+=(--bind "${key}:transform:bash -c 'case \$1 in group:*) echo ignore ;; *) echo accept ;; esac' _ {4}")
+  done
+fi
+
 # ctrl-r: force refresh
 REFRESH_BIND=(--bind "ctrl-r:execute('${TSX}' '${CCS_SCAN}' --force --quiet)+reload('${TSX}' '${CCS_LIST}'${LIST_ARGS_STR})")
 
@@ -280,6 +305,7 @@ SELECTED=$("${TSX}" "${CCS_LIST}" "${LIST_FLAGS[@]+"${LIST_FLAGS[@]}"}" | fzf \
   "${CLIP_BINDS[@]+"${CLIP_BINDS[@]}"}" \
   "${DELETE_BIND[@]}" \
   "${REFRESH_BIND[@]}" \
+  "${GROUP_BINDS[@]+"${GROUP_BINDS[@]}"}" \
   --height='80%' \
   --layout=reverse \
   --border \
@@ -293,7 +319,13 @@ SELECTED=$("${TSX}" "${CCS_LIST}" "${LIST_FLAGS[@]+"${LIST_FLAGS[@]}"}" | fzf \
 # 6-col TSV from ccs-list.ts: LABEL, DESCRIPTION, BADGES, KIND:KEY, CWD, COMMAND.
 # Use IFS-based read so values are never resplit by shell word-splitting
 # (H6 fix). The three `_` placeholders skip columns 1-3.
-IFS=$'\t' read -r _ _ _ KIND_KEY ROW_CWD ROW_CMD <<< "$SELECTED"
+# Tabs are swapped for US (\x1f) first: TAB is IFS whitespace, so a plain
+# `IFS=$'\t' read` merges runs of tabs, and an empty column (a repo without a
+# description, a group header's empty BADGES) shifted every later field —
+# KIND_KEY came back holding the cwd. \x1f is not IFS whitespace, so empty
+# fields survive, and it never occurs inside a row: every column is stripped
+# of (or rejected for) control characters upstream.
+IFS=$'\x1f' read -r _ _ _ KIND_KEY ROW_CWD ROW_CMD <<< "${SELECTED//$'\t'/$'\x1f'}"
 
 if [[ -z "$KIND_KEY" ]]; then
   echo "❌ Could not parse selection" >&2
@@ -303,9 +335,11 @@ fi
 KIND="${KIND_KEY%%:*}"
 KEY="${KIND_KEY#*:}"
 
-# Separator row is a non-actionable divider (empty ROW_CWD/ROW_CMD by design).
+# Separator row is a non-actionable divider (empty ROW_CWD/ROW_CMD by design),
+# and a group header (`launch: false`) is display-only (empty ROW_CMD) — it
+# only gets here when the enter binding above is unavailable (fzf < 0.45).
 # Short-circuit here so the downstream ROW_CMD empty-check doesn't misfire.
-[[ "$KIND" == "separator" ]] && exit 0
+[[ "$KIND" == "separator" || "$KIND" == "group" ]] && exit 0
 
 if [[ -z "$ROW_CMD" ]]; then
   echo "❌ Could not parse selection" >&2
@@ -335,9 +369,9 @@ case "$KIND" in
       exit 1
     fi
     ;;
-  separator)
-    # Defensive: separator should already be short-circuited above. Kept as
-    # a safety net in case row-parse order ever changes.
+  separator|group)
+    # Defensive: separator/group should already be short-circuited above.
+    # Kept as a safety net in case row-parse order ever changes.
     exit 0
     ;;
   *)
@@ -348,7 +382,7 @@ esac
 
 # Path validation (traversal prevention). Must be $HOME itself or a child
 # path ("$HOME"/*): a bare prefix match would also accept sibling dirs like
-# /Users/daiskeEVIL (audit L-1).
+# /Users/xEVIL (audit L-1).
 if [[ "$ROW_CWD" != "$HOME" && "$ROW_CWD" != "$HOME"/* ]]; then
   echo "⚠️  cwd is outside \$HOME: ${ROW_CWD}" >&2
   echo "Launching in current directory instead." >&2

package/bin/ccs-config.ts

@@ -34,6 +34,10 @@ export interface RepoEntry {
   disabled: boolean;
   scan: boolean;
   icon: string;
+  /** false = display-only group header: listed, never launched. */
+  launch: boolean;
+  /** Display name for the NEW row / preview ("" = show `name`). */
+  label: string;
   custom: Record<string, unknown>;
   configHash: string;
 }
@@ -74,6 +78,8 @@ const KNOWN_REPO_KEYS = new Set([
   "disabled",
   "scan",
   "icon",
+  "launch",
+  "label",
   "custom",
 ]);
 
@@ -304,6 +310,27 @@ function resolveRepoEntry(
   const disabled =
     raw.disabled === undefined ? false : Boolean(raw.disabled);
 
+  // launch — `launch: false` makes the entry a display-only group header:
+  // listed, with the repos inside its path nested under it, but never
+  // launched. Strictly typed, unlike disabled/scan: Boolean("false") is true,
+  // so a quoted value would silently turn the header back into a launcher.
+  let launch = true;
+  if (raw.launch !== undefined) {
+    if (typeof raw.launch !== "boolean") {
+      throw new ConfigError(
+        `${reposYmlPath}: repos[${index}].launch must be true or false (got ${JSON.stringify(raw.launch)})`,
+      );
+    }
+    launch = raw.launch;
+  }
+  // A header exists to hold its children, which nest by path — without one
+  // it would have nothing under it (command/cwd, by contrast, go unused).
+  if (!launch && raw.path === undefined) {
+    throw new ConfigError(
+      `${reposYmlPath}: repos[${index}].path is required when launch is false`,
+    );
+  }
+
   // path
   let resolvedPath = "";
   if (raw.path !== undefined) {
@@ -366,6 +393,22 @@ function resolveRepoEntry(
   const description =
     raw.description === undefined ? "" : String(raw.description);
 
+  // label — display name for the NEW row and the preview title; `name` stays
+  // the unique key (row key, DB, session rows). Display-only like
+  // description: it never reaches a shell line (bin/ccs skips the LABEL
+  // column; no fzf binding references it), so shell metachars are allowed
+  // ("R&D", "Dad's notes") and control chars are stripped at render time
+  // (repoDisplayName -> truncate). A blank `label:` (YAML null) means unset.
+  let label = "";
+  if (raw.label !== undefined && raw.label !== null) {
+    if (typeof raw.label !== "string") {
+      throw new ConfigError(
+        `${reposYmlPath}: repos[${index}].label must be a string`,
+      );
+    }
+    label = raw.label;
+  }
+
   // tags
   let tags: string[] = [];
   if (raw.tags !== undefined) {
@@ -412,6 +455,8 @@ function resolveRepoEntry(
     disabled,
     scan,
     icon,
+    launch,
+    label,
     custom,
     configHash: hashEntry(raw),
   };

package/bin/ccs-db.ts

@@ -13,7 +13,7 @@ import Database from "better-sqlite3";
 import { mkdirSync, chmodSync, existsSync } from "node:fs";
 import { dirname } from "node:path";
 
-export const CURRENT_SCHEMA_VERSION = 2;
+export const CURRENT_SCHEMA_VERSION = 3;
 
 export interface DbHandle {
   db: Database.Database;
@@ -37,6 +37,10 @@ export interface RepoRow {
   icon: string;
   disabled: 0 | 1;
   scan_enabled: 0 | 1;
+  /** schema v3: 0 = display-only group header (repos.yml `launch: false`). */
+  launch: 0 | 1;
+  /** schema v3: repos.yml `label` ("" = display `name`). */
+  label: string;
   custom_json: string;
   config_hash: string;
   created_at: string;
@@ -160,10 +164,23 @@ CREATE TABLE IF NOT EXISTS meta (
 );
 `;
 
+// v3: repos.yml `launch` / `label` (display-only group headers and display
+// names). Plain ADD COLUMN with defaults, so older ccs builds keep working
+// against a v3 cache: their INSERTs name explicit columns (the new ones take
+// the defaults) and their SELECTs name explicit columns (the new ones are
+// never read). The other direction — a v3 reader (ccs-list/ccs-preview,
+// readonly+skipMigrate) meeting a not-yet-migrated v2 cache — goes through
+// reposV3Columns().
+const MIGRATION_V3 = `
+ALTER TABLE repos ADD COLUMN launch INTEGER NOT NULL DEFAULT 1;
+ALTER TABLE repos ADD COLUMN label  TEXT    NOT NULL DEFAULT '';
+`;
+
 const migrations: Migration[] = [
   { version: 1, up: MIGRATION_V1 },
   { version: 2, up: MIGRATION_V2 },
-  // future: { version: 3, up: `...` },
+  { version: 3, up: MIGRATION_V3 },
+  // future: { version: 4, up: `...` },
 ];
 
 // ---------------------------------------------------------------------------
@@ -291,7 +308,10 @@ export function openDb(
 // Repo helpers (used by ccs-scan.ts to sync repos.yml -> DB)
 // ---------------------------------------------------------------------------
 
-type RepoInsert = Omit<RepoRow, "created_at" | "updated_at">;
+// launch/label (schema v3) are optional and default to a plain launchable
+// entry, matching the column defaults.
+type RepoInsert = Omit<RepoRow, "created_at" | "updated_at" | "launch" | "label"> &
+  Partial<Pick<RepoRow, "launch" | "label">>;
 
 export function upsertRepo(db: Database.Database, row: RepoInsert): void {
   // Update updated_at only when config_hash changes; created_at is preserved
@@ -299,11 +319,11 @@ export function upsertRepo(db: Database.Database, row: RepoInsert): void {
   const stmt = db.prepare(`
     INSERT INTO repos (
       name, path, description, command, cwd, tags_json, icon,
-      disabled, scan_enabled, custom_json, config_hash,
+      disabled, scan_enabled, launch, label, custom_json, config_hash,
       created_at, updated_at
     ) VALUES (
       @name, @path, @description, @command, @cwd, @tags_json, @icon,
-      @disabled, @scan_enabled, @custom_json, @config_hash,
+      @disabled, @scan_enabled, @launch, @label, @custom_json, @config_hash,
       datetime('now'), datetime('now')
     )
     ON CONFLICT(name) DO UPDATE SET
@@ -315,6 +335,8 @@ export function upsertRepo(db: Database.Database, row: RepoInsert): void {
       icon         = excluded.icon,
       disabled     = excluded.disabled,
       scan_enabled = excluded.scan_enabled,
+      launch       = excluded.launch,
+      label        = excluded.label,
       custom_json  = excluded.custom_json,
       config_hash  = excluded.config_hash,
       updated_at   = CASE
@@ -323,14 +345,14 @@ export function upsertRepo(db: Database.Database, row: RepoInsert): void {
         ELSE repos.updated_at
       END
   `);
-  stmt.run(row);
+  stmt.run({ ...row, launch: row.launch ?? 1, label: row.label ?? "" });
 }
 
 export function getAllRepos(db: Database.Database): RepoRow[] {
   return db
     .prepare(
       `SELECT name, path, description, command, cwd, tags_json, icon,
-              disabled, scan_enabled, custom_json, config_hash,
+              disabled, scan_enabled, launch, label, custom_json, config_hash,
               created_at, updated_at
        FROM repos
        ORDER BY name`,
@@ -338,6 +360,28 @@ export function getAllRepos(db: Database.Database): RepoRow[] {
     .all() as RepoRow[];
 }
 
+/**
+ * SELECT-list fragment for the schema-v3 repos columns, `launch, label`,
+ * qualified with `alias` when given.
+ *
+ * ccs-list and ccs-preview open the DB readonly+skipMigrate, so they can meet
+ * a v2 cache that predates migration v3 (`ccs --no-scan` right after an
+ * upgrade, or a pre-scan that failed). There the columns are synthesized with
+ * their defaults, and every repo renders exactly as it did on v2: launchable,
+ * no label. Same degrade-don't-crash rule as getMeta() for the v2 meta table.
+ */
+export function reposV3Columns(db: Database.Database, alias = ""): string {
+  const have = new Set(
+    (db.prepare(`PRAGMA table_info(repos)`).all() as Array<{ name: string }>)
+      .map((c) => c.name),
+  );
+  const q = alias ? `${alias}.` : "";
+  return [
+    have.has("launch") ? `${q}launch` : `1 AS launch`,
+    have.has("label") ? `${q}label` : `'' AS label`,
+  ].join(", ");
+}
+
 /**
  * Delete a single session row by UUID using a bound parameter.
  *

package/bin/ccs-init.ts

@@ -276,7 +276,12 @@ async function main(): Promise<number> {
 
 if (import.meta.url === `file://${process.argv[1]}`) {
   main().then(
-    (code) => process.exit(code),
+    // exitCode, not process.exit(): bin/ccs captures discover's candidates
+    // with $(...), a pipe, and exiting right after the writes dropped every
+    // candidate past the pipe buffer (same bug as ccs-list, 2026-10-07).
+    (code) => {
+      process.exitCode = code;
+    },
     (err) => {
       process.stderr.write(
         `[ccs-init] fatal: ${err instanceof Error ? err.message : String(err)}\n`,

package/bin/ccs-list.ts

@@ -5,18 +5,28 @@
  * Outputs tab-separated rows for fzf consumption:
  *   <LABEL>\t<DESCRIPTION>\t<BADGES>\t<KIND>:<KEY>\t<CWD>\t<COMMAND>
  *
+ * KIND is `new` (launchable repo), `group` (display-only header, repos.yml
+ * `launch: false`), `resume` (past session) or `separator`.
+ *
  * Modes:
  *   --current-only    sessions whose cwd matches process.cwd()
- *   --repos-only      only NEW repo rows
+ *   --repos-only      only NEW repo rows (and group headers)
  *   --sessions-only   only RESUME session rows
- *   (default)         NEW first (alpha), then RESUME (last_activity_at DESC)
+ *   (default)         NEW first (alpha, nested repos in a tree under their
+ *                     parent), then RESUME (last_activity_at DESC)
  */
 
 import { homedir } from "node:os";
-import { openDb, getMeta } from "./ccs-db.ts";
+import { openDb, getMeta, reposV3Columns } from "./ccs-db.ts";
 import { getPaths } from "./ccs-config.ts";
 import { SHELL_METACHARS } from "./ccs-sanitize.ts";
-import { truncate, formatRelativeTime, formatDateTime } from "./ccs-utils.ts";
+import {
+  truncate,
+  formatRelativeTime,
+  formatDateTime,
+  repoDisplayName,
+  findParentRepo,
+} from "./ccs-utils.ts";
 
 // ---------------------------------------------------------------------------
 // Constants
@@ -115,6 +125,8 @@ interface RepoRowFull {
   icon: string;
   disabled: number;
   scan_enabled: number;
+  launch: number;
+  label: string;
   custom_json: string;
   // stats (LEFT JOINed, may be null)
   is_git: number | null;
@@ -175,9 +187,66 @@ function buildRepoBadges(r: RepoRowFull): string {
 // invoked with --ansi so these codes render as styling.
 const LABEL_SEP = " \x1b[2m│\x1b[0m";
 
-function repoToRow(r: RepoRowFull): string {
-  const label = `${r.icon || "📁"} ${r.name}${LABEL_SEP}`;
+interface GroupedRepo {
+  repo: RepoRowFull;
+  parent: RepoRowFull | null;
+  /** Tree glyphs drawn before the icon ("" at the top level). */
+  prefix: string;
+}
+
+// Nest each repo under the listed repo whose path most deeply contains its
+// own — the same deepest-path-wins rule buildRepoResolver uses for sessions
+// (findParentRepo), so no repos.yml key is needed. Children follow their
+// parent, siblings keep the incoming (SQL, name-sorted) order. A disabled
+// parent is not in the list, so its children move up to the next listed
+// ancestor (or the top level).
+//
+// Children are drawn as a tree: `├ ` for a sibling with more after it, `└ `
+// for the last one, and for every ancestor level below the top a `│ ` rail
+// while that ancestor still has later siblings (blank once it was the last).
+function groupRepos(repos: RepoRowFull[]): GroupedRepo[] {
+  const children = new Map<RepoRowFull | null, RepoRowFull[]>();
+  for (const r of repos) {
+    const parent = findParentRepo(r, repos);
+    const siblings = children.get(parent) ?? [];
+    siblings.push(r);
+    children.set(parent, siblings);
+  }
+  const out: GroupedRepo[] = [];
+  const walk = (parent: RepoRowFull | null, rails: string): void => {
+    const kids = children.get(parent) ?? [];
+    kids.forEach((r, i) => {
+      const last = i === kids.length - 1;
+      const prefix = parent ? `  ${rails}${last ? "└ " : "├ "}` : "";
+      out.push({ repo: r, parent, prefix });
+      // Top-level repos draw no glyph of their own, so they add no rail.
+      walk(r, parent ? rails + (last ? "  " : "│ ") : "");
+    });
+  };
+  walk(null, "");
+  return out;
+}
+
+function repoToRow({ repo: r, parent, prefix }: GroupedRepo): string {
+  // Rows show the repos.yml `label` when set (repoDisplayName); `name` stays
+  // the row key. The dim ‹parent› suffix keeps the relation readable when a
+  // fzf query hides the parent row, and lets a query for the parent's name
+  // match its children too. It is dropped when it would only repeat the
+  // row's own name (an entry labelled `Studio` under a `Studio` header).
+  const displayName = repoDisplayName(r);
+  const parentName = parent ? repoDisplayName(parent) : null;
+  const parentHint =
+    parentName && parentName !== displayName
+      ? `  \x1b[2m‹${parentName}›\x1b[0m`
+      : "";
+  const label = `${prefix}${r.icon || "📁"} ${displayName}${parentHint}${LABEL_SEP}`;
   const desc = truncate(r.description || "", DESC_MAX);
+  if (r.launch === 0) {
+    // Group header (`launch: false`): display-only, so no badges (the header
+    // is not scanned) and no COMMAND. CWD carries the path for ^I and the
+    // preview; bin/ccs never launches a `group:` row.
+    return [label, desc, "", `group:${r.name}`, r.path, ""].join("\t");
+  }
   const badges = buildRepoBadges(r);
   const cwd = r.cwd && r.cwd.length > 0 ? r.cwd : r.path;
   const command = r.command || "claude";
@@ -204,7 +273,9 @@ interface SessionRowFull {
 }
 
 function sessionToRow(s: SessionRowFull, defaultCommand: string): string {
-  // Mapped sessions use the registered repo icon + name.
+  // Mapped sessions use the registered repo icon + name — the unique `name`,
+  // deliberately not the repos.yml `label`, so session rows read the same as
+  // before labels existed.
   // Unmapped sessions get ❓ as a visible reminder: either a one-off run
   // or a repo that hasn't been added to repos.yml yet.
   // Ternary tests s.repo_display directly so TS narrows string|null → string
@@ -258,10 +329,12 @@ function main(): number {
     const wantSessions = !flags.reposOnly;
 
     if (wantRepos) {
+      // launch/label come from schema v3; reposV3Columns() synthesizes the
+      // defaults when this readonly connection meets a v2 cache.
       const repos = db
         .prepare(
           `SELECT r.name, r.path, r.description, r.command, r.cwd, r.icon,
-                  r.disabled, r.scan_enabled, r.custom_json,
+                  r.disabled, r.scan_enabled, ${reposV3Columns(db, "r")}, r.custom_json,
                   s.is_git, s.branch, s.uncommitted_insertions,
                   s.uncommitted_deletions, s.handoff_count, s.pending_count,
                   s.session_last_at
@@ -271,8 +344,8 @@ function main(): number {
             ORDER BY r.name COLLATE NOCASE ASC`,
         )
         .all() as RepoRowFull[];
-      for (const r of repos) {
-        lines.push(repoToRow(r));
+      for (const g of groupRepos(repos)) {
+        lines.push(repoToRow(g));
       }
     }
 
@@ -359,5 +432,18 @@ function main(): number {
 }
 
 if (import.meta.url === `file://${process.argv[1]}`) {
-  process.exit(main());
+  // exitCode, not process.exit(): stdout is a pipe into fzf, and pipe writes
+  // are async on macOS. Exiting right after the write dropped everything past
+  // the pipe buffer — as little as 512 bytes, so the list ended after 3 repos
+  // (2026-10-07). Returning lets Node flush the whole list first.
+  //
+  // The flip side: fzf may exit (pick / Esc) before reading every row, and
+  // the pending write then fails with EPIPE. Those rows have no reader, so
+  // end quietly with main()'s status — an unhandled EPIPE would print a stack
+  // trace and exit 1, which pipefail in bin/ccs turns into a dropped launch.
+  process.stdout.on("error", (err: NodeJS.ErrnoException) => {
+    if (err.code === "EPIPE") process.exit(process.exitCode ?? 0);
+    throw err;
+  });
+  process.exitCode = main();
 }

package/bin/ccs-preview.ts

@@ -4,19 +4,23 @@
  *
  * Invoked by fzf as: tsx bin/ccs-preview.ts <KIND:KEY> <CWD>
  *   KIND=new     → render repo preview (DB-backed state summary)
+ *   KIND=group   → render group-header preview (path + nested entries)
  *   KIND=resume  → delegate to renderSessionPreview (conversation history)
  *
  * All errors print to stdout (fzf reads stdout for preview) and exit 0.
  */
 
 import { existsSync } from "node:fs";
+import { relative } from "node:path";
 import { getPaths } from "./ccs-config.ts";
-import { openDb, type DbHandle } from "./ccs-db.ts";
+import { openDb, reposV3Columns, type DbHandle } from "./ccs-db.ts";
 import { renderSessionPreview } from "./ccs-preview-session.ts";
 import {
   formatRelativeTime,
   formatDateTime,
   truncate,
+  repoDisplayName,
+  findParentRepo,
 } from "./ccs-utils.ts";
 
 // ---------------------------------------------------------------------------
@@ -60,10 +64,20 @@ interface RepoView {
   path: string;
   description: string;
   icon: string;
+  label: string;
   tags_json: string;
   custom_json: string;
 }
 
+interface GroupMemberView {
+  name: string;
+  path: string;
+  description: string;
+  icon: string;
+  launch: number;
+  label: string;
+}
+
 interface StatsView {
   is_git: number;
   branch: string | null;
@@ -167,7 +181,8 @@ function renderRepoPreview(name: string, cwd: string): void {
 
     const repo = db
       .prepare(
-        `SELECT name, path, description, icon, tags_json, custom_json
+        `SELECT name, path, description, icon, tags_json, custom_json,
+                ${reposV3Columns(db)}
          FROM repos WHERE name = ?`,
       )
       .get(name) as RepoView | undefined;
@@ -191,7 +206,12 @@ function renderRepoPreview(name: string, cwd: string): void {
       .get(name) as StatsView | undefined;
 
     // --- Header ---
-    console.log(`${hdr(`${repo.icon || "📁"} ${repo.name}`)}`);
+    // Titled with the repos.yml `label` like the list row; when one is set,
+    // the dim `name` after it ties the entry to its session rows, which keep
+    // showing the name.
+    const displayName = repoDisplayName(repo);
+    const nameHint = displayName !== repo.name ? `  ${dim(`(${repo.name})`)}` : "";
+    console.log(`${hdr(`${repo.icon || "📁"} ${displayName}`)}${nameHint}`);
     console.log(dim(repo.path));
     if (repo.description) console.log(repo.description);
     console.log("");
@@ -322,6 +342,84 @@ function renderRepoPreview(name: string, cwd: string): void {
   }
 }
 
+// ---------------------------------------------------------------------------
+// Group-header preview (repos.yml `launch: false`)
+// ---------------------------------------------------------------------------
+
+function renderGroupPreview(name: string, cwd: string): void {
+  const paths = getPaths();
+  if (!existsSync(paths.stateDb)) {
+    console.log(`${hdr("📁 " + name)}`);
+    console.log(dim(cwd || ""));
+    console.log("");
+    console.log("No state cache yet — run `ccs --refresh` to scan.");
+    return;
+  }
+
+  let handle: DbHandle | null = null;
+  try {
+    handle = openDb(paths.stateDb, { readonly: true, skipMigrate: true });
+    const db = handle.db;
+
+    // The listed (enabled) repos, in list order: children are resolved with
+    // the same findParentRepo rule over the same population as ccs-list, so
+    // the entries here are exactly the rows drawn under the header.
+    const listed = db
+      .prepare(
+        `SELECT name, path, description, icon, ${reposV3Columns(db)}
+         FROM repos WHERE disabled = 0
+         ORDER BY name COLLATE NOCASE ASC`,
+      )
+      .all() as GroupMemberView[];
+    const group = listed.find((r) => r.name === name);
+
+    if (!group) {
+      console.log(`${hdr("📁 " + name)}`);
+      console.log(dim(cwd || ""));
+      console.log("");
+      console.log(`Group "${name}" not found in cache.`);
+      return;
+    }
+
+    console.log(`${hdr(`${group.icon || "📁"} ${repoDisplayName(group)}`)}`);
+    console.log(dim(group.path));
+    if (group.description) console.log(truncate(group.description, 200));
+    console.log("");
+
+    console.log(divider("Group"));
+    console.log("Group header (launch: false) — not launchable.");
+    console.log("Pick one of the entries below to start a session.");
+    console.log("");
+
+    const entries = listed.filter(
+      (r) => r !== group && findParentRepo(r, listed) === group,
+    );
+    console.log(divider(`Entries (${entries.length})`));
+    if (entries.length === 0) {
+      console.log("No repos inside this path yet.");
+      return;
+    }
+    const names = entries.map((r) => repoDisplayName(r));
+    const width = Math.max(...names.map((n) => n.length));
+    entries.forEach((r, i) => {
+      const rel = truncate(relative(group.path, r.path), 60) + "/";
+      const tag = r.launch === 0 ? `  ${dim("(group)")}` : "";
+      console.log(`  ${r.icon || "📁"} ${names[i].padEnd(width)}  ${dim(rel)}${tag}`);
+    });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.log(`${hdr("📁 " + name)}`);
+    console.log("");
+    console.log(`Preview error: ${msg}`);
+  } finally {
+    try {
+      handle?.close();
+    } catch {
+      // ignore
+    }
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Main dispatcher
 // ---------------------------------------------------------------------------
@@ -348,6 +446,8 @@ async function main(): Promise<void> {
       await renderSessionPreview(key);
     } else if (kind === "new") {
       renderRepoPreview(key, cwd);
+    } else if (kind === "group") {
+      renderGroupPreview(key, cwd);
     } else if (kind === "separator") {
       // Divider row — intentionally blank preview.
       return;

package/bin/ccs-scan.ts

@@ -144,6 +144,8 @@ function syncReposToDb(
         icon: r.icon,
         disabled: r.disabled ? 1 : 0,
         scan_enabled: r.scan ? 1 : 0,
+        launch: r.launch ? 1 : 0,
+        label: r.label,
         custom_json: JSON.stringify(r.custom),
         config_hash: r.configHash,
       });
@@ -520,8 +522,11 @@ async function scanAllRepos(
     preserveSessionAgg: boolean;
   },
 ): Promise<ReposScanSummary> {
+  // Group headers (`launch: false`) are skipped too: their list row carries
+  // no badges and their preview shows only the group, so git/workspace stats
+  // for the header's own path would never be displayed.
   const allRepos = getAllRepos(db).filter(
-    (r) => r.disabled === 0 && r.scan_enabled === 1,
+    (r) => r.disabled === 0 && r.scan_enabled === 1 && r.launch === 1,
   );
 
   // TTL check: read existing scanned_at per repo

package/bin/ccs-utils.ts

@@ -1,12 +1,12 @@
 /**
  * ccs-utils.ts — Shared helpers for ccs scan/list/preview modules.
  *
- * Single source of truth for display-text truncation, relative-time
- * bucketing, JSONL message-content extraction, and cross-module constants
- * (review A-1/A-2/A-3/K-8). Before this module existed, each renderer kept
- * its own copy of these helpers with "keep in sync" comments — and they
- * drifted. Behavioral differences must now be expressed as explicit options,
- * never as parallel implementations.
+ * Single source of truth for display-text truncation, repo display names and
+ * nesting, relative-time bucketing, JSONL message-content extraction, and
+ * cross-module constants (review A-1/A-2/A-3/K-8). Before this module
+ * existed, each renderer kept its own copy of these helpers with "keep in
+ * sync" comments — and they drifted. Behavioral differences must now be
+ * expressed as explicit options, never as parallel implementations.
  */
 
 import { stripControlChars } from "./ccs-sanitize.ts";
@@ -46,6 +46,52 @@ export function truncate(s: string, max: number): string {
   return flat.length <= max ? flat : flat.slice(0, max - 1) + "…";
 }
 
+// ---------------------------------------------------------------------------
+// Repo display name & nesting
+// ---------------------------------------------------------------------------
+
+/** Display cap for repos.yml `label` (it is a name, not a sentence). */
+export const LABEL_MAX = 40;
+
+/**
+ * Name shown for a repo in the NEW row and the repo/group preview: the
+ * repos.yml `label` when set, else the unique `name`. The label is
+ * display-only (never part of a row key or a shell line), so like
+ * `description` it is not rejected at load time — control chars are stripped
+ * here by truncate(). A label that strips down to nothing falls back to name.
+ */
+export function repoDisplayName(r: { name: string; label?: string | null }): string {
+  return truncate(r.label ?? "", LABEL_MAX) || r.name;
+}
+
+/**
+ * True when `child` sits strictly inside `parent` (path-segment aware). An
+ * empty parent (a repos.yml entry without `path`) contains nothing — as a
+ * bare prefix it would have claimed every absolute path.
+ */
+export function isUnderPath(child: string, parent: string): boolean {
+  if (!parent) return false;
+  return child.startsWith(parent.endsWith("/") ? parent : parent + "/");
+}
+
+/**
+ * The repo in `repos` whose path most deeply contains `repo`'s own — the
+ * deepest-path-wins rule buildRepoResolver uses for sessions. Shared by the
+ * list tree (ccs-list) and the group preview (ccs-preview) so the two can
+ * never disagree on whose child a repo is. Null for a top-level repo.
+ */
+export function findParentRepo<T extends { path: string }>(
+  repo: T,
+  repos: T[],
+): T | null {
+  let parent: T | null = null;
+  for (const p of repos) {
+    if (p === repo || !isUnderPath(repo.path, p.path)) continue;
+    if (!parent || p.path.length > parent.path.length) parent = p;
+  }
+  return parent;
+}
+
 // ---------------------------------------------------------------------------
 // Time formatting
 // ---------------------------------------------------------------------------

package/docs/design/repos-yml-schema.md

@@ -24,7 +24,7 @@ repos:                        # リポジトリ定義配列（必須、1件以
 
 | フィールド | 型 | 必須 | デフォルト | 説明 |
 |---|---|:---:|---|---|
-| `name` | string | ✅ | — | 表示名（fzf行に出る、日本語可） |
+| `name` | string | ✅ | — | 一意のキー兼、既定の表示名（fzf行に出る、日本語可）。`label` があれば新規起動行とプレビューは `label` を出す。過去セッションの行は常に `name` |
 | `path` | string | ✅* | — | リポジトリのフルパス。`~` 展開あり |
 | `description` | string | — | `""` | プレビュー補助情報 |
 | `command` | string | — | `defaults.command` or `claude` | 起動コマンド。特殊な場合は丸ごと上書き |
@@ -33,9 +33,11 @@ repos:                        # リポジトリ定義配列（必須、1件以
 | `disabled` | bool | — | `false` | true ならリストから除外 |
 | `scan` | bool | — | `true` | false なら状態走査をスキップ（非git含む） |
 | `icon` | string | — | `📁` | 表示アイコン（絵文字1文字推奨） |
+| `launch` | bool | — | `true` | false なら表示だけのグループ見出し（行の種類 `group:<name>`）。Enter で起動しない・バッジなし・状態走査しない。`command`/`cwd` は使われない。`path` の中のリポがこの下に並ぶ。真偽値のみ（`"false"` などの文字列はエラー） |
+| `label` | string | — | `""` | 新規起動行・`‹親›` の表示・プレビュー見出しに `name` の代わりに出す名前。表示専用（シェルメタ文字は可、制御文字は表示時に除去）。空・空白だけなら `name` |
 | `custom` | object | — | `{}` | 外部システム連携情報。任意のキー/値ペア（後述） |
 
-\* `path` は `command` に `cwd:` が含まれる特殊ケースを除き必須。
+\* `path` は `command` に `cwd:` が含まれる特殊ケースを除き必須。`launch: false` の項目では常に必須（無いとエラー）。
 
 ### `custom` フィールド（外部システム連携）
 
@@ -107,6 +109,9 @@ repos:
 | `defaults.command`（CCS_CMD/CCR_CMD 由来含む）もロード時に同検証（レビューA-6） | `~/.config/ccs/repos.yml: defaults.command (resolved from defaults.command / CCS_CMD / CCR_CMD) contains shell metacharacter(s): "..."` |
 | `custom` のJSONサイズ 64KB 上限 | `~/.config/ccs/repos.yml: repos[0].custom exceeds 64KB JSON size limit` |
 | `disabled: true` の場合 scan/command 無視 | — |
+| `launch` は真偽値のみ（`Boolean()` で丸めない: `"false"` が true になるのを防ぐ） | `~/.config/ccs/repos.yml: repos[0].launch must be true or false (got "false")` |
+| `launch: false` は `path` 必須 | `~/.config/ccs/repos.yml: repos[0].path is required when launch is false` |
+| `label` は文字列のみ（空の `label:` = YAML の null は未指定扱い） | `~/.config/ccs/repos.yml: repos[0].label must be a string` |
 
 ## 例1: シンプル
 

package/docs/design/sqlite-schema.md

@@ -59,8 +59,14 @@ CREATE TABLE repos (
 
 CREATE INDEX idx_repos_path ON repos(path);
 CREATE INDEX idx_repos_disabled ON repos(disabled);
+
+-- v3: repos.yml の launch / label（ADD COLUMN なので列は表の末尾に付く）
+ALTER TABLE repos ADD COLUMN launch INTEGER NOT NULL DEFAULT 1; -- 0 = 表示だけのグループ見出し
+ALTER TABLE repos ADD COLUMN label  TEXT    NOT NULL DEFAULT ''; -- 表示名（空なら name）
 ```
 
+v3 の列の互換: 古い版（0.2.3 以前）は repos の INSERT/SELECT で列名を明示しているので、v3 のキャッシュでも動く（新しい列は INSERT で既定値になり、SELECT では読まれない）。逆に readonly・マイグレーションなしで開く ccs-list / ccs-preview が v2 のキャッシュに当たった時は、`reposV3Columns()` が `1 AS launch, '' AS label` で既定値を補う（`getMeta` と同じ「落ちずに既定値へ」の扱い）。
+
 ### repo_stats
 
 ```sql
@@ -168,6 +174,7 @@ CREATE TABLE meta (
 |---------|---------|---------|
 | 1 | v0.2.0 init | 初期テーブル群（repos, repo_stats, sessions, handoff_files, pending_items） |
 | 2 | 2026-06-12 レビュークリーンアップ（v0.2.1） | meta テーブル追加（キー/値ストア、defaults_command 保存用） |
+| 3 | 2026-10-21 グループ見出しと表示名（未リリース） | repos に `launch`（既定 1）・`label`（既定 ''）を追加 |
 
 ## 走査フロー
 
@@ -202,7 +209,8 @@ ccs 起動
 const migrations = [
   { version: 1, up: `CREATE TABLE schema_version (...); ...初期DDL...` },
   { version: 2, up: `CREATE TABLE meta (...);` },
-  // 以降 version: 3, 4, ... を追加
+  { version: 3, up: `ALTER TABLE repos ADD COLUMN launch ...; ALTER TABLE repos ADD COLUMN label ...;` },
+  // 以降 version: 4, 5, ... を追加
 ];
 
 function migrate(db: Database) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-station",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Claude Code Station — fzf-powered launcher and session picker for Claude Code with multi-repo support and SQLite-backed state cache",
   "type": "module",
   "bin": {