CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What This Repo Is

Personal dotfiles for a Linux desktop, currently running Niri (Wayland compositor) with Noctalia as the desktop shell. There are legacy X11 configs (i3, polybar, picom) that are no longer the primary setup.

Deployment

Configs are deployed by symlinking into ~/.config/ and ~/.profile:

bash ~/.dotfiles/setup.sh

The script is idempotent — it skips links that already exist. After adding a new top-level config directory, add a configlink <dirname> line to setup.sh.

Installing Desktop Applications

cd ansible.desktop
./install-desktop-toolsontech.sh

This installs ansible if missing, then runs the playbook. Tasks are split by category in ansible.desktop/tasks/.

Architecture

Niri (Wayland compositor)

niri/config.kdl is just includes — the real config lives in niri/cfg/:

input.kdl — keyboard/mouse/touchpad settings
keybinds.kdl — all keybindings
layout.kdl — gaps, border, window sizing
display.kdl — monitor layout and scaling
autostart.kdl — apps launched on compositor start
rules.kdl — window-specific rules
animation.kdl, misc.kdl — tweaks

Edit the relevant split file, not config.kdl itself.

Noctalia (desktop shell / bar)

All settings live in noctalia/settings.json (JSON, edited by the Noctalia GUI or directly). Colorschemes are in noctalia/colorschemes/ and plugins in noctalia/plugins/.

Neovim

Uses LazyVIM framework. Entry point is nvim/init.lua which bootstraps lazy.nvim via nvim/lua/config/lazy.lua.

nvim/lua/config/ — core config (options, keymaps, autocmds)
nvim/lua/plugins/ — plugin overrides/additions on top of LazyVIM defaults
nvim/lua/colorschemes/ — colorscheme configs

LazyVIM handles most plugin management; only deviations from LazyVIM defaults need entries in lua/plugins/.

tmux

tmux/tmux.conf + catppuccin theme as a git submodule at tmux/plugins/catppuccin/tmux. After cloning, initialize the submodule:

git submodule update --init

Shell / profile

profile is symlinked to ~/.profile. It sets up SSH keys via keychain and defines the notes alias (attaches/creates a tmux session with nvim opening ~/Notes/Personal).

zoxide.bash provides shell integration for zoxide (directory jumping) — sourced separately, not via profile.

2.4 KiB Raw Blame History