otty / apps
All apps/Smug

Smug

smug

Session manager and task runner for tmux.

Runs as smug|macOS, Linux, Windows|github.com
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 11 fields

Start or stop a tmux session from a project file. Creating, editing and printing projects, and custom ${variable} settings, are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui smug

smug start

Start a session

Start a project from ~/.config/smug or a custom file.

Start a sessionExample values, fixed in this page — nothing here reaches a terminal
Basic
Project*
string
Only these windows
string
TasksEach one presets the form for one job
Start a project
projectwindows
Start in a worktree
projectworktree
ParametersOnly these flags are editable in the form
Project
string · positional 0
Config file
path
--file-f
Only these windows
string · repeatable
--windows-w
Git worktree (branch or directory)
string
--worktree
Force switch client
boolean
--attach-a
Detach session
boolean
--detach
Create windows inside current session
boolean
--inside-current-session-i
Log commands to smug.log
boolean
--debug-d

smug stop

Stop a session

Stop a project session, or only some windows.

Stop a sessionExample values, fixed in this page — nothing here reaches a terminal
Basic
Project*
string
TasksEach one presets the form for one job
Stop a project
project
ParametersOnly these flags are editable in the form
Project
string · positional 0
Config file
path
--file-f
Only these windows
string · repeatable
--windows-w
SourcesEvery flag above is checked against these
smug-readme
smug <command> [<project>] [-f, --file <file>] [--worktree <worktree>] [-w, --windows <window>]... [-a, --attach] [-d, --debug] -f, --file A custom path to a config file --worktree Use the git worktree (by branch or directory name) as the session root -w, --windows List of windows to start. -a, --attach Force switch client for a session -i, --inside-current-…
manualmaster README

github.com

smug-readme
smug <command> [<project>] [-f, --file <file>] [--worktree <worktree>] [-w, --windows <window>]... [-a, --attach] [-d, --debug] -f, --file A custom path to a config file --worktree Use the git worktree (by branch or directory name) as the session root -w, --windows List of windows to start. -a, --attach Force switch client for a session -i, --inside-current-…
manualmaster README

github.com

Before it fills your prompt, Otty checks the installed smug against its version. A form that does not match your version is not offered.