@@ -1,124 +0,0 @@
1-# dotfiles
2-
3-Personal configs for a KDE Plasma 6 + Alacritty + Neovim setup on CachyOS (Arch).
4-
5-Everything uses the [0x96f](https://github.com/0x96f-org/) color palette, with
6-coordinated dark/light switching that follows KDE's sunrise/sunset schedule.
7-
8-## What's in here
9-
10-```
11-alacritty/ Alacritty terminal config + 0x96f dark/light themes
12-codium/ VSCodium settings + extensions list
13-nvim/ Neovim config (lazy.nvim, LSP, fzf-lua, ANSI color scheme)
14-pi/ pi coding agent themes (0x96f-dark, 0x96f-light)
15-shell/ Bash config — aliases, prompt with exit status & timer, git info
16-theme-switcher/ D-Bus watcher that syncs all tools with KDE dark/light mode
17-```
18-
19-## Installation
20-
21-```bash
22-# Everything
23-./install.sh
24-
25-# Specific configs
26-./install.sh nvim
27-./install.sh alacritty theme-switcher pi
28-```
29-
30-Each config either symlinks into `~/.config/` or runs its own `install.sh` for
31-custom placement.
32-
33-## Color Coordination
34-
35-All tools share the same 0x96f palette. The theme switcher daemon keeps
36-everything in sync when KDE toggles between dark and light mode:
37-
38-```
39-KDE sunrise/sunset toggle
40- → D-Bus signal (org.freedesktop.appearance)
41- → alacritty-theme-switcher
42- ├─ Alacritty cp dark.toml/light.toml → current-theme.toml (live reload)
43- ├─ pi jq .theme → settings.json (next session)
44- ├─ Neovim writes ~/.local/state/kde-color-mode (<leader>T toggle)
45- ├─ VSCodium built-in window.autoDetectColorScheme (automatic)
46- └─ (extensible — anything can read the signal file)
47-```
48-
49-### Neovim specifics
50-
51-The `ansi.vim` colorscheme uses **cterm ANSI indices only** (`set notermguicolors`),
52-so nvim inherits its colors directly from the terminal. When Alacritty's theme
53-changes, nvim gets new colors immediately. The `theme-sync.lua` plugin polls a
54-signal file to flip `background=dark/light`, which re-sources the colorscheme
55-to adjust UI elements (status line, cursor line, popups, etc.) that need
56-different treatment on light vs dark backgrounds.
57-
58-## Details
59-
60-### Shell (`shell/`)
61-
62-Full reference bashrc is in `shell/bashrc`. Key features:
63-
64-- **Two-line prompt**: `HH:MM:SS exit_code duration ~/path (branch*)` on the
65- first line, `$ ` on the second.
66-- **Command timer**: uses a `DEBUG` trap + `$SECONDS` — pure bash, no
67- external dependencies.
68-- **Git branch + dirty flag** in the prompt.
69-- `greet` function: random cowsay + fortune + lolcat on shell start.
70-- fzf integration, aliases for git/nvim.
71-
72-### Alacritty (`alacritty/`)
73-
74-- Config with `live_config_reload = true`.
75-- Colors live in a separate `current-theme.toml` imported via Alacritty's
76- `import` directive — the theme switcher writes this file.
77-- Two themes based on the [0x96f palette](https://github.com/0x96f-org/0x96f-term-theme):
78- - `themes/dark.toml` — dark background (`#262427`)
79- - `themes/light.toml` — light complement (`#fafafa`)
80-
81-### Pi (`pi/`)
82-
83-Custom themes for the [pi](https://github.com/badlogic/pi-mono) coding agent:
84-
85-- `0x96f-dark.json` — mapped from the dark palette
86-- `0x96f-light.json` — mapped from the light palette
87-
88-Both use the same semantic mapping: cyan for accents, blue for borders,
89-magenta for keywords, green for strings, yellow for headings/types.
90-
91-### Theme Switcher (`theme-switcher/`)
92-
93-A bash script + systemd user service that watches KDE's dark/light mode via
94-D-Bus (`org.freedesktop.portal.Settings`).
95-
96-**Dependencies:** `dbus-monitor` (usually pre-installed), `jq` (for pi
97-settings; gracefully skipped if absent).
98-
99-**Service management:**
100-
101-```bash
102-systemctl --user status alacritty-theme-switcher
103-journalctl --user -u alacritty-theme-switcher -f
104-```
105-
106-### VSCodium (`codium/`)
107-
108-- Settings with `window.autoDetectColorScheme` for automatic dark/light switching.
109-- `preferredDarkColorTheme`: **0x96f** (from marketplace).
110-- `preferredLightColorTheme`: **0x96f Light** (custom, built in `~/src/0x96f-light-codium-theme`).
111-- `extensions.txt` — list of installed extensions for reproducible setup.
112-
113-### Neovim (`nvim/`)
114-
115-See [`nvim/README.md`](nvim/README.md) for details.
116-
117-## Requirements
118-
119-- Bash 4+
120-- Neovim ≥ 0.9
121-- Alacritty ≥ 0.13 (for `import` support)
122-- KDE Plasma 6 (for the theme switcher D-Bus integration)
123-- Optional: `fortune`, `cowsay`, `lolcat` (shell greeting)
124-- Optional: `jq` (pi theme switching)