taskmux 0.2.6__tar.gz → 0.2.7__tar.gz

{taskmux-0.2.6 → taskmux-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taskmux
-Version: 0.2.6
+Version: 0.2.7
 Summary: Modern tmux-based task manager for LLM development tools
 Project-URL: Homepage, https://github.com/nc9/taskmux
 Project-URL: Repository, https://github.com/nc9/taskmux
@@ -125,17 +125,22 @@ health_check = "test -f .migrate-complete"
 [tasks.api]
 command = "python manage.py runserver 0.0.0.0:8000"
 cwd = "apps/api"
+port = 8000
 depends_on = ["migrate"]
 health_check = "curl -sf http://localhost:8000/health"
+stop_grace_period = 10
 
 [tasks.worker]
 command = "celery -A myapp worker -l info"
 cwd = "apps/api"
 depends_on = ["db"]
+max_restarts = 3
+restart_backoff = 3.0
 
 [tasks.web]
 command = "bun dev"
 cwd = "apps/web"
+port = 3000
 depends_on = ["api"]
 health_check = "curl -sf http://localhost:3000"
 
@@ -171,8 +176,8 @@ taskmux start storybook          # Start a manual task
 # Session
 taskmux start                    # Start all auto_start tasks
 taskmux start <task>             # Start a single task
-taskmux stop                     # Stop all tasks (graceful C-c)
-taskmux stop <task>              # Stop a single task (graceful C-c)
+taskmux stop                     # Stop all tasks (C-c → SIGTERM → SIGKILL)
+taskmux stop <task>              # Stop a single task (signal escalation)
 taskmux restart                  # Restart all tasks
 taskmux restart <task>           # Restart a single task
 taskmux status                   # Show session status
@@ -206,8 +211,8 @@ taskmux daemon --port 8765       # Run with WebSocket API + auto-restart
 
 ### stop vs kill
 
-- **`stop`** sends C-c (graceful). Window stays alive so you can see exit output.
-- **`kill`** destroys the window immediately.
+- **`stop`** sends C-c, then escalates to SIGTERM → SIGKILL if the process doesn't exit within the grace period. Window stays alive so you can see exit output.
+- **`kill`** kills the process group and destroys the window immediately.
 
 ## Configuration
 
@@ -226,7 +231,9 @@ after_stop = "echo done"
 [tasks.server]
 command = "python manage.py runserver"
 cwd = "apps/api"
+port = 8000
 health_check = "curl -sf http://localhost:8000/health"
+stop_grace_period = 10
 depends_on = ["db"]
 
 [tasks.server.hooks]
@@ -239,6 +246,7 @@ health_check = "pg_isready -h localhost"
 [tasks.worker]
 command = "celery worker -A myapp"
 depends_on = ["db"]
+max_restarts = 3
 
 [tasks.tailwind]
 command = "npx tailwindcss -w"
@@ -258,10 +266,14 @@ auto_start = false
 | `tasks.<name>.command` | — | Shell command to run |
 | `tasks.<name>.auto_start` | `true` | Start with `taskmux start` |
 | `tasks.<name>.cwd` | — | Working directory for the task |
+| `tasks.<name>.port` | — | Port to clean up before starting (kills orphaned listeners) |
 | `tasks.<name>.health_check` | — | Shell command to check health (exit 0 = healthy) |
 | `tasks.<name>.health_interval` | `10` | Seconds between health checks |
 | `tasks.<name>.health_timeout` | `5` | Seconds before health check times out |
 | `tasks.<name>.health_retries` | `3` | Consecutive failures before "unhealthy" |
+| `tasks.<name>.stop_grace_period` | `5` | Seconds to wait after C-c before escalating to SIGTERM |
+| `tasks.<name>.max_restarts` | `5` | Max auto-restarts in daemon mode before giving up (0 = unlimited) |
+| `tasks.<name>.restart_backoff` | `2.0` | Multiplier for restart delay (1s, 2s, 4s, 8s… capped at 60s) |
 | `tasks.<name>.depends_on` | `[]` | Task names that must be healthy before this task starts |
 | `tasks.<name>.hooks.*` | — | Per-task lifecycle hooks (same fields as global) |
 
@@ -290,6 +302,20 @@ Hooks fire in this order:
 
 If a `before_*` hook fails (non-zero exit), the action is aborted.
 
+### Process Lifecycle
+
+Taskmux ensures processes are fully stopped before restarting and that orphaned port listeners don't block new starts.
+
+**Stop escalation** (`stop`, `restart`):
+
+1. **C-c** (SIGINT) — waits `stop_grace_period` seconds (default 5)
+2. **SIGTERM** to process group — waits 3 seconds
+3. **SIGKILL** to process group — force kill
+
+**Port cleanup** (`start`, `restart`): If `port` is configured, taskmux kills any process listening on that port before starting. This handles orphaned processes from crashed sessions.
+
+**Auto-restart backoff** (daemon mode): When a task keeps crashing, restart delays increase exponentially (`restart_backoff` multiplier, capped at 60s). After `max_restarts` failures, the task is left stopped. The counter resets after 60 seconds of healthy uptime.
+
 ### Init & Agent Context
 
 `taskmux init` bootstraps your project:
@@ -325,13 +351,15 @@ Use `--defaults` to skip prompts (CI/automation).
 
 ## Daemon Mode
 
-Run as a background daemon with WebSocket API and auto-restart:
+Run as a background daemon with WebSocket API and auto-restart with exponential backoff:
 
 ```bash
 taskmux daemon              # Default port 8765
 taskmux daemon --port 9000  # Custom port
 ```
 
+The daemon monitors task health every 30 seconds. Unhealthy tasks are restarted with exponential backoff (controlled by `restart_backoff` and `max_restarts`). Tasks that stay healthy for 60+ seconds have their restart counter reset.
+
 WebSocket API:
 
 ```javascript

{taskmux-0.2.6 → taskmux-0.2.7}/README.md

@@ -90,17 +90,22 @@ health_check = "test -f .migrate-complete"
 [tasks.api]
 command = "python manage.py runserver 0.0.0.0:8000"
 cwd = "apps/api"
+port = 8000
 depends_on = ["migrate"]
 health_check = "curl -sf http://localhost:8000/health"
+stop_grace_period = 10
 
 [tasks.worker]
 command = "celery -A myapp worker -l info"
 cwd = "apps/api"
 depends_on = ["db"]
+max_restarts = 3
+restart_backoff = 3.0
 
 [tasks.web]
 command = "bun dev"
 cwd = "apps/web"
+port = 3000
 depends_on = ["api"]
 health_check = "curl -sf http://localhost:3000"
 
@@ -136,8 +141,8 @@ taskmux start storybook          # Start a manual task
 # Session
 taskmux start                    # Start all auto_start tasks
 taskmux start <task>             # Start a single task
-taskmux stop                     # Stop all tasks (graceful C-c)
-taskmux stop <task>              # Stop a single task (graceful C-c)
+taskmux stop                     # Stop all tasks (C-c → SIGTERM → SIGKILL)
+taskmux stop <task>              # Stop a single task (signal escalation)
 taskmux restart                  # Restart all tasks
 taskmux restart <task>           # Restart a single task
 taskmux status                   # Show session status
@@ -171,8 +176,8 @@ taskmux daemon --port 8765       # Run with WebSocket API + auto-restart
 
 ### stop vs kill
 
-- **`stop`** sends C-c (graceful). Window stays alive so you can see exit output.
-- **`kill`** destroys the window immediately.
+- **`stop`** sends C-c, then escalates to SIGTERM → SIGKILL if the process doesn't exit within the grace period. Window stays alive so you can see exit output.
+- **`kill`** kills the process group and destroys the window immediately.
 
 ## Configuration
 
@@ -191,7 +196,9 @@ after_stop = "echo done"
 [tasks.server]
 command = "python manage.py runserver"
 cwd = "apps/api"
+port = 8000
 health_check = "curl -sf http://localhost:8000/health"
+stop_grace_period = 10
 depends_on = ["db"]
 
 [tasks.server.hooks]
@@ -204,6 +211,7 @@ health_check = "pg_isready -h localhost"
 [tasks.worker]
 command = "celery worker -A myapp"
 depends_on = ["db"]
+max_restarts = 3
 
 [tasks.tailwind]
 command = "npx tailwindcss -w"
@@ -223,10 +231,14 @@ auto_start = false
 | `tasks.<name>.command` | — | Shell command to run |
 | `tasks.<name>.auto_start` | `true` | Start with `taskmux start` |
 | `tasks.<name>.cwd` | — | Working directory for the task |
+| `tasks.<name>.port` | — | Port to clean up before starting (kills orphaned listeners) |
 | `tasks.<name>.health_check` | — | Shell command to check health (exit 0 = healthy) |
 | `tasks.<name>.health_interval` | `10` | Seconds between health checks |
 | `tasks.<name>.health_timeout` | `5` | Seconds before health check times out |
 | `tasks.<name>.health_retries` | `3` | Consecutive failures before "unhealthy" |
+| `tasks.<name>.stop_grace_period` | `5` | Seconds to wait after C-c before escalating to SIGTERM |
+| `tasks.<name>.max_restarts` | `5` | Max auto-restarts in daemon mode before giving up (0 = unlimited) |
+| `tasks.<name>.restart_backoff` | `2.0` | Multiplier for restart delay (1s, 2s, 4s, 8s… capped at 60s) |
 | `tasks.<name>.depends_on` | `[]` | Task names that must be healthy before this task starts |
 | `tasks.<name>.hooks.*` | — | Per-task lifecycle hooks (same fields as global) |
 
@@ -255,6 +267,20 @@ Hooks fire in this order:
 
 If a `before_*` hook fails (non-zero exit), the action is aborted.
 
+### Process Lifecycle
+
+Taskmux ensures processes are fully stopped before restarting and that orphaned port listeners don't block new starts.
+
+**Stop escalation** (`stop`, `restart`):
+
+1. **C-c** (SIGINT) — waits `stop_grace_period` seconds (default 5)
+2. **SIGTERM** to process group — waits 3 seconds
+3. **SIGKILL** to process group — force kill
+
+**Port cleanup** (`start`, `restart`): If `port` is configured, taskmux kills any process listening on that port before starting. This handles orphaned processes from crashed sessions.
+
+**Auto-restart backoff** (daemon mode): When a task keeps crashing, restart delays increase exponentially (`restart_backoff` multiplier, capped at 60s). After `max_restarts` failures, the task is left stopped. The counter resets after 60 seconds of healthy uptime.
+
 ### Init & Agent Context
 
 `taskmux init` bootstraps your project:
@@ -290,13 +316,15 @@ Use `--defaults` to skip prompts (CI/automation).
 
 ## Daemon Mode
 
-Run as a background daemon with WebSocket API and auto-restart:
+Run as a background daemon with WebSocket API and auto-restart with exponential backoff:
 
 ```bash
 taskmux daemon              # Default port 8765
 taskmux daemon --port 9000  # Custom port
 ```
 
+The daemon monitors task health every 30 seconds. Unhealthy tasks are restarted with exponential backoff (controlled by `restart_backoff` and `max_restarts`). Tasks that stay healthy for 60+ seconds have their restart counter reset.
+
 WebSocket API:
 
 ```javascript

{taskmux-0.2.6 → taskmux-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "taskmux"
-version = "0.2.6"
+version = "0.2.7"
 description = "Modern tmux-based task manager for LLM development tools"
 readme = "README.md"
 license-file = "LICENSE"

{taskmux-0.2.6 → taskmux-0.2.7}/taskmux/agent.py

@@ -40,9 +40,12 @@ def buildContextBlock(config: TaskmuxConfig) -> str:
     ]
 
     if config.tasks:
+        lines.append("| Task | Port | Auto-start | Command |")
+        lines.append("|------|------|------------|---------|")
         for name, task in config.tasks.items():
-            auto = "" if task.auto_start else " (manual)"
-            lines.append(f"- **{name}**: `{task.command}`{auto}")
+            port = str(task.port) if task.port else "—"
+            auto = "yes" if task.auto_start else "no"
+            lines.append(f"| {name} | {port} | {auto} | `{task.command}` |")
     else:
         lines.append('_No tasks configured yet. Use `taskmux add <name> "<command>"` to add._')
 

{taskmux-0.2.6 → taskmux-0.2.7}/taskmux/cli.py

@@ -53,45 +53,41 @@ def init(
     initProject(defaults=defaults)
 
 
-@app.command()
-def list():
-    """List all tasks and their status."""
-    cli = TaskmuxCLI()
-    cli.tmux.list_tasks()
-
-
 @app.command()
 def start(
-    task: str | None = typer.Argument(None, help="Task name (omit for all)"),
+    tasks: list[str] = typer.Argument(None, help="Task names (omit for all)"),  # noqa: B008
 ):
-    """Start all tasks or a specific task."""
+    """Start tasks (all if none specified)."""
     cli = TaskmuxCLI()
-    if task:
-        cli.tmux.start_task(task)
+    if tasks:
+        for task in tasks:
+            cli.tmux.start_task(task)
     else:
         cli.tmux.start_all()
 
 
 @app.command()
 def stop(
-    task: str | None = typer.Argument(None, help="Task name (omit for all)"),
+    tasks: list[str] = typer.Argument(None, help="Task names (omit for all)"),  # noqa: B008
 ):
-    """Stop all tasks or a specific task (graceful C-c)."""
+    """Stop tasks (all if none specified)."""
     cli = TaskmuxCLI()
-    if task:
-        cli.tmux.stop_task(task)
+    if tasks:
+        for task in tasks:
+            cli.tmux.stop_task(task)
     else:
         cli.tmux.stop_all()
 
 
 @app.command()
 def restart(
-    task: str | None = typer.Argument(None, help="Task name (omit for all)"),
+    tasks: list[str] = typer.Argument(None, help="Task names (omit for all)"),  # noqa: B008
 ):
-    """Restart all tasks or a specific task."""
+    """Restart tasks (all if none specified)."""
     cli = TaskmuxCLI()
-    if task:
-        cli.tmux.restart_task(task)
+    if tasks:
+        for task in tasks:
+            cli.tmux.restart_task(task)
     else:
         cli.tmux.restart_all()
 
@@ -160,11 +156,15 @@ def remove(
         console.print(f"Task '{task}' not found in config", style="red")
 
 
-@app.command()
-def status():
-    """Show session status."""
+def _status():
+    """Show session and task status."""
     cli = TaskmuxCLI()
-    cli.tmux.show_status()
+    cli.tmux.list_tasks()
+
+
+app.command(name="status")(_status)
+app.command(name="list", hidden=True)(_status)
+app.command(name="ls", hidden=True)(_status)
 
 
 @app.command()

{taskmux-0.2.6 → taskmux-0.2.7}/taskmux/tmux_manager.py

@@ -694,8 +694,12 @@ class TmuxManager:
                     console.print(f"[{color}]{prefix}[/{color}] {escape(line)}")
 
     def list_tasks(self) -> None:
-        """List all tasks and their status"""
-        print(f"Session: {self.config.name}")
+        """List all tasks and their status."""
+        exists = self.session_exists()
+        print(f"Session '{self.config.name}': {'Running' if exists else 'Stopped'}")
+        if exists:
+            windows = self.list_windows()
+            print(f"Active tasks: {len(windows)}")
         print("-" * 70)
 
         if not self.config.tasks:
@@ -709,22 +713,14 @@ class TmuxManager:
                 "Healthy" if status["healthy"] else "Running" if status["running"] else "Stopped"
             )
             auto = "" if task_cfg.auto_start else " [manual]"
+            port = f" :{task_cfg.port}" if task_cfg.port else ""
             extras = ""
             if task_cfg.cwd:
                 extras += f" cwd={task_cfg.cwd}"
             if task_cfg.depends_on:
                 extras += f" deps=[{','.join(task_cfg.depends_on)}]"
-            print(f"{health_icon} {status_text:8} {task_name:15} {task_cfg.command}{auto}{extras}")
-
-    def show_status(self) -> None:
-        """Show overall session status"""
-        exists = self.session_exists()
-        print(f"Session '{self.config.name}': {'Running' if exists else 'Stopped'} (libtmux)")
-
-        if exists:
-            windows = self.list_windows()
-            print(f"Active tasks: {len(windows)}")
-            self.list_tasks()
+            line = f"{health_icon} {status_text:8} {task_name:15}{port:7} {task_cfg.command}"
+            print(f"{line}{auto}{extras}")
 
     def check_task_health(self, task_name: str) -> bool:
         """Check if a task is healthy"""