macOS
Homebrewverified · 100%
brew install smuglocal Homebrew formula metadata
MacPortsverified · 94%
sudo port install smugMacPorts ports tree · sysutils/smug/Portfile · source: api.github.com
brew / rank 4236
Install smug with Homebrew, MacPorts, Nix
Automate your tmux workflow. Version 0.3.19 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#smug.
install
Additional install commands
Linux
Nixverified · 92%
nix profile install nixpkgs#smugnixpkgs package indexes · pkgs/by-name/sm/smug/package.nix · source: api.github.com
overview
Package summary
Automate your tmux workflow
Project links
Commands and aliases
- smug
history
Project history and usage
Smug is a Go command-line session manager and task runner for tmux, aimed at starting a terminal development environment from one YAML configuration.
Project history
The official repository was created in December 2020, and its first GitHub release, v0.1.0, was published two days later. The README describes it as inspired by tmuxinator and tmuxp, placing it in the long-running tmux session-manager niche.
Adoption history
Smug is packaged for Homebrew, MacPorts, Nix, and Arch AUR according to the official README and supplied package metadata, which makes it a small but broadly discoverable terminal-workflow utility.
How it is used
Users define windows, panes, roots, hooks, and commands in YAML files under ~/.config/smug or in a project .smug.yml, then run commands such as smug start, smug stop, or smug <project>.
Why package nerds care
Package maintainers care about Smug because it is a compact Go CLI with release binaries and a familiar Homebrew-style install path, filling the same ergonomic space as tmuxinator/tmuxp without a Ruby or Python runtime.
Timeline
- 2020: Official GitHub repository created.
- 2020: v0.1.0 published on GitHub releases.
- 2026: Official README lists Homebrew and MacPorts installation paths.
Related projects
- tmux
- tmuxinator
- tmuxp
Sources
- https://api.github.com/repos/ivaaaan/smug
- https://api.github.com/repos/ivaaaan/smug/releases
- https://github.com/ivaaaan/smug
- input source_facts.package-manager
security posture
Risk level: green
narrow executable package without higher-risk signals.
Risk classifier
green risk · low confidence · appliance
Why
- narrow executable package without higher-risk signals
Signals
- metadata:no-higher-risk-signals
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.config/smug/*.yml.smug.yml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
smug | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version0.3.19
manager updated2026-07-26
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:smug |
|---|---|
| Version | 0.3.19 |
| Package manager | Homebrew |
| Homepage | https://github.com/ivaaaan/smug |
| Repository | https://github.com/ivaaaan/smug |
| Last updated | 2026-07-26T04:03:42+02:00 |
| Pulse | updated |
| Bottle | not recorded |
| Service | none declared |
source database matches
Other package-manager records
Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.
Nix95%
smug
nix profile install nixpkgs#smug- normalized package name match
- Matched by: Smug
MacPorts95%
smug
sudo port install smug- normalized package name match
- Matched by: Smug
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- external package-manager database matches
- pkg.so package database
- pkgdb category and tag curation