claude-mux 0.7.0

package/.beads/README.md

@@ -0,0 +1,81 @@
+# Beads - AI-Native Issue Tracking
+
+Welcome to Beads! This repository uses **Beads** for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
+
+## What is Beads?
+
+Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
+
+**Learn more:** [github.com/steveyegge/beads](https://github.com/steveyegge/beads)
+
+## Quick Start
+
+### Essential Commands
+
+```bash
+# Create new issues
+bd create "Add user authentication"
+
+# View all issues
+bd list
+
+# View issue details
+bd show <issue-id>
+
+# Update issue status
+bd update <issue-id> --status in_progress
+bd update <issue-id> --status done
+
+# Sync with git remote
+bd sync
+```
+
+### Working with Issues
+
+Issues in Beads are:
+- **Git-native**: Stored in `.beads/issues.jsonl` and synced like code
+- **AI-friendly**: CLI-first design works perfectly with AI coding agents
+- **Branch-aware**: Issues can follow your branch workflow
+- **Always in sync**: Auto-syncs with your commits
+
+## Why Beads?
+
+✨ **AI-Native Design**
+- Built specifically for AI-assisted development workflows
+- CLI-first interface works seamlessly with AI coding agents
+- No context switching to web UIs
+
+🚀 **Developer Focused**
+- Issues live in your repo, right next to your code
+- Works offline, syncs when you push
+- Fast, lightweight, and stays out of your way
+
+🔧 **Git Integration**
+- Automatic sync with git commits
+- Branch-aware issue tracking
+- Intelligent JSONL merge resolution
+
+## Get Started with Beads
+
+Try Beads in your own projects:
+
+```bash
+# Install Beads
+curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
+
+# Initialize in your repo
+bd init
+
+# Create your first issue
+bd create "Try out Beads"
+```
+
+## Learn More
+
+- **Documentation**: [github.com/steveyegge/beads/docs](https://github.com/steveyegge/beads/tree/main/docs)
+- **Quick Start Guide**: Run `bd quickstart`
+- **Examples**: [github.com/steveyegge/beads/examples](https://github.com/steveyegge/beads/tree/main/examples)
+
+---
+
+*Beads: Issue tracking that moves at the speed of thought* ⚡

package/.beads/config.yaml

@@ -0,0 +1,62 @@
+# Beads Configuration File
+# This file configures default behavior for all bd commands in this repository
+# All settings can also be set via environment variables (BD_* prefix)
+# or overridden with command-line flags
+
+# Issue prefix for this repository (used by bd init)
+# If not set, bd init will auto-detect from directory name
+# Example: issue-prefix: "myproject" creates issues like "myproject-1", "myproject-2", etc.
+# issue-prefix: ""
+
+# Use no-db mode: load from JSONL, no SQLite, write back after each command
+# When true, bd will use .beads/issues.jsonl as the source of truth
+# instead of SQLite database
+# no-db: false
+
+# Disable daemon for RPC communication (forces direct database access)
+# no-daemon: false
+
+# Disable auto-flush of database to JSONL after mutations
+# no-auto-flush: false
+
+# Disable auto-import from JSONL when it's newer than database
+# no-auto-import: false
+
+# Enable JSON output by default
+# json: false
+
+# Default actor for audit trails (overridden by BD_ACTOR or --actor)
+# actor: ""
+
+# Path to database (overridden by BEADS_DB or --db)
+# db: ""
+
+# Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
+# auto-start-daemon: true
+
+# Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
+# flush-debounce: "5s"
+
+# Git branch for beads commits (bd sync will commit to this branch)
+# IMPORTANT: Set this for team projects so all clones use the same sync branch.
+# This setting persists across clones (unlike database config which is gitignored).
+# Can also use BEADS_SYNC_BRANCH env var for local override.
+# If not set, bd sync will require you to run 'bd config set sync.branch <branch>'.
+# sync-branch: "beads-sync"
+
+# Multi-repo configuration (experimental - bd-307)
+# Allows hydrating from multiple repositories and routing writes to the correct JSONL
+# repos:
+#   primary: "."  # Primary repo (where this database lives)
+#   additional:   # Additional repos to hydrate from (read-only)
+#     - ~/beads-planning  # Personal planning repo
+#     - ~/work-planning   # Work planning repo
+
+# Integration settings (access with 'bd config get/set')
+# These are stored in the database, not in this file:
+# - jira.url
+# - jira.project
+# - linear.url
+# - linear.api-key
+# - github.org
+# - github.repo

package/.beads/issues.jsonl

@@ -0,0 +1,5 @@
+{"id":"claude-watch-31k","title":"Multi-agent architecture","description":"Enable multiple claude-watch agents to work together, with a single UI aggregating sessions from all agents.\n\n## Goals\n- Agents can run independently on different machines\n- Browser can connect to multiple agents\n- Optional federation via webhooks between agents\n- Static site deployment option\n\n## Key Components\n- Agent-to-agent webhook communication\n- Workspace field in session JSON\n- Static site build option\n- Agent discovery/configuration","status":"open","priority":0,"issue_type":"epic","owner":"leomilho@gmail.com","created_at":"2026-01-28T18:38:52.868478755+01:00","created_by":"Leonardo","updated_at":"2026-01-28T18:38:52.868478755+01:00","dependencies":[{"issue_id":"claude-watch-31k","depends_on_id":"claude-watch-d7j","type":"blocks","created_at":"2026-01-28T18:40:37.127661584+01:00","created_by":"Leonardo"},{"issue_id":"claude-watch-31k","depends_on_id":"claude-watch-j0k","type":"blocks","created_at":"2026-01-28T18:40:37.2425277+01:00","created_by":"Leonardo"},{"issue_id":"claude-watch-31k","depends_on_id":"claude-watch-uir","type":"blocks","created_at":"2026-01-28T18:40:37.355944877+01:00","created_by":"Leonardo"}]}
+{"id":"claude-watch-d7j","title":"Add workspace field to session JSON","description":"Add a 'workspace' field to session JSON files to support grouping sessions across distributed agents.\n\n## Details\n- Hook detects workspace (git root, explicit config, or cwd-based)\n- Field is optional for backward compatibility\n- UI uses workspace for grouping instead of path-prefix logic\n\n## Acceptance Criteria\n- [ ] Hook writes workspace field to JSON\n- [ ] Workspace detection: try git root, fall back to config/cwd\n- [ ] UI groups by workspace when available\n- [ ] Backward compatible with existing JSON files","status":"open","priority":0,"issue_type":"task","owner":"leomilho@gmail.com","created_at":"2026-01-28T18:39:04.432567407+01:00","created_by":"Leonardo","updated_at":"2026-01-28T18:39:04.432567407+01:00"}
+{"id":"claude-watch-j0k","title":"Agent-to-agent webhook federation","description":"Enable agents to sync session state via webhooks for distributed deployments.\n\n## Architecture\n- Agent watches local JSON files (as now)\n- On change, POST webhook to configured remote agents\n- Remote agents update their state and push to connected browsers\n\n## Config\n```json\n{\n  \"sync_to\": [\"http://hub-agent:3456/api/webhook\"]\n}\n```\n\n## Acceptance Criteria\n- [ ] Agent config for remote agent URLs\n- [ ] Webhook endpoint to receive session updates\n- [ ] POST to remotes on local file change\n- [ ] Deduplication (don't echo back received updates)","status":"open","priority":0,"issue_type":"task","owner":"leomilho@gmail.com","created_at":"2026-01-28T18:39:17.420583312+01:00","created_by":"Leonardo","updated_at":"2026-01-28T18:39:17.420583312+01:00","dependencies":[{"issue_id":"claude-watch-j0k","depends_on_id":"claude-watch-d7j","type":"blocks","created_at":"2026-01-28T18:39:42.596599112+01:00","created_by":"Leonardo"}]}
+{"id":"claude-watch-lg5","title":"Paste image from clipboard into input","description":"Allow pasting images from clipboard into the input box. Image gets uploaded to /tmp/claude-watch-uploads/, path included in message so Claude Code can read it.\n\n## User Flow\n1. Ctrl+V with image in clipboard\n2. Small square thumbnail appears inside input box\n3. User types text\n4. Enter sends: uploads image first, then sends text with path\n\n## Components\n\n### Frontend\n- Paste event handler on textarea\n- Thumbnail preview (small square with X to remove)\n- State for pending image blob\n- Upload before send\n\n### Backend\n- POST /api/files/upload endpoint\n- Saves to /tmp/claude-watch-uploads/\u003cuuid\u003e.\u003cext\u003e\n- Returns absolute path\n\n### Cleanup\n- Simple: files older than 24h or just rely on /tmp clearing on reboot\n\n## Out of Scope\n- Multiple images\n- Drag and drop\n- File path detection (blob only)\n- Fancy preview modal","status":"open","priority":2,"issue_type":"feature","owner":"leomilho@gmail.com","created_at":"2026-01-30T18:40:19.894427981+01:00","created_by":"Leonardo","updated_at":"2026-01-30T18:40:19.894427981+01:00"}
+{"id":"claude-watch-uir","title":"Static site build option","description":"Build SvelteKit app as static site that connects to agent(s) directly from browser.\n\n## Architecture\n- Static HTML/JS/CSS (deploy to GitHub Pages, CDN, etc.)\n- Browser connects WebSocket to configured agent URL(s)\n- No server-side rendering needed\n- Agent URLs configured in UI or query params\n\n## Challenges\n- CORS handling on agents\n- Mixed content (HTTPS site → HTTP agents)\n- Agent discovery UX\n\n## Acceptance Criteria\n- [ ] SvelteKit adapter-static build option\n- [ ] Agent URL configuration in browser\n- [ ] CORS headers on agent API\n- [ ] Works with single or multiple agents","status":"open","priority":0,"issue_type":"task","owner":"leomilho@gmail.com","created_at":"2026-01-28T18:39:29.833000453+01:00","created_by":"Leonardo","updated_at":"2026-01-28T18:39:29.833000453+01:00","dependencies":[{"issue_id":"claude-watch-uir","depends_on_id":"claude-watch-d7j","type":"blocks","created_at":"2026-01-28T18:39:42.741491482+01:00","created_by":"Leonardo"}]}

package/.beads/metadata.json

@@ -0,0 +1,4 @@
+{
+  "database": "beads.db",
+  "jsonl_export": "issues.jsonl"
+}

package/.eslintrc.json

@@ -0,0 +1,25 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "jsx": true
+    }
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "env": {
+    "node": true,
+    "es2022": true
+  },
+  "rules": {
+    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    "@typescript-eslint/explicit-function-return-type": "off",
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

package/.gitattributes

@@ -0,0 +1,3 @@
+
+# Use bd merge for beads JSONL files
+.beads/issues.jsonl merge=beads

package/.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100
+}

package/CLAUDE.md

@@ -0,0 +1,123 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Server
+
+Dev server runs via Vite with HMR at **http://localhost:5173** (or `--port` to change).
+
+```bash
+bun run dev:serve                    # Start dev server
+bun run dev:serve --port 3456        # Custom port
+bun run dev:serve --host 0.0.0.0     # LAN access
+```
+
+**HMR handles most changes automatically** - no restart needed for Svelte components, stores, routes, or API endpoints. Only `vite.config.ts` changes require a restart.
+
+After each change, check tmux pane `0:1.1` to verify HMR worked. If the server died, restart it. Do not start a new server if one is already running. If the pane reference is wrong, find the correct one and update this file.
+
+## Build & Development Commands
+
+```bash
+bun run build          # Build CLI + SvelteKit web app
+bun run build:cli      # Build CLI only (TypeScript)
+bun run build:web      # Build SvelteKit web app only
+bun run dev:serve      # Vite dev server with HMR
+bun test               # Run vitest tests
+bun run lint           # ESLint check
+bun run format         # Prettier formatting
+```
+
+Production server (after build):
+```bash
+bun dist/cli.js serve --port 3456 --host 0.0.0.0
+```
+
+Run a single test file:
+```bash
+bun vitest run tests/db/sessions.test.ts
+```
+
+## Architecture
+
+claude-mux has three main components:
+
+### 1. Claude Code Hooks → JSON Files
+The hook script (`src/hooks/claude-mux-hook.ts`) runs inside Claude Code's process. It receives events via stdin (SessionStart, UserPromptSubmit, PreToolUse, Stop, etc.) and writes state to per-session JSON files in `~/.claude-mux/sessions/`.
+
+### 2. SvelteKit Web Server + WebSocket
+The web server (`web/`) is built with SvelteKit and svelte-adapter-bun:
+- **File watcher** (`src/server/watcher.ts`): Polls JSON files for changes (500ms interval)
+- **WebSocket channels**: Real-time updates for sessions list and terminal output
+- **API routes**: REST endpoints for session management, tmux control, folder browsing
+- **Hooks** (`web/src/hooks.server.ts`): WebSocket upgrade handling, session managers
+
+### 3. State Detection
+**Hooks are authoritative** for all state transitions. Pane content polling only catches one edge case: when the user presses Escape to interrupt. The `checkForInterruption()` function in `src/tmux/pane.ts` detects "Interrupted" or "User declined" messages.
+
+## Key Data Flow
+
+```
+Claude Code events → stdin → hook script → JSON files (~/.claude-mux/sessions/)
+                                                ↓
+                                    file watcher (500ms polling)
+                                                ↓
+                                    WebSocket broadcast to clients
+                                                ↓
+                                    Svelte stores → UI update
+```
+
+## Session States
+
+| State | Color | Description |
+|-------|-------|-------------|
+| `idle` | Yellow | Ready for new task |
+| `busy` | Green | Working (thinking, tool use) |
+| `waiting` | Red | Asking user a question |
+| `permission` | Red | Needs permission to proceed |
+
+## Project Structure
+
+```
+claude-mux/
+├── src/                    # CLI/TUI/Hooks
+│   ├── cli.ts              # Entry point
+│   ├── app.tsx             # React Ink TUI
+│   ├── commands/
+│   │   ├── serve.ts        # Web server command
+│   │   └── tui.ts          # TUI command
+│   ├── db/                 # JSON file operations
+│   ├── hooks/              # Claude Code hooks
+│   ├── server/
+│   │   └── watcher.ts      # File watcher
+│   └── tmux/               # tmux integration
+├── web/                    # SvelteKit app
+│   ├── src/
+│   │   ├── hooks.server.ts # WebSocket handlers
+│   │   ├── lib/stores/     # Svelte 5 runes stores
+│   │   └── routes/         # Pages and API routes
+│   └── svelte.config.js
+└── dist/                   # Build output
+    ├── cli.js              # CLI
+    └── web/                # SvelteKit server
+```
+
+## Important Files
+
+- `src/cli.ts` - Entry point, routes to subcommands
+- `src/hooks/claude-mux-hook.ts` - Runs in Claude's process, writes JSON
+- `src/db/sessions-json.ts` - Session CRUD operations on JSON files
+- `src/tmux/pane.ts` - `checkForInterruption()` detects Escape interruptions
+- `src/server/watcher.ts` - File watcher for session changes
+- `web/src/hooks.server.ts` - WebSocket handlers and session managers
+- `web/src/lib/stores/sessions.svelte.ts` - Reactive session store
+
+## UI Components
+
+Use **shadcn-svelte** components from `$lib/components/ui/`. Do not build custom UI components—add shadcn components instead.
+
+## tmux Integration
+
+- TUI auto-creates a `watch` tmux session
+- `prefix + W` keybinding jumps to watch session (set dynamically)
+- Pane targets use format: `session:window.pane` (e.g., "main:1.0")

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Leonardo Christino
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PLAN-beads-integration.md

@@ -0,0 +1,250 @@
+# Beads Integration Plan
+
+## Overview
+
+Add beads issue tracking integration to claude-watch sidebar drawer, optimized for mobile use.
+
+**Core workflow**: Swipe drawer → see issues → tap to insert ID into chat input
+
+---
+
+## Requirements Summary
+
+| Aspect | Decision |
+|--------|----------|
+| Primary device | Mobile (phone) |
+| UI location | Sidebar drawer |
+| Tap action (in session) | Insert ID into input field |
+| Tap action (main page) | Explore only, show details |
+| Default filter | Buttons: Ready / Open / All |
+| Visual style | Simple list, status-colored dots |
+| Real-time | Watch for changes, update automatically |
+
+---
+
+## Phase 1: Data Layer
+
+### 1.1 BeadsStore (`web/src/lib/stores/beads.svelte.ts`)
+
+Svelte 5 runes store for beads issues:
+
+```typescript
+interface BeadsIssue {
+  id: string;           // e.g., "claude-watch-xxx"
+  title: string;
+  status: 'open' | 'in_progress' | 'blocked' | 'deferred' | 'closed';
+  priority: number;     // 0-4
+  issue_type: string;   // task, bug, feature, epic
+  dependencies: { depends_on_id: string }[];
+  // ... other fields as needed
+}
+
+class BeadsStore {
+  issues = $state<BeadsIssue[]>([]);
+  filter = $state<'ready' | 'open' | 'all'>('open');
+  loading = $state(false);
+
+  // Computed
+  get filteredIssues() { ... }
+
+  // Methods
+  async loadIssues(gitRoot: string): Promise<void>;
+  setFilter(filter: 'ready' | 'open' | 'all'): void;
+}
+```
+
+### 1.2 API Endpoint (`web/src/routes/api/beads/+server.ts`)
+
+```
+GET /api/beads?project=/path/to/git/root&filter=ready
+```
+
+Server-side: Run `bd list --json` or `bd ready --json` and return results.
+
+### 1.3 File Watcher (optional, Phase 4)
+
+Watch `.beads/issues.jsonl` per project and broadcast changes via WebSocket.
+
+---
+
+## Phase 2: Sidebar UI
+
+### 2.1 Beads Section in Drawer
+
+Add collapsible "Issues" section below sessions list in `SessionsSidebar.svelte`:
+
+```
+┌─────────────────────────┐
+│ 🏠 Claude Watch         │
+├─────────────────────────┤
+│ Sessions                │
+│ ├─ project-a (2)        │
+│ │  └─ session items...  │
+│ └─ project-b (1)        │
+│    └─ session items...  │
+├─────────────────────────┤
+│ Issues          [▼]     │  ← Collapsible
+│ [Ready] [Open] [All]    │  ← Filter buttons (pills)
+│ ┌─────────────────────┐ │
+│ │ 🟢 xxx Task title   │ │  ← Issue item
+│ │ 🟡 yyy Bug title... │ │
+│ │ 🔴 zzz Blocked...   │ │
+│ └─────────────────────┘ │
+└─────────────────────────┘
+```
+
+### 2.2 Issue Item Component
+
+```svelte
+<button class="issue-item" onclick={handleTap}>
+  <span class="status-dot" style="background: {statusColor}"></span>
+  <span class="issue-id">{issue.id.split('-').pop()}</span>
+  <span class="issue-title">{truncate(issue.title, 30)}</span>
+</button>
+```
+
+Status colors:
+- 🟢 Green: `in_progress`
+- 🟡 Yellow: `open`
+- 🔴 Red: `blocked`
+- ⚪ Gray: `closed`, `deferred`
+
+### 2.3 Filter Buttons
+
+Pill-style toggle buttons:
+- **Ready**: Issues with no blockers (`bd ready`)
+- **Open**: `status in (open, in_progress)`
+- **All**: Everything
+
+---
+
+## Phase 3: Tap-to-Insert
+
+### 3.1 Context Detection
+
+Detect if user is viewing a session (`/session/[target]`) or main page:
+
+```typescript
+import { page } from '$app/stores';
+
+const isSessionView = $derived(
+  $page.url.pathname.startsWith('/session/')
+);
+```
+
+### 3.2 Insert Mechanism
+
+When in session view, tapping issue calls:
+
+```typescript
+function insertIssueId(issueId: string) {
+  // Get reference to session input textarea
+  // Append or replace text with issue ID
+  sessionInput.value += issueId;
+  sessionInput.focus();
+}
+```
+
+Implementation options:
+1. **Store-based**: BeadsStore emits event, session page listens
+2. **Context-based**: Pass input ref via Svelte context
+3. **DOM-based**: Query selector for input element
+
+### 3.3 Feedback
+
+- Brief highlight on the issue item
+- Optional toast: "Inserted claude-watch-xxx"
+- Haptic feedback (if supported)
+
+---
+
+## Phase 4: Enhancements (Future)
+
+### 4.1 Real-time Updates
+
+- WebSocket channel: `/api/beads/stream?project=...`
+- Watch `.beads/issues.jsonl` for changes
+- Broadcast updates to connected clients
+
+### 4.2 Issue Details
+
+- Long-press or tap on main page → show issue details sheet
+- Display: full title, description, dependencies, priority
+
+### 4.3 Session-Issue Linking
+
+- Associate issues with sessions (stored in session JSON)
+- Show linked issues as badges in session header
+- "Working on: claude-watch-xxx"
+
+### 4.4 Project Scoping
+
+- Auto-detect project from selected session
+- Or: show issues for all beads-enabled projects
+
+---
+
+## File Changes Summary
+
+### New Files
+
+| File | Purpose |
+|------|---------|
+| `web/src/lib/stores/beads.svelte.ts` | BeadsStore |
+| `web/src/routes/api/beads/+server.ts` | API endpoint |
+| `web/src/lib/components/BeadsPanel.svelte` | Sidebar beads UI |
+| `web/src/lib/components/IssueItem.svelte` | Single issue row |
+
+### Modified Files
+
+| File | Changes |
+|------|---------|
+| `web/src/lib/components/SessionsSidebar.svelte` | Add BeadsPanel |
+| `web/src/routes/session/[target]/+page.svelte` | Handle insert event |
+| `web/src/routes/+layout.svelte` | Initialize BeadsStore |
+
+---
+
+## Technical Considerations
+
+### Running `bd` Commands
+
+The server needs to execute `bd list --json`. Options:
+1. **Direct exec**: `Bun.spawn(['bd', 'list', '--json', '--cwd', gitRoot])`
+2. **Read JSONL**: Parse `.beads/issues.jsonl` directly (faster, no CLI dep)
+3. **SQLite query**: Query `.beads/beads.db` directly (fastest, but daemon may lock)
+
+Recommendation: Start with CLI exec, optimize later if needed.
+
+### Multi-Project
+
+Sessions can be in different projects. Options:
+1. Show issues for "active" session's project only
+2. Show issues grouped by project (like sessions)
+3. Let user select project
+
+Recommendation: Show issues for selected session's project, with project indicator.
+
+### Mobile UX
+
+- Large tap targets (min 44px height)
+- Swipe drawer already implemented
+- Filter buttons should be thumb-reachable
+- Consider bottom placement for filter buttons
+
+---
+
+## Open Questions
+
+1. Should closed issues ever be shown? (Maybe in "All" filter only)
+2. Priority indicator? (Could show P0/P1 with a badge)
+3. Issue type icons? (🐛 bug, ✨ feature, 📋 task)
+
+---
+
+## Estimated Scope
+
+- **Phase 1-3 (MVP)**: Core functionality
+- **Phase 4**: Nice-to-haves
+
+Dependencies: shadcn-svelte components (already installed)