feat(terminal): tmux navigator, presets, and custom preset files

.twicc-tmux.json

@@ -0,0 +1,22 @@
+[
+  {
+    "name": "Restart Twicc",
+    "command": "exec uv run ./devctl.py restart"
+  },
+  {
+    "name": "Restart Twicc Backend",
+    "command": "exec uv run ./devctl.py restart back"
+  },
+  {
+    "name": "Restart Twicc Frontend",
+    "command": "exec uv run ./devctl.py restart front"
+  },
+  {
+    "name": "Backend Logs",
+    "command": "tail -f ~/.twicc/logs/backend.log"
+  },
+  {
+    "name": "Frontend Logs",
+    "command": "tail -f ~/.twicc/logs/frontend.log"
+  }
+]

docs/terminal-presets.md

@@ -0,0 +1,82 @@
+# Terminal Presets (`.twicc-tmux.json`)
+
+Define preset shell sessions for the terminal's tmux navigator by placing a `.twicc-tmux.json` file in your project.
+
+## Format
+
+The file is a JSON array of preset objects:
+
+| Field         | Type   | Required | Description                                              |
+|---------------|--------|----------|----------------------------------------------------------|
+| `name`        | string | **yes**  | Display name, also used as the tmux window name          |
+| `command`     | string | no       | Command to run automatically when the window is created  |
+| `cwd`         | string | no       | Working directory (absolute, or relative to `relative_to` base) |
+| `relative_to` | string | no       | Base for relative `cwd`: `preset_dir` (default), `project_dir`, `git_dir`, `session_cwd` |
+
+## Example
+
+```json
+[
+  { "name": "dev", "cwd": "frontend", "command": "npm run dev" },
+  { "name": "logs", "command": "tail -f logs/backend.log" },
+  { "name": "shell" }
+]
+```
+
+### Library preset file (loaded from another directory)
+
+```json
+[
+  { "name": "Build", "cwd": "src", "relative_to": "project_dir", "command": "make" },
+  { "name": "Docs", "cwd": "docs", "relative_to": "git_dir" },
+  { "name": "Tool scripts", "cwd": "scripts", "relative_to": "preset_dir" }
+]
+```
+
+## `relative_to` values
+
+| Value         | Resolves `cwd` relative to              | Default |
+|---------------|------------------------------------------|---------|
+| `preset_dir`  | Directory containing the preset file     | **yes** |
+| `project_dir` | Project directory (from Claude projects) |         |
+| `git_dir`     | Git root directory                       |         |
+| `session_cwd` | Session's working directory              |         |
+
+If the base directory is not available (e.g., no git root), the preset is shown greyed out and cannot be launched.
+
+## File discovery
+
+TwiCC looks for `.twicc-tmux.json` in up to three locations (checked in order, each producing a separate section in the navigator):
+
+1. **Project directory** — the Claude project's directory (`~/.claude/projects/<id>/` maps to a filesystem path).
+2. **Git root** — the resolved git root directory, if different from the project directory.
+3. **Session CWD walk** — starting from the session's working directory, walks up parent directories until a `.twicc-tmux.json` is found (stops at the project or git boundary).
+
+Each source that contains a valid file appears as a labelled section. If the same directory is reached by multiple sources, it only appears once.
+
+## Behavior
+
+- Presets appear in the terminal's **shell navigator** (the full-page picker) and are prefixed with a ▶ icon in the **tab bar** (desktop) and **dropdown** (mobile).
+- A preset that is currently running shows a green ▶ icon in the navigator. Clicking it switches to the existing window instead of creating a duplicate.
+- When a preset window is created, its `command` (if any) is sent as keystrokes to the new tmux window.
+- Without `relative_to`, relative `cwd` paths are resolved against the directory containing the preset file (`preset_dir`).
+- The file is re-read every time the window list is refreshed, so changes take effect without restarting the server.
+
+## Custom preset files
+
+Users can add arbitrary JSON preset files per project via the navigator's **Add preset file** button. These files follow the same format and are stored as references in `~/.twicc/presets/<project_id>.json`. Files already loaded from the project/git/cwd sources are deduplicated.
+
+## Claude Code skill
+
+A Claude Code skill is available to create, edit, and validate `.twicc-tmux.json` files interactively. Install it with:
+
+```
+/plugin marketplace add dguerizec/twicc-tmux-presets
+/plugin install twicc-presets@twicc-tmux-presets
+```
+
+Then use it naturally (e.g., "create presets for dev server and logs") or invoke it directly with `/twicc-presets`.
+
+## Implementation
+
+Loaded by `load_tmux_presets_from_file()` in `src/twicc/terminal.py`. CWD resolution happens in `_resolve_preset_cwd()` using the session context.