~/
├── vikix/                     the checkout: Vikix itself (see below)
│
├── .stumpwm.d/
│   ├── init.lisp              Vikix's   loads Vikix's layer, then rules.lisp and user.lisp
│   ├── vikix/                 Vikix's   the layer: errors, theme, groups, registry, commands, windows, rules, viri, drawer, layouts, overview, resume, day, why, used, keys, help, webapps, modeline, plugins, rescue, door, swank-guard, swank, socket
│   ├── rules.lisp             yours     your rules for the desktop: copied once, every example switched off; Super+Shift+t adds to it (rules.md)
│   ├── user.lisp              yours     your StumpWM settings; loaded last, so they win
│   └── modules/               stumpwm-contrib, cloned by 30-lisp (swm-gaps, ttf-fonts, ...)
│
├── .xinitrc                   Vikix's   runs vikix-session inside dbus-run-session
├── .bash_profile              yours     with Vikix's marked blocks: PATH, read .bashrc, startx on tty1
├── .bashrc                    yours     with one marked block at the top that reads vikix.bash
├── .Xresources                yours     text size (Xft.dpi) and cursor size
├── .sbclrc                    yours     loads Quicklisp (added by 30-lisp)
├── .slime-secret              yours     Swank's password (600): Emacs and vikix eval send it
│
├── .config/
│   ├── vikix/
│   │   ├── vikix.bash         Vikix's   aliases, prompt, fzf/zoxide/atuin setup
│   │   ├── keyboard           yours     layout and XKB options
│   │   ├── network/preferences.json  yours  discovery choice for each network (Network Office)
│   │   ├── plugins.list       yours     the plugins you added (vikix plugin add); "NAME from REPO at COMMIT" is one from another repository, at the commit you pinned; "#off " in front, one switched off
│   │   ├── tray               yours     the tray in the bar: on or off (vikix tray switches it), and the applets it starts
│   │   ├── plugins/NAME/      yours     your settings for plugin NAME (copied once)
│   │   ├── obsidian           yours     vikix obsidian's vault, where its notes go, and the folders it leaves out
│   │   ├── idle               yours     minutes before lock, dark screen, suspend (make it; see customize.md)
│   │   ├── backup             yours     where backups go, and the reminder's days
│   │   ├── backup-exclude     yours     what backups leave out
│   │   ├── backup-password    yours     the backup password (never in snapshots)
│   │   ├── secrets/           yours     API keys, one file each (vikix ai key), and windows-password, your Windows account's (vikix windows apps); never in snapshots
│   │   ├── ai                 yours     which model Super+i uses: use=local, claude or codex, model=, translate_model=, effort=, languages=
│   │   ├── agent              yours     which agent Super+a starts (vikix agent --default NAME)
│   │   ├── dictation          yours     dictation's model: base.en, small or large-v3-turbo (vikix dictate models)
│   │   ├── voice              yours     how the AI talks back: voice=, speak=, idle= (vikix voice)
│   │   ├── notes              yours     the folder `note` reads: folder=, skip=, embed= (note index)
│   │   ├── projects           yours     where `vikix project` looks: root=, depth=, logs= (copied once, all comments)
│   │   ├── features           yours     the features you chose (vikix add, vikix remove, vikix features)
│   │   ├── packages-skip      yours     packages you dropped (vikix pkg drop); updates leave them out
│   │   ├── windows            yours     where the Windows VM's disk is
│   │   ├── webapps            yours     your web apps: NAME URL [KEY] (vikix webapp)
│   │   ├── docs-browser       yours     the browser for guides and docs, one word (make it; Nyxt without it, when installed)
│   │   ├── docs-links         yours     your own links for the catalogue, a URL and its title a line (make it; listed, never fetched)
│   │   ├── wallpaper          yours     a link to the picture you chose
│   │   ├── wallpaper-off      yours     exists if you set the wallpaper with your own tool
│   │   ├── titlebars-off      yours     exists if you turned the title bars off (Super+Ctrl+y)
│   │   ├── gestures           yours     the touchpad's sweeps: fingers, distance, natural (vikix gestures)
│   │   ├── wallpaper-theme    yours     exists if the wallpaper follows the theme instead of cycling
│   │   ├── wallpaper-minutes  yours     how often the wallpaper changes when cycling (vikix-wallpaper cycle MINUTES; 30 without it)
│   │   ├── themes/            yours     your own themes (NAME.theme, NAME.jpg)
│   │   └── theme/             written   each program's colours, and `current`, the theme you chose (`vikix theme`); GTK's and Qt's too: `mode` (dark or light), xsettingsd.conf, gtk4.css, qt6ct-colors.conf
│   ├── alacritty/alacritty.toml   yours  imports ../vikix/theme/alacritty.toml
│   ├── picom/picom.conf           yours  the compositor: shadows, fading, backend
│   ├── dunst/dunstrc              yours  notifications
│   ├── dunst/dunstrc.d/10-vikix-theme.conf   written   the theme's colours for dunst
│   ├── rofi/config.rasi           yours  the launcher and menus
│   ├── gammastep/config.ini       yours  night light times and colours
│   ├── mimeapps.list              yours  which program opens which kind of file
│   ├── fontconfig/conf.d/50-vikix-iosevka.conf   Vikix's   monospace means Iosevka
│   ├── autorandr/                 yours     screen layouts, one folder each (Vikix's are auto-…); predetect.d/vikix, Vikix's, lays out a screen with none
│   ├── udiskie/config.yml         yours, if you make it: replaces Vikix's udiskie settings
│   ├── nyxt/config.lisp           yours     with the feature lisp-apps: Nyxt's settings, in Lisp; loads Vikix's part first (the desktop's colours)
│   └── nvim/                      yours     with the feature neovim: init.lua (your settings at its end), your plugins in lua/plugins/, lazy-lock.json
│
├── .emacs.d/                  with the feature emacs: a git clone of the Emacs config (vukini/emacs-void)
├── .claude/skills/vikix       Vikix's   tells Claude Code how Vikix works: SKILL.md, the short first page, and a page a subject
│
├── .local/
│   ├── bin/
│   │   ├── vikix, vikix-*     Vikix's   the command and its helpers
│   │   ├── stumpwm            built     the window manager, built by 30-lisp (`vikix rebuild-wm`)
│   │   └── pil, claude, ...   installed by 65-languages, the npm language servers, Claude Code
│   ├── share/applications/*.desktop   Vikix's   JupyterLab, vikix-image, Lazarus in the launcher (Super+d); your web apps' too, Lem's and the Listener's (lisp-apps), Esploro's, and the Windows programs you added (vikix-win-NAME.desktop, vikix windows apps add)
│   ├── share/vikix/fonts/wm.ttf       built     the bar's font, made by vikix-font
│   ├── share/vikix/nvim               Vikix's   Vikix's part of Neovim: AstroNvim and Vikix's plugins (a link to config/nvim)
│   ├── share/vikix/nyxt/vikix.lisp    Vikix's   Vikix's part of Nyxt: its colours from vikix theme's palette, followed live, and Swank on 127.0.0.1:4006 with ~/.slime-secret (a link to config/nyxt)
│   ├── share/vikix/epubcheck/         fetched   epubcheck, W3C's EPUB validator: a pinned release, checked against its checksum (vikix publish setup)
│   ├── share/vikix/hunspell/          fetched   the spelling's dictionaries: LibreOffice's British English, Esperanto and Arabic, pinned and checksummed (vikix publish setup)
│   ├── share/vikix/publish            Vikix's   the make targets a book's Makefile includes (epub, pdf, check), and the build behind them (a link to lib/publish)
│   ├── share/vikix/emacs              Vikix's   Vikix's part of Emacs: vikix-ai.el, gptel on vikix ai use's model and your agent in agent-shell; vikix-theme.el, the theme following vikix theme; vikix-notes.el, the notes under C-c n (a link to config/emacs)
│   ├── share/info/vikix.info          written   these guides as an Info manual (`info vikix`)
│   ├── share/man/man1/*.1             written   a man page for every vikix command (`man vikix`, `man vikix-backup`) and for your plugins' commands (`man inbox`), made from what each -h prints; other programs' pages here are left alone
│   ├── share/vikix/guide/             written   these guides as web pages, with the diagrams (Super+m → Vikix guide in the browser: in Nyxt when it's installed, through vikix-docs-open)
│   ├── share/dbus-1/services/org.freedesktop.FileManager1.service   Vikix's   the browsers' "Show in folder" opens Esploro (vikix add esploro)
│   ├── share/vikix/wallpapers/        fetched   Vid's wallpapers, a git clone (vikix add wallpapers; a link to ~/wallpapers if that's a clone of it)
│   ├── share/vikix/whisper/           fetched   dictation's model and voice detector (vikix dictate)
│   ├── share/vikix/piper/             fetched   the voice the AI talks with (vikix voice)
│   ├── share/vikix/notes/index.db     written   note's index: passages of your notes and their embeddings (folder 700; note index)
│   ├── share/vikix/AGENTS.md          written   the skill as a guide for Codex, Gemini, Antigravity, Aider (linked as ~/.codex/AGENTS.md, imported by ~/.gemini/GEMINI.md, included by ~/.gemini/antigravity-cli/rules/vikix.md)
│   ├── opt/picolisp/          built     PicoLisp, from source (with the feature lisp)
│   ├── share/vikix/plugins/   Vikix's   the plugins repo at its pinned commit (vikix plugin sync)
│   ├── share/vikix/plugins-from/NAME/  Vikix's   a plugin from another repository: its repository at the commit you pinned (vikix plugin add NAME --from REPO, vikix plugin pin)
│   ├── share/vikix/records.db made       what plugins found and kept (vikix records; SQLite, 600)
│   ├── share/vikix/docs/index.db made    the docs catalogue (vikix docs, Super+F2): every document's title and words; made again from the files
│   ├── opt/lem/               built     Lem, the editor in Common Lisp (vikix add lisp-apps)
│   ├── opt/mcclim/            built     McCLIM's Listener, with Clouseau (vikix add lisp-apps)
│   ├── opt/esploro/           built     Esploro, the file explorer: its command, and emacs/esploro.el, its window in Emacs (vikix add esploro)
│   ├── opt/hype/              built     Hype, Markdown slides (vikix add hype); ~/.local/bin/hype runs it
│   ├── opt/ollama/            built     Ollama, for local AI models (vikix ai setup)
│   ├── opt/whisper.cpp/       built     dictation's speech-to-text, built for this computer (vikix dictate setup)
│   ├── share/libvirt/images/  the Windows VM's disk and its driver disc (not backed up)
│   ├── share/vikix/webapps/   each web app's own Chromium profile: its logins (caches not backed up)
│   └── state/vikix/           Vikix's record of this machine (see below)
│
├── quicklisp/                 Common Lisp libraries; StumpWM is built from here
├── .lazarus/                  Lazarus with the docked IDE, built by 65-languages
│
├── dev/                       yours, with parts written for you (see below); a folder per language you added
├── learn/c/                   yours: your work in vikix learn c, one folder a lesson (copied once; the checks stay in ~/vikix/learn)
├── .ollama/models/            local AI models (vikix ai models): big, not backed up
├── vikix-debug-*.txt           the reports vikix debug writes (yours to delete; vikix diagnose's are in ~/.local/state/vikix/diagnose/)
├── .config/io.datasette.llm/  llm's settings and its log of everything asked (vikix ai llm)
├── journal/                   yours     the diary: a day a file, written by vikix day (700; what you write under Notes is kept)
├── Pictures/Screenshots/      Shift+Print and friends
├── Videos/Recordings/         Super+Ctrl+v
├── Windows/                   yours     drive Z: in the Windows VM (vikix windows); ~/Documents is drive Y: there once vikix windows apps setup has run
└── Restored/                  `vikix backup restore` puts files here, never over yours