Add --list option to template command and clean orphan tmux windows

- Add -l/--list option to explicitly list templates
- Remove tmux windows not defined in the template after applying

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

Author: 3 people

completions/wttw.fish

@@ -80,6 +80,7 @@ complete -f -c wttw -n '__fish_wttw_using_command tmux; or __fish_wttw_using_com
 
 # template command
 complete -f -c wttw -n '__fish_wttw_using_command template; or __fish_wttw_using_command tp' -a '(__fish_wttw_templates)'
+complete -f -c wttw -n '__fish_wttw_using_command template; or __fish_wttw_using_command tp' -d "list templates" -s l -l list
 
 # open command
 complete -f -c wttw -n '__fish_wttw_using_command open; or __fish_wttw_using_command o' -a '(__fish_wttw_worktrees)'

lib/index.js

@@ -26,6 +26,7 @@ const {
   getTmuxWindowId,
   createSession,
   switchSession,
+  cleanUnknownWindows,
 } = require('./tmux');
 const {
   checks,
@@ -393,6 +394,7 @@ cmd.command('open [branch]')
 cmd.command('template [template-name]')
   .alias('tp')
   .description('list templates or create tmux windows from a template')
+  .option('-l, --list', 'list templates')
   .on('--help', () => {
     console.log('');
     console.log('  Template file: ~/.config/wttw/<template-name>.json');
@@ -415,9 +417,9 @@ cmd.command('template [template-name]')
     console.log('    windows[].pane   pane count (optional, default: config paneCount)');
     console.log('    windows[].cmd    command to run (optional)');
   })
-  .action(async (templateName, {parent: {dryRun}}) => {
+  .action(async (templateName, {list, parent: {dryRun}}) => {
     try {
-      if (!templateName) {
+      if (list || !templateName) {
         const templates = listTemplates();
         if (templates.length === 0) {
           console.log('No templates found. Create one at ~/.config/wttw/<name>.json');
@@ -474,6 +476,7 @@ cmd.command('template [template-name]')
       }
 
       if (!dryRun) {
+        await cleanUnknownWindows(session, windows.map(w => w.name));
         note(`template "${templateName}" applied`);
       }
     } catch (err) {

lib/tmux.js

@@ -105,6 +105,22 @@ exports.switchSession = async (session, window, wtd, focus = false) => {
   }
 }
 
+exports.cleanUnknownWindows = async (session, knownNames) => {
+  const known = new Set(knownNames);
+  const {stdout} = await command(`tmux list-windows -t ${session} -F #{window_id}\t#W`);
+  const orphans = stdout.split(EOL)
+    .filter(Boolean)
+    .map(l => l.split('\t'))
+    .filter(([, name]) => !known.has(name));
+
+  for (const [id] of orphans) {
+    await command(`tmux kill-window -t ${id}`);
+  }
+  if (orphans.length > 0) {
+    await command(`tmux move-window -r -t ${session}`);
+  }
+}
+
 exports.showPopup = async (wtd) => {
   const taskPath = join(wtd, '.context', 'TASK.md');
   if (!existsSync(taskPath)) {