recomposable 1.1.2 → 1.1.4

package/README.md

@@ -48,6 +48,7 @@ recomposable
 - **Docker Compose Watch** — toggle `docker compose watch` per service, with live output in the log panel
 - **Dependency-aware rebuild** — rebuild a service then automatically restart all its transitive dependents in topological order
 - **Container exec** — run commands inside any container, inline in the bottom panel (`e`) or full-screen (`x`), with `cd` support and command history
+- **Worktree switching** — switch any service to run from a different git worktree (`t`), automatically rebuilds and starts in the target branch
 - **Vim keybindings** — navigate with `j`/`k`, `G`/`gg`, and more
 
 ## Full Log View
@@ -68,6 +69,12 @@ Press `w` to toggle `docker compose watch` for a service. A cyan `W` indicator a
 
 Press `d` to rebuild the selected service and then automatically restart all services that depend on it (transitively), in the correct topological order. Progress is shown step-by-step in the log panel. If the service has no dependents, falls back to a regular rebuild.
 
+## Worktree Switching
+
+Press `t` on any service to switch it to a different git worktree. A picker shows all available worktrees — navigate with `j`/`k`, confirm with `Enter`. The service is automatically stopped, rebuilt, and started from the target worktree's compose file. A `WORKTREE` column appears when services run from multiple branches, with non-main branches highlighted in yellow.
+
+This is useful for end-to-end testing changes across branches without drowning in terminal tabs. Run your main stack on `main`, then switch individual services to feature branches to verify their behavior in the full environment. Particularly handy when letting Claude Code work in worktrees — switch the affected service, verify it end-to-end, and switch back, all from a single terminal.
+
 ## Adding Compose Files
 
 Create a `recomposable.json` file in your project root:
@@ -136,6 +143,7 @@ recomposable -f docker-compose.yml -f docker-compose.prod.yml
 | `x` | Full-screen exec mode |
 | `n` | Toggle no-cache mode (rebuild with `--no-cache` + `--force-recreate`) |
 | `f` / `Enter` | Full-screen log view for selected service |
+| `t` | Switch service to a different git worktree |
 | `l` | Toggle inline log panel |
 | `/` | Search in inline log panel |
 | `G` | Jump to bottom |

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import type { Config, AppState, ServiceGroup } from './lib/types';
+import type { Config, AppState, ServiceGroup, GitWorktree } from './lib/types';
 export interface ModuleState {
     logScanActive: boolean;
     statsPollActive: boolean;
@@ -11,6 +11,7 @@ export declare function createModuleState(): ModuleState;
 export declare function loadConfig(): Config;
 export declare function discoverServices(config: Config): ServiceGroup[];
 export declare function pollStatuses(state: AppState): void;
+export declare function detectMultipleWorktrees(state: AppState): void;
 export declare function pollLogCounts(state: AppState): void;
 export declare function pollContainerStats(state: AppState): void;
 export declare function render(state: AppState): void;
@@ -21,18 +22,25 @@ export declare function doRebuild(state: AppState): void;
 export declare function doRestart(state: AppState): void;
 export declare function doStop(state: AppState): void;
 export declare function doStart(state: AppState): void;
+export declare function mapComposeFileToWorktree(composeFile: string, targetWorktreePath: string): string | null;
+export declare function openWorktreePicker(state: AppState): void;
+export declare function doWorktreeSwitch(state: AppState, targetWorktree: GitWorktree): void;
 export declare function doWatch(state: AppState): void;
 export declare function initDepGraphs(state: AppState): void;
 export declare function doCascadeRebuild(state: AppState): void;
 export declare function enterExecInline(state: AppState): void;
 export declare function enterExec(state: AppState): void;
 export declare function exitExec(state: AppState): void;
+export declare function shellEscape(str: string): string;
 export declare function runExecCommand(state: AppState): void;
 export declare function enterLogs(state: AppState): void;
 export declare function exitLogs(state: AppState): void;
+export declare function loadMoreLogHistory(state: AppState): void;
 export declare function executeLogSearch(state: AppState): void;
 export declare function jumpToNextMatch(state: AppState): void;
 export declare function jumpToPrevMatch(state: AppState): void;
+export declare function executeBottomSearch(state: AppState): void;
+export declare function clearBottomSearch(state: AppState): void;
 export declare function handleKeypress(state: AppState, key: string): void;
 export declare function createInputHandler(state: AppState): (data: Buffer | string) => void;
 export declare function cleanup(state: AppState): void;