From 7d7f85f3e1415cfacb1a6794e453ad93ea3bddb2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Sebastian=20Kr=C3=BCger?= <valknar@pivoine.art>
Date: Sun, 21 Jun 2026 16:46:53 +0200
Subject: [PATCH] docs(home): update README to reflect cleaned-up arty.yml

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 README.md | 80 ++++++++++++++++++++++++++++---------------------------
 1 file changed, 41 insertions(+), 39 deletions(-)

diff --git a/README.md b/README.md
index 95b8395..f3e6129 100755
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@
 
 ```bash
 # 1. Clone this unholy repository
-git init && git remote add origin ssh://git@dev.pivoine.art/valknar/home.git
+git init && git remote add origin ssh://git@dev.pivoine.art:2222/valknar/home.git
 git fetch && git reset --hard origin/main
 git branch --set-upstream-to=origin/main main
 
@@ -60,58 +60,59 @@ git branch --set-upstream-to=origin/main main
 git config --global init.defaultBranch main
 git config --global --add safe.directory /home/$USER
 
-# 3. Sync all dependencies (version managers, shell config, etc.)
-arty.sh sync
+# 3. Enable contrib/non-free repos and install base packages
+arty debian:setup:contrib
+arty debian:upgrade
+arty debian:install:base
+arty debian:install:libs
+arty debian:install:tools
 
-# 4. Install system packages
-arty.sh debian/update && arty.sh debian/install
+# 4. Sync all dependencies (version managers, shell config, etc.)
+arty deps
 
 # 5. Install development tools
-arty.sh rust/install
-arty.sh node/install
-arty.sh ruby/install
-arty.sh python/install
+arty rust:install
+arty node:install && arty node:install:base
+arty ruby:install && arty ruby:install:base
+arty python:install
+arty go:install && arty go:install:tools
+arty docker:install
 
-# 6. Install global packages
-arty.sh npm/install
-arty.sh gem/install
-
-# 7. Source the shell configuration
+# 6. Source the shell configuration
 source ~/.zshrc
 ```
 
 ---
 
-## arty.sh - REPOSITORY ORCHESTRATION
+## arty - REPOSITORY ORCHESTRATION
 
 ### Available Scripts
 
 ```bash
 # System setup
-arty.sh debian/update       # Enable non-free repos and update sources
-arty.sh debian/install      # curl, wget, zsh, fzf, davfs2, make, imagemagick, ffmpeg, yt-dlp, pkg-config, zstd, libffi-dev, libyaml-dev, libssl-dev, liblzma-dev, libbz2-dev, libncurses-dev, libreadline-dev, libsqlite3-dev, python3-tk
+arty debian:setup:contrib   # Enable contrib/non-free repos
+arty debian:upgrade         # apt update && apt upgrade
+arty debian:install:base    # build-essential, curl, wget, git, zsh, bat, fzf, make...
+arty debian:install:libs    # dev libs: libffi, zlib, libyaml, libssl, libsqlite3...
+arty debian:install:tools   # imagemagick, rsvg-convert, ffmpeg, yt-dlp
 
 # Development tools
-arty.sh docker/install      # Docker Engine with user group
-arty.sh rust/install        # Rust toolchain via rustup
-arty.sh node/install        # Node.js via nvm
-arty.sh ruby/install        # Ruby via rbenv
-arty.sh python/install      # Python via pyenv
-arty.sh go/install          # Go via apt
-arty.sh hugo/install        # Hugo extended via go install
-
-# CLI tools
-arty.sh claude/install      # Claude AI CLI
-arty.sh yq/install          # yq YAML processor
-arty.sh gh/install          # GitHub CLI
-arty.sh tailscale/install   # Tailscale
-arty.sh ollama/install      # Ollama
+arty rust:install           # Rust toolchain via rustup
+arty node:install           # Node.js via nvm
+arty node:install:base      # npm + pnpm globally
+arty ruby:install           # Ruby via rbenv
+arty ruby:install:base      # bundler gem
+arty python:install         # Python via pyenv
+arty go:install             # Go via apt
+arty go:install:tools       # hugo (extended) + yq via go install
+arty go:clean               # Clear go build and module cache
+arty docker:install         # Docker Engine with user group
 ```
 
-### What arty.sh Manages
+### What arty Manages
 
 - **Version managers** (nvm, rbenv, pyenv)
-- **Shell configuration** (Oh-My-Zsh, Powerlevel10k, plugins)
+- **Shell configuration** (Oh-My-Zsh, Powerlevel10k, zsh plugins)
 
 ---
 
@@ -134,12 +135,13 @@ Available scripts: `stacks.sh` (Docker Compose stack manager), `arty.sh` (reposi
 |   +-- plugins/ruby-build/
 +-- .pyenv/                 # Python Version Manager
 +-- .oh-my-zsh/             # Oh-My-Zsh framework
-|   +-- custom/
-|       +-- themes/
-|       |   +-- powerlevel10k/
-|       +-- plugins/
-|           +-- zsh-autosuggestions/
-|           +-- zsh-syntax-highlighting/
++-- .zsh/
+|   +-- themes/
+|   |   +-- powerlevel10k/
+|   +-- plugins/
+|       +-- zsh-autocomplete/
+|       +-- zsh-autosuggestions/
+|       +-- zsh-syntax-highlighting/
 ```
 
 ---