Run Tab
The Run tab in the right sidebar scans your workspace for task-runner files and lists every discovered task. Click a task to open a terminal and execute it — no memorizing CLI syntax.
Supported runners
Section titled “Supported runners”| Runner | File | Command pattern |
|---|---|---|
| npm | package.json (scripts section) | npm run <name> |
| Taskfile | Taskfile.yml / Taskfile.yaml | task <name> |
| Mix | mix.exs (Elixir) | mix <name> |
| VS Code Tasks | .vscode/tasks.json | Varies by task type |
Discovery walks the worktree recursively, skipping generated directories (node_modules, target, _build, deps, vendor, dist, build, __pycache__) and hidden directories (except .vscode).
Directory-first grouping
Section titled “Directory-first grouping”Tasks are grouped by the directory where the runner file was found, shallowest first. This makes monorepo navigation natural — you find “build the API” under packages/api, not buried in a flat list sorted by runner type.
Pin and hide
Section titled “Pin and hide”Right-click any task to pin it to the top of the Run tab or hide it from the list. Preferences persist per workspace in the database and survive app restarts.
A pinned task that no longer exists in the worktree (e.g., after switching branches) appears as a missing placeholder with a warning icon. It cannot be executed but can still be unpinned.
Show hidden toggle
Section titled “Show hidden toggle”When tasks are hidden, an eye icon appears in the Run tab header. Click it to reveal hidden tasks (shown at reduced opacity) so you can unhide them.
Refresh
Section titled “Refresh”The task list refreshes automatically when you switch workspaces or branches. Click the refresh icon in the header to re-scan manually.
Execution
Section titled “Execution”Clicking a task enqueues its command in the workspace terminal. For tasks in nested directories, the command is prefixed with cd <directory> && so it runs from the correct working directory.