new file mode 100644
index 0000000..cc00382
@@ -0,0 +1,16 @@
+---
+visibility: public
+---
+
+# tmuxinator
+
+declarative tmux session manager. define layouts in YAML, spin them up with one command.
+
+**installed via:** `brew install tmuxinator` (also has completion: `brew install tmuxinator-completion`)
+
+**usage:**
+- `mux dev2` — spins up the full dev environment (aliased via `alias md="mux dev2"`)
+- `mux dev2 ~/code/projectname` — opens dev layout at a specific project directory
+- `pj myproject` — the `init_project` function creates `~/code/myproject` and opens it in a `mux dev2` session
+
+**what it does:** creates pre-defined window splits, names, and starting commands so you don't manually rebuild your workspace every time. combined with [[tmux-resurrect]] and [[tmux-continuum]] for persistence, the full tmux setup means you essentially never lose your workspace.
\ No newline at end of file