smug(1)

📦 version 0.3.19, in nixos 26.05, nixpkgs unstable

💅 smug(1) — like, the manual page, bestie

okay so this is smug, section 1 of the manual, and it's a session manager for tmux written in go — yes the whole thing is written in Go, we love that for it 🫶

✨ SYNOPSIS ✨

smug [options] [command]

that's it. that's the whole vibe. options first, command after, slay 💅

🌸 DESCRIPTION 🌸

smug is a session manager for tmux, no cap. the way it handles configuration is inspired by tmuxinator and tmuxp — so if you already know those, it's giving familiar-but-better, iykyk 💖

🎀 GLOBAL OPTIONS 🎀

  • -d, --debug — prints all the commands to ~/.config/smug/smug.log so you can peek at exactly what's going down 🔍 like a little diary for your tmux session, obsessed

👑 COMMANDS 👑

list

display all your smug project configurations. a full little lineup of everything you've got going on ✨

start [<projectname>]

start a tmux project session. main character energy fr fr 🔥

COMMAND OPTIONS

  • -f, --file — a custom path to a config file, for when you're not feeling the default location 🗂️
  • -w, --windows — list of windows to start. and listen, if the session already exists, those windows get attached to the current session instead — very much a "the more the merrier" situation 🪟
  • -a, --attach — force switch client for a session. like, no negotiating, we're switching 😤

stop [<projectname>]

stop a tmux project session. bye bestie 👋 it's giving closure

rm [<projectname>]

remove a project configuration. it asks for confirmation before deleting — thank god honestly, because accidental deletion is NOT the vibe 🙈

switch [<projectname>]

switch to a tmux project session. it's literally an alias for start --attach, so same energy, shorter to type 💅

print

print the current session configuration as yaml to stdout. yaml girlies rise 🌈

⭐ EXAMPLES ⭐

like, just look at these, they ate:

$ smug list
$ smug start blog
$ smug start blog:win1
$ smug start blog -w win1
$ smug start blog:win1,win2
$ smug stop blog
$ smug start blog --attach
$ smug print > ~/.config/smug/new_project.yml
$ smug rm blog
$ smug switch blog

the blog:win1,win2 one?? multi-window with the colon and comma syntax?? iconic 🦋

🦋 AUTHOR 🦋

Ivan Klymenchenko — thank you for this gift, king 👑

💜 SEE ALSO 💜

project homepage, go click it bestie:

https://github.com/ivaaaan/smug

🌺 LICENSE 🌺

MIT. free to use, periodt 🎀

and that's the whole page!! smug 0.2.0, dated Mar 2021 — oldie but a goodie, still slaying in the terminal to this day 💖✨🧚

📦 where this page comes from