rigsmith 0.2.0__tar.gz → 0.3.0__tar.gz

{rigsmith-0.2.0 → rigsmith-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: rigsmith
-Version: 0.2.0
+Version: 0.3.0
 Summary: Set up a fresh macOS or Linux machine from a curated, extensible library of tools and configs
 Author: Slim Frikha
 License-Expression: MIT
@@ -108,7 +108,8 @@ Every flag is in the [reference](docs/reference.md#commands).
 | [`data-engineer`](config/presets/data-engineer.yaml) | Python + SQL in the terminal (DuckDB, Postgres, Kafka), notebooks, cloud CLIs |
 | [`ml-engineer`](config/presets/ml-engineer.yaml) | Python with uv, notebooks, Hugging Face, local LLMs |
 | [`platform`](config/presets/platform.yaml) | Containers, Kubernetes end to end, Terraform and friends, GCP and AWS |
-| [`server`](config/presets/server.yaml) | A headless box over SSH: shell and modern CLI, no fonts or GUI apps |
+| [`ssh`](config/presets/ssh.yaml) | A remote dev box you SSH into (cloud VM, GPU machine): tmux, modern CLI, git, uv, GPU monitor |
+| [`server`](config/presets/server.yaml) | A lean ops box: shell and modern CLI only |
 
 The developer presets share a base (zsh, starship, fzf, ripgrep, eza, zoxide, git, lazygit, VS Code); `server` keeps
 only the shell and CLI part. Every preset pins its answers, so `-y` gives the same result every time. [`reference`](config/reference.yaml) has every tool;

{rigsmith-0.2.0 → rigsmith-0.3.0}/README.md

@@ -89,7 +89,8 @@ Every flag is in the [reference](docs/reference.md#commands).
 | [`data-engineer`](config/presets/data-engineer.yaml) | Python + SQL in the terminal (DuckDB, Postgres, Kafka), notebooks, cloud CLIs |
 | [`ml-engineer`](config/presets/ml-engineer.yaml) | Python with uv, notebooks, Hugging Face, local LLMs |
 | [`platform`](config/presets/platform.yaml) | Containers, Kubernetes end to end, Terraform and friends, GCP and AWS |
-| [`server`](config/presets/server.yaml) | A headless box over SSH: shell and modern CLI, no fonts or GUI apps |
+| [`ssh`](config/presets/ssh.yaml) | A remote dev box you SSH into (cloud VM, GPU machine): tmux, modern CLI, git, uv, GPU monitor |
+| [`server`](config/presets/server.yaml) | A lean ops box: shell and modern CLI only |
 
 The developer presets share a base (zsh, starship, fzf, ripgrep, eza, zoxide, git, lazygit, VS Code); `server` keeps
 only the shell and CLI part. Every preset pins its answers, so `-y` gives the same result every time. [`reference`](config/reference.yaml) has every tool;

rigsmith-0.3.0/config/presets/ssh.yaml

@@ -0,0 +1,74 @@
+# Remote dev box over SSH (cloud VM, GPU machine): a comfortable zsh, tmux sessions that survive disconnects, the
+# modern CLI, git, Python with uv and GPU monitoring. No GUI apps, fonts or VS Code: icons render with your local
+# terminal's font, and VS Code's Remote-SSH brings its own server. For a lean ops box, see the `server` preset.
+# Use it: rigsmith install -c ssh -y   (Linux needs sudo once, for Homebrew and to make zsh the login shell)
+#
+#   minimal        a livable login: zsh, starship, tmux, core CLI, git, uv
+#   standard       a dev box: + history search, disk tools, GPU monitor, Python extras, lazygit, gh
+#   comprehensive  everything: + kubectl/k9s, mosh, more TUIs, delta, huggingface-cli
+profiles: [minimal, standard, comprehensive]
+
+sections:
+  system:
+    bootstrap: {homebrew: minimal, apt-base: minimal}
+
+  shell:
+    core: {zsh: minimal, zinit: minimal}
+    prompt: {starship: minimal}
+    plugins:
+      zsh-autosuggestions: minimal
+      zsh-syntax-highlighting: minimal
+      zsh-completions: standard
+      zsh-history-substring-search: standard
+    history: {atuin: standard}
+    helpers: {shell-aliases: minimal, shell-functions: standard}
+
+  cli:
+    sessions: {tmux: minimal, tmux-config: minimal}
+    files: {eza: minimal, eza-aliases: minimal, tree: standard, yazi: comprehensive}
+    search:
+      ripgrep: minimal
+      ripgrep-aliases: minimal
+      fd: minimal
+      fzf: minimal
+      fd-aliases: standard
+      fzf-functions: standard
+    view-edit: {bat: minimal, bat-aliases: minimal, micro: minimal}
+    navigation: {zoxide: minimal}
+    data: {jq: minimal, yq: standard}
+    system:
+      htop: minimal
+      dust: standard
+      duf: standard
+      ncdu: standard
+      sys-aliases: standard
+      btop: comprehensive
+    network: {wget: standard, mosh: comprehensive}
+    docs: {tldr: comprehensive}
+
+  git:
+    core: {git: minimal, git-aliases: minimal, gh: standard, git-defaults: standard}
+    ui: {lazygit: standard}
+    diff: {delta: comprehensive}
+
+  python:
+    tooling: {uv: minimal, python-aliases: standard, ipython: standard, ruff: comprehensive}
+
+  ml:
+    gpu: {nvitop: standard}
+    models: {huggingface-cli: comprehensive}
+
+  containers:
+    tools: {docker-aliases: standard}
+
+  kubernetes:
+    core: {kubectl: comprehensive, k8s-aliases: comprehensive}
+    ui: {k9s: comprehensive}
+
+answers:
+  profile: standard
+  system-monitor: htop
+  icons: "yes"
+  aliases: "yes"
+  tui: "yes"
+  theme: catppuccin

{rigsmith-0.2.0 → rigsmith-0.3.0}/config/reference.yaml

@@ -40,6 +40,9 @@ sections:
       catppuccin-iterm: standard
 
   cli:
+    sessions:
+      tmux: standard
+      tmux-config: standard
     files:
       eza: minimal
       eza-aliases: minimal
@@ -70,12 +73,14 @@ sections:
       bottom: comprehensive
       btop: comprehensive
       dust: standard
+      ncdu: comprehensive
       duf: standard
       procs: comprehensive
       sys-aliases: standard
     network:
       httpie: standard
       wget: standard
+      mosh: comprehensive
     docs:
       tldr: standard
     misc:
@@ -318,6 +323,8 @@ sections:
       database-client: comprehensive
 
   ml:
+    gpu:
+      nvitop: standard
     notebooks:
       jupyterlab: standard
       marimo: comprehensive

{rigsmith-0.2.0 → rigsmith-0.3.0}/docs/CATALOG.md

@@ -2,7 +2,7 @@
 
 <!-- generated by scripts/gen_catalog.py: edit the library, not this file -->
 
-**234 artifacts** in 23 sections. Profiles are cumulative: `minimal` ⊂ `standard` ⊂ `comprehensive`. ◉ marks a role: only one provider is active at a time.
+**239 artifacts** in 23 sections. Profiles are cumulative: `minimal` ⊂ `standard` ⊂ `comprehensive`. ◉ marks a role: only one provider is active at a time.
 
 [system](#system) · [shell](#shell) · [terminal](#terminal) · [cli](#cli) · [git](#git) · [dev](#dev) · [python](#python) · [go](#go) · [rust](#rust) · [java](#java) · [containers](#containers) · [kubernetes](#kubernetes) · [cloud](#cloud) · [iac](#iac) · [editor](#editor) · [ai](#ai) · [desktop](#desktop) · [web](#web) · [backend](#backend) · [data](#data) · [ml](#ml) · [docs](#docs) · [fun](#fun)
 
@@ -46,6 +46,8 @@
 
 | | artifact | profile | what it is | installed with |
 |---|---|---|---|---|
+| **sessions** | `tmux`  | standard | Terminal multiplexer: sessions survive SSH disconnects. Detach with prefix + d, come back with `ta`. | brew `tmux` |
+|  | `tmux-config`  | standard | Sane tmux defaults (mouse, 50k scrollback, true color, windows from 1); `ta` attaches or creates a session. | zsh snippet · file |
 | **files** | `eza`  | minimal | Modern ls with colors, git status and optional icons. `eza -la --git`, `eza --tree`. | brew `eza` |
 |  | `eza-aliases`  | minimal | ls/ll/la/lt/lsize/ltime → eza (icons when enabled). | zsh snippet |
 |  | `tree`  | standard | Print directory trees. | brew `tree` |
@@ -70,11 +72,13 @@
 |  | `bottom` ◉ system-monitor | comprehensive | Graphical system monitor: CPU, memory, network, disks (`btm`). | brew `bottom` |
 |  | `btop` ◉ system-monitor | comprehensive | Resource monitor with graphs and mouse support. | brew `btop` |
 |  | `dust`  | standard | Intuitive du: which directories eat your disk. | brew `dust` |
+|  | `ncdu`  | comprehensive | Disk usage explorer: browse what fills the disk and delete in place. | brew `ncdu` |
 |  | `duf`  | standard | Friendly df: disk usage overview. | brew `duf` |
 |  | `procs`  | comprehensive | Modern ps with colors, tree view and search. | brew `procs` |
 |  | `sys-aliases`  | standard | top/htop → btm, df → duf, du → dust, ps → procs (each only if installed). | zsh snippet |
 | **network** | `httpie`  | standard | Human-friendly HTTP client: `http GET api.example.com`. | brew `httpie` |
 |  | `wget`  | standard | Download files from the web. | brew `wget` |
+|  | `mosh`  | comprehensive | Mobile shell: an SSH session that survives roaming, sleep and bad networks (needs mosh on both ends). | brew `mosh` |
 | **docs** | `tldr`  | standard | Simplified, example-driven man pages (tlrc client): `tldr tar`. | brew `tlrc` |
 | **misc** | `watch`  | standard | Run a command periodically and show its output. | brew `watch` |
 |  | `tokei`  | comprehensive | Count lines of code by language. | brew `tokei` |
@@ -324,6 +328,7 @@
 
 | | artifact | profile | what it is | installed with |
 |---|---|---|---|---|
+| **gpu** | `nvitop`  | standard | Interactive NVIDIA GPU monitor: utilization, memory and processes per GPU (Linux). | uv tool `nvitop` (linux) |
 | **notebooks** | `jupyterlab`  | standard | JupyterLab, installed as an isolated uv tool. | uv tool `jupyterlab` |
 |  | `marimo`  | comprehensive | Reactive Python notebooks stored as plain .py files. | uv tool `marimo` |
 | **models** | `huggingface-cli`  | standard | Hugging Face Hub CLI: log in, download and upload models and datasets (`hf download …`). | uv tool `huggingface_hub[cli]` |

{rigsmith-0.2.0 → rigsmith-0.3.0}/docs/guide.md

@@ -165,8 +165,8 @@ template.
 Pin the rigsmith version **and** every answer, so a run doesn't depend on library defaults:
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/slimfrkha/rigsmith/v0.2.0/install.sh \
-  | RIGSMITH_VERSION=0.2.0 sh -s -- install -c my-config.yaml -y
+curl -fsSL https://raw.githubusercontent.com/slimfrkha/rigsmith/v0.3.0/install.sh \
+  | RIGSMITH_VERSION=0.3.0 sh -s -- install -c my-config.yaml -y
 ```
 
 Every bundled preset already pins its answers; `server` is a good start for headless machines.

{rigsmith-0.2.0 → rigsmith-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rigsmith"
-version = "0.2.0"
+version = "0.3.0"
 description = "Set up a fresh macOS or Linux machine from a curated, extensible library of tools and configs"
 readme = "README.md"
 requires-python = ">=3.14"

{rigsmith-0.2.0 → rigsmith-0.3.0}/src/rigsmith/library/cli.py

@@ -1,7 +1,17 @@
 """Modern command-line tools and the aliases that swap them in for the classics."""
 
 from rigsmith.library._util import snippet, tool
-from rigsmith.model import Snippet
+from rigsmith.model import Artifact, File, Snippet
+
+# sessions
+tool("tmux", "Terminal multiplexer: sessions survive SSH disconnects. Detach with prefix + d, come back with `ta`.")
+Artifact(
+    id="tmux-config",
+    help="Sane tmux defaults (mouse, 50k scrollback, true color, windows from 1); `ta` attaches or creates a session.",
+    files=[File("tmux.conf", "~/.tmux.conf")],
+    shell=Snippet("tmux-config.zsh", 70),
+    requires=["tmux"],
+)
 
 # files
 tool("eza", "Modern ls with colors, git status and optional icons. `eza -la --git`, `eza --tree`.")
@@ -96,6 +106,7 @@ tool(
 )
 tool("btop", "Resource monitor with graphs and mouse support.", role="system-monitor", tags=["tui"])
 tool("dust", "Intuitive du: which directories eat your disk.")
+tool("ncdu", "Disk usage explorer: browse what fills the disk and delete in place.", tags=["tui"])
 tool("duf", "Friendly df: disk usage overview.")
 tool("procs", "Modern ps with colors, tree view and search.")
 snippet(
@@ -108,6 +119,7 @@ snippet(
 # network
 tool("httpie", "Human-friendly HTTP client: `http GET api.example.com`.", bin="http")
 tool("wget", "Download files from the web.")
+tool("mosh", "Mobile shell: an SSH session that survives roaming, sleep and bad networks (needs mosh on both ends).")
 
 # docs & misc
 tool("tldr", "Simplified, example-driven man pages (tlrc client): `tldr tar`.", brew="tlrc")

rigsmith-0.3.0/src/rigsmith/library/files/tmux.conf

@@ -0,0 +1,11 @@
+# Managed by rigsmith (tmux-config). Put your own settings in ~/.tmux.local.conf.
+set -g mouse on                                  # scroll, select panes and resize with the mouse
+set -g history-limit 50000                       # long scrollback for logs
+set -g default-terminal "tmux-256color"
+set -as terminal-features ",xterm-256color:RGB"  # true color
+set -g base-index 1                              # windows and panes count from 1, like the keyboard
+setw -g pane-base-index 1
+set -g renumber-windows on
+set -sg escape-time 10                           # no lag after Esc in vim/micro
+set -g focus-events on
+if-shell "test -f ~/.tmux.local.conf" "source-file ~/.tmux.local.conf"

{rigsmith-0.2.0 → rigsmith-0.3.0}/src/rigsmith/library/ml.py

@@ -12,4 +12,10 @@ tool(
     bin="hf",
 )
 tool("llm", "Simon Willison's llm: talk to LLMs from the terminal, log everything to SQLite.", sources=[UvTool("llm")])
+tool(
+    "nvitop",
+    "Interactive NVIDIA GPU monitor: utilization, memory and processes per GPU (Linux).",
+    sources=[UvTool("nvitop", os="linux")],
+    tags=["tui"],
+)
 tool("ollama", "Run open LLMs locally: `ollama run llama3.2`.")

rigsmith-0.3.0/src/rigsmith/library/snippets/tmux-config.zsh

@@ -0,0 +1,2 @@
+# ta: attach to the "main" tmux session, or create it (the first thing to type after ssh).
+alias ta='tmux new-session -A -s main'

{rigsmith-0.2.0 → rigsmith-0.3.0}/tests/test_tui.py

@@ -77,7 +77,9 @@ def test_first_run_picks_a_preset_or_a_file(home):
     async def job(app):
         return await choose_base(app, bases)
 
-    name, cfg = drive(job, ["up", "up", "up", "enter"])
+    names = [b.name for b in bases]
+    ups = names.index("reference") - names.index("server")  # the cursor starts on reference
+    name, cfg = drive(job, ["up"] * ups + ["enter"])
     assert name == "server" and cfg.name.endswith("server.yaml")
 
     mine = home / "mine.yaml"

{rigsmith-0.2.0 → rigsmith-0.3.0}/uv.lock

@@ -242,7 +242,7 @@ wheels = [
 
 [[package]]
 name = "rigsmith"
-version = "0.2.0"
+version = "0.3.0"
 source = { editable = "." }
 dependencies = [
     { name = "rich" },