Initial import: chezmoi source for Omarchy (Hyprland)
Imported from prdlk/dotfiles master (efdd827), which supersedes the omarchy branch (3031416). Drops the Umbriel, Noctalia, niri, CachyOS, macOS, and Blume docs-site layers; docs/ is plain Markdown.
This commit is contained in:
Prad Nukala committed
commit
b18729f4a0
163 files changed
+12685
No files matched your search
@@ -0,0 +1,16 @@
|
||||
{{- $name := promptStringOnce . "name" "Full name" "Prad Nukala" -}}
|
||||
{{- $email := promptStringOnce . "email" "Email" "prad@sonr.io" -}}
|
||||
{{- $role := promptChoiceOnce . "role" "Machine role" (list "desktop" "laptop" "server") "desktop" -}}
|
||||
|
||||
mode = "symlink"
|
||||
encryption = "age"
|
||||
|
||||
[age]
|
||||
identity = "~/.config/chezmoi/key.txt"
|
||||
recipient = "age19tdqgavaekhvgqsd75n8a09vvshen2ykzy8kw6tenczz73449anqc3l7a6"
|
||||
useBuiltin = true
|
||||
|
||||
[data]
|
||||
name = {{ $name | quote }}
|
||||
email = {{ $email | quote }}
|
||||
role = {{ $role | quote }}
|
||||
@@ -0,0 +1,38 @@
|
||||
# Shell-agnostic aliases — single source of truth, rendered into:
|
||||
# dot_config/fish/conf.d/20-aliases.fish.tmpl (fish)
|
||||
# dot_config/shell/aliases.sh.tmpl (bash + zsh)
|
||||
# Shell-specific bits (clipboard detection, the `q` function, interactive
|
||||
# eza/typo guards) live in those templates, not here.
|
||||
aliases:
|
||||
- section: "Editors / file managers"
|
||||
items:
|
||||
- { name: "e", cmd: "nvim" }
|
||||
- { name: "e.d", cmd: "cd ~/.config/dotstate/storage/Rogz/.config && yazi" }
|
||||
- { name: "e.f", cmd: "cd ~/.config/fish && yazi" }
|
||||
- { name: "e.k", cmd: "yazi ~/.config/kitty" }
|
||||
- { name: "e.v", cmd: "yazi ~/.config/nvim/lua" }
|
||||
- { name: "e.y", cmd: "yazi ~/.config/yazi" }
|
||||
- { name: "e.t", cmd: "nvim ~/.config/tmux/tmux.conf" }
|
||||
- { name: "hx", cmd: "helix" }
|
||||
- section: "Quick directory jumps"
|
||||
items:
|
||||
- { name: "cdc", cmd: "cd ~/.config && yazi" }
|
||||
- { name: "cdd", cmd: "cd ~/Developer && yazi" }
|
||||
- { name: "cdk", cmd: "cd ~/Documents/Knowledge && obsidian" }
|
||||
- { name: "cdl", cmd: "cd ~/.local && yazi" }
|
||||
- { name: "cds", cmd: "cd ~/.local/share/services && ls" }
|
||||
- { name: "cdw", cmd: "cd ~/Downloads && yazi" }
|
||||
- section: "Tools"
|
||||
items:
|
||||
- { name: "dd", cmd: "lazydocker" }
|
||||
- { name: "gg", cmd: "lazygit" }
|
||||
- { name: "ff", cmd: "exec fish" }
|
||||
- { name: "npx", cmd: "bunx" }
|
||||
- { name: "sm", cmd: "sudo micro" }
|
||||
- { name: "sd", cmd: "ssh prad@192.168.1.68" }
|
||||
- { name: "oc", cmd: "opencode" }
|
||||
- { name: "dss", cmd: "dotstate sync" }
|
||||
- { name: "fabric", cmd: "fabric-ai" }
|
||||
- { name: "bk", cmd: "bead-kanban" }
|
||||
- { name: "lc", cmd: "leetcode" }
|
||||
- { name: "tk", cmd: "task" }
|
||||
@@ -0,0 +1,149 @@
|
||||
packages:
|
||||
arch:
|
||||
pacman:
|
||||
# shell + editors
|
||||
- fish
|
||||
- neovim
|
||||
- helix
|
||||
- micro
|
||||
- tmux
|
||||
# terminals (ghostty is the default)
|
||||
- ghostty
|
||||
- kitty
|
||||
# tui tools (tmux-palette, television cables, fish functions)
|
||||
- yazi
|
||||
- lazygit
|
||||
- lazydocker
|
||||
- docker
|
||||
- docker-compose
|
||||
- btop
|
||||
- fastfetch
|
||||
- onefetch
|
||||
- television
|
||||
- serie
|
||||
- tig
|
||||
- gitui
|
||||
- tldr
|
||||
- navi
|
||||
- mdfried
|
||||
# vcs + forge
|
||||
- git
|
||||
- github-cli
|
||||
- git-delta
|
||||
- diffnav
|
||||
- tea
|
||||
# search / files
|
||||
- fzf
|
||||
- fd
|
||||
- ripgrep
|
||||
- zoxide
|
||||
- eza
|
||||
- bat
|
||||
- jq
|
||||
- duf
|
||||
# media / preview (yazi + tv deps)
|
||||
- ffmpeg
|
||||
- ffmpegthumbnailer
|
||||
- poppler
|
||||
- resvg
|
||||
- imagemagick
|
||||
- chafa
|
||||
- 7zip
|
||||
- unzip
|
||||
# remote
|
||||
- mosh
|
||||
- sshfs
|
||||
- tailscale
|
||||
# misc cli
|
||||
- mise
|
||||
- gum
|
||||
- glow
|
||||
- atuin
|
||||
- wget
|
||||
- starship
|
||||
- zsh-syntax-highlighting
|
||||
# fonts
|
||||
- ttf-victor-mono-nerd
|
||||
aur:
|
||||
- topgrade
|
||||
- portop
|
||||
desktop:
|
||||
# linux desktop layer (role desktop|laptop)
|
||||
pacman:
|
||||
- uwsm
|
||||
- xdg-user-dirs
|
||||
# wayland utilities the compositor configs and ~/.local/bin scripts call
|
||||
- wl-clipboard
|
||||
- cliphist
|
||||
- wtype
|
||||
- ydotool
|
||||
- grim
|
||||
- slurp
|
||||
- hyprpicker
|
||||
- pamixer
|
||||
- brightnessctl
|
||||
- libnotify
|
||||
# desktop apps bound in hypr
|
||||
- nautilus
|
||||
- imv
|
||||
- mpv
|
||||
- evince
|
||||
- chromium
|
||||
- obsidian
|
||||
# strata runtime deps (its installer runs `sudo -n pacman`, which fails
|
||||
# without cached credentials, so they come from here instead)
|
||||
- bubblewrap
|
||||
- desktop-file-utils
|
||||
- fontconfig
|
||||
- gstreamer
|
||||
- gst-libav
|
||||
- gst-plugins-base
|
||||
- gst-plugins-good
|
||||
- gtk4
|
||||
- gtksourceview5
|
||||
- gvfs
|
||||
- poppler-glib
|
||||
- xdg-utils
|
||||
# AUR, or a sync repo that ships the same name (yay prefers repos). Only
|
||||
# names no installed package provides are passed on (`pacman -T`).
|
||||
aur:
|
||||
- tldraw-offline-bin
|
||||
# desktop apps
|
||||
- beeper-bin
|
||||
- fastmail
|
||||
- 1password
|
||||
- brave-origin-bin
|
||||
- claude-desktop
|
||||
- spotify
|
||||
# [omarchy] pacman repo (pkgs.omarchy.org); installed only when that repo
|
||||
# is configured. Hyprland, waybar and the omarchy-* scripts come with
|
||||
# the Omarchy install itself and are not listed.
|
||||
omarchy:
|
||||
- herdr
|
||||
- flea
|
||||
- voxtype-bin
|
||||
- xdg-terminal-exec
|
||||
- hyprland-preview-share-picker
|
||||
shared:
|
||||
gh_extensions:
|
||||
- davidraviv/gh-clean-branches
|
||||
- prdlk/gh-commit
|
||||
- dlvhdr/gh-dash
|
||||
- meiji163/gh-notify
|
||||
# cargo installs (run_onchange_after_15-tools, after rustup)
|
||||
cargo:
|
||||
- suvadu
|
||||
- mandible
|
||||
- worktrunk
|
||||
# global mise tools: `mise use -g <tool>` (run_onchange_after_15-tools).
|
||||
# Registry short names where mise has one (`mise registry <tool>`), else a
|
||||
# backend spec; written to ~/.config/mise/config.toml under the same key.
|
||||
mise:
|
||||
- ghq
|
||||
- bun
|
||||
- node
|
||||
- uv
|
||||
- opencode
|
||||
- crush
|
||||
# omp: prebuilt release binaries; not in the mise registry
|
||||
- github:can1357/oh-my-pi
|
||||
@@ -0,0 +1,177 @@
|
||||
# Agent skills, installed by the Skills CLI instead of being vendored in this
|
||||
# repo. .chezmoiscripts/run_onchange_after_25-skills.sh.tmpl re-runs whenever
|
||||
# this file changes: it installs every skill below (`skills add <source> -g -y
|
||||
# -a <agents> --skill <name>…`, one call per source) and removes CLI-installed
|
||||
# skills that are no longer listed.
|
||||
#
|
||||
# source: anything `skills add` accepts — owner/repo (default branch), a
|
||||
# GitHub tree URL (pins a ref or subdirectory), or a well-known endpoint URL.
|
||||
# Skills that upstream deleted are pinned to the last ref that has them.
|
||||
# agents: optional; defaults to `agents` below. `universal` is the shared
|
||||
# ~/.agents/skills library (Codex, Gemini CLI, OpenCode, Zed, …);
|
||||
# `claude-code` links ~/.claude/skills/<name>.
|
||||
#
|
||||
# Not listed (installed by other packages, never touched by the sync):
|
||||
# omarchy and diagnose-crash (/usr/share/omarchy), terminal-browser.
|
||||
skills:
|
||||
cli: skills@1.7.0
|
||||
agents: [universal, claude-code]
|
||||
sources:
|
||||
- source: affaan-m/everything-claude-code
|
||||
skills: [rust-testing]
|
||||
- source: apollographql/skills
|
||||
skills: [rust-best-practices]
|
||||
- source: charlietlamb/openlogs
|
||||
skills: [openlogs-server-logs]
|
||||
- source: cloudflare/skills
|
||||
skills: [cloudflare, workers-best-practices, wrangler]
|
||||
- source: coldteadotai/pr-lens
|
||||
skills: [eli5, pr-lens]
|
||||
- source: Dammyjay93/interface-design
|
||||
skills: [interface-design]
|
||||
- source: deckardger/tanstack-agent-skills
|
||||
skills:
|
||||
- tanstack-integration-best-practices
|
||||
- tanstack-query-best-practices
|
||||
- tanstack-router-best-practices
|
||||
- tanstack-start-best-practices
|
||||
- source: Doist/todoist-cli
|
||||
skills: [todoist-cli]
|
||||
- source: finesssee/linear-cli
|
||||
skills: [linear-documents]
|
||||
- source: Forward-Future/loop-library
|
||||
skills: [loopy]
|
||||
- source: h4ckf0r0day/obscura
|
||||
skills: [obscura]
|
||||
- source: hardikpandya/stop-slop
|
||||
skills: [stop-slop]
|
||||
- source: jeffallan/claude-skills
|
||||
skills: [golang-pro]
|
||||
- source: leonardomso/rust-skills
|
||||
skills: [rust-skills]
|
||||
- source: Leonxlnx/taste-skill
|
||||
skills:
|
||||
- brandkit
|
||||
- design-taste-frontend
|
||||
- gpt-taste
|
||||
- high-end-visual-design
|
||||
- imagegen-frontend-web
|
||||
- minimalist-ui
|
||||
- redesign-existing-projects
|
||||
- source: mattpocock/skills
|
||||
skills:
|
||||
- codebase-design
|
||||
- diagnosing-bugs
|
||||
- domain-modeling
|
||||
- git-guardrails-claude-code
|
||||
- grill-me
|
||||
- grill-with-docs
|
||||
- grilling
|
||||
- handoff
|
||||
- implement
|
||||
- improve-codebase-architecture
|
||||
- loop-me
|
||||
- migrate-to-shoehorn
|
||||
- prototype
|
||||
- scaffold-exercises
|
||||
- setup-matt-pocock-skills
|
||||
- setup-pre-commit
|
||||
- tdd
|
||||
- teach
|
||||
- triage
|
||||
- writing-beats
|
||||
- writing-fragments
|
||||
- writing-shape
|
||||
# Removed upstream after v1.1.0 (c66bdee; writing-great-skills became
|
||||
# writing-for-agents).
|
||||
- source: https://github.com/mattpocock/skills/tree/v1.1.0
|
||||
skills:
|
||||
- design-an-interface
|
||||
- obsidian-vault
|
||||
- qa
|
||||
- request-refactor-plan
|
||||
- ubiquitous-language
|
||||
- writing-great-skills
|
||||
# Removed upstream in daa01d8; pinned to its parent.
|
||||
- source: https://github.com/mattpocock/skills/tree/153fc1b93de6584562765cdce299324e1ff9e661
|
||||
skills: [resolving-merge-conflicts]
|
||||
- source: https://mintlify.com/docs
|
||||
skills: [mintlify, mintlify-api, mintlify-docs]
|
||||
- source: nextlevelbuilder/ui-ux-pro-max-skill
|
||||
skills: [ui-ux-pro-max]
|
||||
- source: openai/skills
|
||||
skills: [linear]
|
||||
- source: petergyang/no-ai-slop
|
||||
skills: [no-ai-slop]
|
||||
- source: remix-run/remix
|
||||
skills: [remix, typescript-expert, write-tests]
|
||||
- source: remotion-dev/skills
|
||||
skills:
|
||||
- remotion-best-practices
|
||||
- remotion-captions
|
||||
- remotion-create
|
||||
- remotion-docs
|
||||
- remotion-interactivity
|
||||
- remotion-maps
|
||||
- remotion-markup
|
||||
- remotion-multimedia
|
||||
- remotion-render
|
||||
- remotion-saas
|
||||
- remotion-studio
|
||||
- remotion-upgrade
|
||||
- source: RoleModel/rolemodel-skills
|
||||
skills: [laws-of-ux]
|
||||
- source: schpet/linear-cli
|
||||
skills: [linear-cli]
|
||||
- source: shadcn-ui/ui
|
||||
skills: [shadcn]
|
||||
- source: sickn33/antigravity-awesome-skills
|
||||
skills: [bun-development]
|
||||
- source: tanstack-skills/tanstack-skills
|
||||
skills: [tanstack-form, tanstack-table]
|
||||
# Retired upstream in dd0d3f2f; pinned to its parent.
|
||||
- source: https://github.com/terrylica/cc-skills/tree/6d35f84728b05adec50cb74ee45b5517bb954fa8
|
||||
skills: [mise-tasks]
|
||||
- source: TheOrcDev/8bitcn-ui
|
||||
skills:
|
||||
- fumadocs-component-docs
|
||||
- fumadocs-mdx-structure
|
||||
- fumadocs-registry-integration
|
||||
- source: vercel-labs/agent-skills
|
||||
skills: [web-design-guidelines]
|
||||
- source: vercel-labs/json-render
|
||||
skills: [core, react, react-email]
|
||||
- source: vercel-labs/native
|
||||
skills: [native-sdk]
|
||||
- source: vercel-labs/skills
|
||||
skills: [find-skills]
|
||||
- source: whackur/solidity-agent-toolkit
|
||||
skills: [solidity-foundry-development]
|
||||
- source: wshobson/agents
|
||||
skills: [rust-async-patterns, solidity-security, uv-package-manager]
|
||||
- source: yeachan-heo/oh-my-claudecode
|
||||
skills: [deepinit]
|
||||
|
||||
# Claude Code only.
|
||||
- source: cloudflare/skills
|
||||
agents: [claude-code]
|
||||
skills:
|
||||
- agents-sdk
|
||||
- cloudflare-email-service
|
||||
- cloudflare-one
|
||||
- cloudflare-one-migrations
|
||||
- durable-objects
|
||||
- turnstile-spin
|
||||
- web-perf
|
||||
# Replaced upstream by sandbox-stable / sandbox-next in f96bff7.
|
||||
- source: https://github.com/cloudflare/skills/tree/30553f89ae1ef1e3c2917cd09d72dac992bb4e9a
|
||||
agents: [claude-code]
|
||||
skills: [sandbox-sdk]
|
||||
- source: earendil-works/absurd
|
||||
agents: [claude-code]
|
||||
skills: [absurd]
|
||||
# Subdirectory URL: the bare repo's root SKILL.md would install the whole
|
||||
# repository as the skill.
|
||||
- source: https://github.com/AvivK5498/Claude-Code-Beads-Orchestration/tree/main/skills/create-beads-orchestration
|
||||
agents: [claude-code]
|
||||
skills: [create-beads-orchestration]
|
||||
@@ -0,0 +1,25 @@
|
||||
# External content — cloned/downloaded by chezmoi, not stored in this repo.
|
||||
|
||||
# Neovim config lives in its own repo. No refreshPeriod: chezmoi clones it
|
||||
# when ~/.config/nvim is missing (fresh machine) and otherwise never pulls,
|
||||
# so the local checkout always wins over the remote.
|
||||
[".config/nvim"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/nvim.git"
|
||||
[".config/nvim".pull]
|
||||
args = ["--ff-only"]
|
||||
|
||||
# bat syntax definition — upstream git repo, cloned when missing.
|
||||
[".config/bat/syntaxes/sublime-purescript-syntax"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/tellnobody1/sublime-purescript-syntax.git"
|
||||
[".config/bat/syntaxes/sublime-purescript-syntax".pull]
|
||||
args = ["--ff-only"]
|
||||
|
||||
# tmux plugin manager — tmux.conf runs it from this path. tpm installs the
|
||||
# other plugins next to it (prefix + I); those stay unmanaged.
|
||||
[".config/tmux/plugins/tpm"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/tmux-plugins/tpm.git"
|
||||
[".config/tmux/plugins/tpm".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,8 @@
|
||||
# agent-root: lets coding agents run one command as root through a pkexec
|
||||
# dialog with a notify-send reason. Single upstream script; desktop/laptop
|
||||
# roles only (needs the session's polkit agent), gated in .chezmoiignore.tmpl.
|
||||
[".local/bin/agent-root"]
|
||||
type = "file"
|
||||
url = "https://raw.githubusercontent.com/jankeesvw/agent-root/main/agent-root"
|
||||
executable = true
|
||||
refreshPeriod = "168h"
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/ghostty"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/ghostty.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/ghostty".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/herdr"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/herdr.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/herdr".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/kitty"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/kitty.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/kitty".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/omarchy"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/omarchy.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/omarchy".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".omp"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/omp.git"
|
||||
refreshPeriod = "168h"
|
||||
[".omp".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/television"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/television.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/television".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/tmux-palette"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/tmux-palette.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/tmux-palette".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/tmux"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/tmux.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/tmux".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,6 @@
|
||||
[".config/yazi"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/yazi.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/yazi".pull]
|
||||
args = ["--ff-only"]
|
||||
@@ -0,0 +1,48 @@
|
||||
# Repo docs — never applied to $HOME
|
||||
README.md
|
||||
CLAUDE.md
|
||||
AGENTS.md
|
||||
docs
|
||||
|
||||
# Compositor hook shipped by the shared fish submodule; never applied here
|
||||
.config/fish/auto-Niri.fish
|
||||
|
||||
# Runtime/plugin state living inside managed trees — not managed
|
||||
.config/lazygit/.omc/**
|
||||
.config/tmux/plugins/**
|
||||
!.config/tmux/plugins/tpm
|
||||
.config/fish/fish_variables
|
||||
|
||||
# Plaintext tokens — local-only, never in git. Rotate anything ever committed.
|
||||
.config/fish/conf.d/secrets.fish
|
||||
.config/nvim/lazy-lock.json
|
||||
.config/nvim/.git
|
||||
.config/nvim/.git/**
|
||||
.config/nvim/.omc/**
|
||||
.config/nvim/.crush/**
|
||||
.config/nvim/.understand-anything/**
|
||||
|
||||
# mise tool versions — kept local per-machine, not managed
|
||||
.config/mise
|
||||
.config/mise/**
|
||||
|
||||
{{ if or (ne .chezmoi.os "linux") (and (ne .role "desktop") (ne .role "laptop")) }}
|
||||
# Arch desktop layer — linux desktop/laptop roles only
|
||||
.config/hypr
|
||||
.config/hypr/**
|
||||
.config/waybar
|
||||
.config/waybar/**
|
||||
.config/uwsm
|
||||
.config/uwsm/**
|
||||
.local/bin/agent-root
|
||||
.config/fontconfig
|
||||
.config/fontconfig/**
|
||||
.config/mimeapps.list
|
||||
.config/xdg-terminals.list
|
||||
.config/systemd
|
||||
.config/systemd/**
|
||||
.local/bin/kitty-day-save
|
||||
.local/bin/cp-appid
|
||||
.local/bin/projects-sync
|
||||
{{ end }}
|
||||
|
||||
@@ -0,0 +1,23 @@
|
||||
{{ if eq .chezmoi.os "linux" -}}
|
||||
#!/bin/sh
|
||||
# Enable session-critical user services. Personal automation units
|
||||
# (brain-lens, omp-loop, rclone, hermes, voxtype) ship as files only —
|
||||
# enable manually per machine.
|
||||
set -eu
|
||||
|
||||
# Pre-shutdown save of kitty's daily session (dot_config/systemd/user, only on
|
||||
# linux desktop/laptop roles; see .chezmoiignore.tmpl).
|
||||
if [ -f "$HOME/.config/systemd/user/kitty-day-save.service" ] && command -v systemctl >/dev/null 2>&1; then
|
||||
systemctl --user daemon-reload || true
|
||||
systemctl --user enable --now kitty-day-save.service || true
|
||||
fi
|
||||
|
||||
# Symlink ~/Code repos into ~/Projects every 5 min (same role gate).
|
||||
if [ -f "$HOME/.config/systemd/user/projects-sync.timer" ] && command -v systemctl >/dev/null 2>&1; then
|
||||
systemctl --user daemon-reload || true
|
||||
systemctl --user enable --now projects-sync.timer || true
|
||||
fi
|
||||
{{ else -}}
|
||||
#!/bin/sh
|
||||
exit 0
|
||||
{{ end -}}
|
||||
@@ -0,0 +1,68 @@
|
||||
#!/bin/sh
|
||||
# Tools that come from their own installers rather than pacman:
|
||||
# rustup (cargo) and the packages.shared.cargo crates, the
|
||||
# packages.shared.mise tools (omp, opencode, …), and strata on Linux desktop
|
||||
# roles. Runs before 20-gh-extensions, whose fish session sources
|
||||
# ~/.cargo/env.fish (conf.d/rustup.fish) and activates mise.
|
||||
# cargo hash: {{ .packages.shared.cargo | toJson | sha256sum }}
|
||||
# mise hash: {{ .packages.shared.mise | toJson | sha256sum }}
|
||||
set -eu
|
||||
|
||||
# Where rustup puts cargo; chezmoi's environment can predate the shell config
|
||||
# that adds it.
|
||||
PATH="$HOME/.cargo/bin:$PATH"
|
||||
export PATH
|
||||
|
||||
# rustup: -y answers its prompt (no tty under chezmoi); --no-modify-path keeps
|
||||
# it out of the shell rc files, which are symlinks into this repo and already
|
||||
# source ~/.cargo/env (bash, zsh, fish conf.d/rustup.fish).
|
||||
if ! command -v cargo >/dev/null 2>&1; then
|
||||
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --no-modify-path
|
||||
fi
|
||||
|
||||
installed=$(cargo install --list | awk '/^[^ ]/{print $1}')
|
||||
{{ range .packages.shared.cargo -}}
|
||||
echo "$installed" | grep -qx {{ . | quote }} || cargo install --locked {{ . | quote }}
|
||||
{{ end }}
|
||||
|
||||
# Global mise tools. Only tools absent from the global config are added, so a
|
||||
# local pin (node = "22") is never rewritten to latest; `mise install` then
|
||||
# fetches any configured version that is not installed yet.
|
||||
if command -v mise >/dev/null 2>&1; then
|
||||
global=$(mise ls --global --json)
|
||||
missing=''
|
||||
for tool in{{ range .packages.shared.mise }} {{ . | quote }}{{ end }}; do
|
||||
echo "$global" | jq -e --arg t "$tool" 'has($t)' >/dev/null || missing="$missing $tool"
|
||||
done
|
||||
# shellcheck disable=SC2086 # one word per tool
|
||||
[ -z "$missing" ] || mise use -g $missing
|
||||
mise install{{ range .packages.shared.mise }} {{ . | quote }}{{ end }}
|
||||
# omp's own installer (omp.sh/install) put a binary in ~/.local/bin, which
|
||||
# precedes mise's shims on PATH; drop it once mise provides omp.
|
||||
if [ -f "$HOME/.local/bin/omp" ] && [ ! -L "$HOME/.local/bin/omp" ] && mise which omp >/dev/null 2>&1; then
|
||||
rm -f "$HOME/.local/bin/omp"
|
||||
fi
|
||||
else
|
||||
echo "warning: mise not installed — skipping mise tools" >&2
|
||||
fi
|
||||
{{- if and (eq .chezmoi.os "linux") (or (eq .role "desktop") (eq .role "laptop")) }}
|
||||
|
||||
# strata (GUI file manager): binary in ~/.local/bin, desktop entry, and the
|
||||
# FileManager1 D-Bus service for "Open file location". The inode/directory
|
||||
# default is dot_config/mimeapps.list; --with-folder-association is not used
|
||||
# because xdg-mime would replace that symlink with a plain file. Runtime deps
|
||||
# are in packages.arch.desktop.pacman.
|
||||
if [ ! -e "$HOME/.local/bin/strata" ]; then
|
||||
curl -fsSL https://raw.githubusercontent.com/lgse/strata/main/install.sh | bash -s -- --with-desktop-entry --with-file-manager
|
||||
fi
|
||||
|
||||
# System file chooser: strata serves org.freedesktop.impl.portal.FileChooser
|
||||
# for portal-aware apps (browsers, GTK). --install-portal writes the .portal
|
||||
# and D-Bus service under ~/.local/share, prepends "strata;" to the
|
||||
# FileChooser line of ~/.config/xdg-desktop-portal/<desktop>-portals.conf
|
||||
# (copied from the system one if absent; strata owns that file, not chezmoi,
|
||||
# so `strata --uninstall-portal` can restore it), and restarts the portal.
|
||||
if [ -e "$HOME/.local/bin/strata" ] && [ ! -e "${XDG_DATA_HOME:-$HOME/.local/share}/xdg-desktop-portal/portals/strata.portal" ]; then
|
||||
"$HOME/.local/bin/strata" --install-portal
|
||||
fi
|
||||
{{- end }}
|
||||
@@ -0,0 +1,25 @@
|
||||
#!/usr/bin/env fish
|
||||
# Install gh extensions declared in .chezmoidata/packages.yaml.
|
||||
# A fish script, so fish's config (~/.config/fish, applied before after-scripts
|
||||
# run) is sourced first: PATH (mise, ~/.local/bin, ~/.cargo/bin) and
|
||||
# GITHUB_TOKEN (conf.d/10-env.fish) match a fish session.
|
||||
# gh_extensions hash: {{ .packages.shared.gh_extensions | toJson | sha256sum }}
|
||||
|
||||
if not command -q gh
|
||||
echo "warning: gh not installed — skipping extensions" >&2
|
||||
exit 0
|
||||
end
|
||||
if not gh auth status >/dev/null 2>&1
|
||||
echo "warning: gh not authenticated — run 'gh auth login', then 'chezmoi apply' again" >&2
|
||||
exit 0
|
||||
end
|
||||
|
||||
set -l installed (gh extension list 2>/dev/null | string split -f2 \t)
|
||||
set -l failed
|
||||
for ext in{{ range .packages.shared.gh_extensions }} {{ . | quote }}{{ end }}
|
||||
contains -- $ext $installed; or gh extension install $ext; or set -a failed $ext
|
||||
end
|
||||
if set -q failed[1]
|
||||
echo "error: gh extension install failed for: $failed" >&2
|
||||
exit 1
|
||||
end
|
||||
+70
@@ -0,0 +1,70 @@
|
||||
#!/bin/sh
|
||||
# Sync agent skills with .chezmoidata/skills.yaml through the Skills CLI:
|
||||
# install every declared skill (one `skills add` per source), then remove
|
||||
# skills a previous run installed that are no longer declared.
|
||||
# skills hash: {{ .skills | toJson | sha256sum }}
|
||||
set -u
|
||||
|
||||
command -v npx >/dev/null 2>&1 || { echo "warning: npx not found — skipping skills sync" >&2; exit 0; }
|
||||
|
||||
src={{ .chezmoi.sourceDir | quote }}
|
||||
state=${XDG_STATE_HOME:-$HOME/.local/state}/chezmoi/skills.txt
|
||||
declared='{{ range .skills.sources }}{{ range .skills }} {{ . }}{{ end }}{{ end }} '
|
||||
|
||||
skills() { npx -y {{ .skills.cli | quote }} "$@" </dev/null; }
|
||||
|
||||
# Leftovers from when skills were vendored in this repo (chezmoi symlink mode):
|
||||
# skill dirs whose files are symlinks into the source tree, and the old lock
|
||||
# symlink. Drop them so the CLI writes real copies instead of writing through
|
||||
# the links into the repo.
|
||||
for dir in "$HOME/.agents/skills"/* "$HOME/.claude/skills"/*; do
|
||||
[ -d "$dir" ] && [ ! -L "$dir" ] || continue
|
||||
if [ -n "$(find "$dir" -type l -lname "$src/*" -print -quit)" ]; then
|
||||
rm -rf "$dir"
|
||||
fi
|
||||
done
|
||||
lock=$HOME/.agents/.skill-lock.json
|
||||
if [ -L "$lock" ]; then
|
||||
case $(readlink "$lock") in "$src"/*) rm -f "$lock" ;; esac
|
||||
fi
|
||||
|
||||
# Remove what the last sync installed but skills.yaml no longer lists.
|
||||
stale=''
|
||||
if [ -f "$state" ]; then
|
||||
while IFS= read -r name; do
|
||||
case $declared in *" $name "*) ;; *) stale="$stale $name" ;; esac
|
||||
done <"$state"
|
||||
fi
|
||||
if [ -n "$stale" ]; then
|
||||
echo "skills: removing$stale"
|
||||
# shellcheck disable=SC2086 # one word per skill name
|
||||
skills remove -g -y $stale || echo "warning: skills remove failed:$stale" >&2
|
||||
fi
|
||||
|
||||
failed=''
|
||||
log=$(mktemp)
|
||||
trap 'rm -f "$log"' EXIT
|
||||
add() {
|
||||
source=$1 agents=$2
|
||||
shift 2
|
||||
echo "skills: $source → $*"
|
||||
# shellcheck disable=SC2086 # agents is a space-separated list
|
||||
if ! skills add "$source" -g -y -a $agents --skill "$@" >"$log" 2>&1; then
|
||||
failed="$failed $source"
|
||||
tail -n 8 "$log" >&2
|
||||
fi
|
||||
}
|
||||
{{ range .skills.sources -}}
|
||||
{{ $agents := $.skills.agents -}}
|
||||
{{ if hasKey . "agents" }}{{ $agents = .agents }}{{ end -}}
|
||||
add {{ .source | quote }} {{ $agents | join " " | quote }}{{ range .skills }} {{ . | quote }}{{ end }}
|
||||
{{ end -}}
|
||||
|
||||
mkdir -p "$(dirname "$state")"
|
||||
printf '%s\n' $declared >"$state"
|
||||
|
||||
if [ -n "$failed" ]; then
|
||||
# Non-zero keeps the old hash, so the next `chezmoi apply` retries.
|
||||
echo "error: skills add failed for:$failed" >&2
|
||||
exit 1
|
||||
fi
|
||||
@@ -0,0 +1,9 @@
|
||||
#!/bin/sh
|
||||
# Post-apply housekeeping. Re-runs when this file's rendered content changes.
|
||||
set -eu
|
||||
|
||||
if command -v bat >/dev/null 2>&1; then bat cache --build >/dev/null || true; fi
|
||||
|
||||
{{ if eq .chezmoi.os "linux" -}}
|
||||
if command -v fc-cache >/dev/null 2>&1; then fc-cache -f >/dev/null || true; fi
|
||||
{{ end -}}
|
||||
@@ -0,0 +1,59 @@
|
||||
#!/bin/sh
|
||||
# Install packages declared in .chezmoidata/packages.yaml.
|
||||
# packages.yaml hash: {{ include ".chezmoidata/packages.yaml" | sha256sum }}
|
||||
set -eu
|
||||
|
||||
{{ if eq .chezmoi.os "linux" -}}
|
||||
if [ "$(id -u)" -eq 0 ]; then PACMAN="pacman"; else PACMAN="sudo pacman"; fi
|
||||
|
||||
# Install only what no installed package already provides (`pacman -T`), so a
|
||||
# machine with mise-bin or yazi-git is not asked to replace them with mise/yazi.
|
||||
install_missing() {
|
||||
missing=$(pacman -T "$@" || true)
|
||||
# shellcheck disable=SC2086 # word splitting intended
|
||||
[ -z "$missing" ] || $PACMAN -S --needed --noconfirm $missing
|
||||
}
|
||||
|
||||
install_missing {{ range .packages.arch.pacman }}{{ . }} {{ end }}
|
||||
|
||||
{{ if or (eq .role "desktop") (eq .role "laptop") -}}
|
||||
install_missing {{ range .packages.arch.desktop.pacman }}{{ . }} {{ end }}
|
||||
|
||||
# [omarchy] repo packages — only where pacman.conf has that repo
|
||||
if pacman-conf -l | grep -qx omarchy; then
|
||||
install_missing {{ range .packages.arch.desktop.omarchy }}{{ . }} {{ end }}
|
||||
fi
|
||||
|
||||
aur_pkgs="{{ range .packages.arch.desktop.aur }}{{ . }} {{ end }}{{ range .packages.arch.aur }}{{ . }} {{ end }}"
|
||||
{{ else -}}
|
||||
aur_pkgs="{{ range .packages.arch.aur }}{{ . }} {{ end }}"
|
||||
{{ end -}}
|
||||
# AUR names no installed package provides yet; ones already installed from a
|
||||
# sync repo ([omarchy], extra) are neither rebuilt nor replaced.
|
||||
# shellcheck disable=SC2086
|
||||
aur_missing=$(pacman -T $aur_pkgs || true)
|
||||
if [ -n "$aur_missing" ]; then
|
||||
# No AUR helper yet: take yay from a sync repo that ships it, else build
|
||||
# yay-bin from the AUR (makepkg refuses root).
|
||||
if ! command -v yay >/dev/null 2>&1 && ! command -v paru >/dev/null 2>&1; then
|
||||
if pacman -Si yay >/dev/null 2>&1; then
|
||||
$PACMAN -S --needed --noconfirm yay
|
||||
elif [ "$(id -u)" -ne 0 ]; then
|
||||
install_missing git base-devel
|
||||
yay_build=$(mktemp -d)
|
||||
git clone --depth 1 https://aur.archlinux.org/yay-bin.git "$yay_build"
|
||||
(cd "$yay_build" && makepkg -si --noconfirm)
|
||||
rm -rf "$yay_build"
|
||||
fi
|
||||
fi
|
||||
if command -v yay >/dev/null 2>&1; then AUR="yay"
|
||||
elif command -v paru >/dev/null 2>&1; then AUR="paru"
|
||||
else AUR=""; fi
|
||||
if [ -n "$AUR" ]; then
|
||||
# shellcheck disable=SC2086
|
||||
$AUR -S --needed --noconfirm $aur_missing
|
||||
else
|
||||
echo "warning: no yay/paru and none could be bootstrapped — skipping AUR packages:" $aur_missing >&2
|
||||
fi
|
||||
fi
|
||||
{{ end -}}
|
||||
@@ -0,0 +1,26 @@
|
||||
{
|
||||
"hooks": {
|
||||
"PreCompact": [
|
||||
{
|
||||
"hooks": [
|
||||
{
|
||||
"command": "bd prime",
|
||||
"type": "command"
|
||||
}
|
||||
],
|
||||
"matcher": ""
|
||||
}
|
||||
],
|
||||
"SessionStart": [
|
||||
{
|
||||
"hooks": [
|
||||
{
|
||||
"command": "bd prime",
|
||||
"type": "command"
|
||||
}
|
||||
],
|
||||
"matcher": ""
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
/dot_config/lazygit/dot_omc
|
||||
|
||||
# Beads / Dolt files (added by bd init)
|
||||
.dolt/
|
||||
*.db
|
||||
.beads-credential-key
|
||||
|
||||
__pycache__/
|
||||
@@ -0,0 +1,6 @@
|
||||
[submodule "dot_config/fish"]
|
||||
path = dot_config/fish
|
||||
url = https://github.com/prdlk/fish.git
|
||||
[submodule "dot_config/hypr"]
|
||||
path = dot_config/hypr
|
||||
url = https://github.com/prdlk/hypr.git
|
||||
@@ -0,0 +1,89 @@
|
||||
# AGENTS.md
|
||||
|
||||
chezmoi source for `$HOME` on [Omarchy](https://omarchy.org) (Arch + Hyprland). Remote: `https://prad.codes/env/omarchy` (`git@prad.codes:env/omarchy.git`), branch `main`.
|
||||
|
||||
Location: `~/Code/prad.codes/env/omarchy`. chezmoi uses it as its source either via `chezmoi init --source ~/Code/prad.codes/env/omarchy` or by cloning it into `~/.local/share/chezmoi` — the same checkout model either way: one working tree that chezmoi reads and that you commit from.
|
||||
|
||||
`mode = "symlink"`: plain files in `$HOME` are symlinks into this repo, so editing `~/.config/foo/bar` edits `dot_config/foo/bar` directly. Templates (`*.tmpl`), `private_`, `executable_` targets are rendered copies — edit the source, then `chezmoi apply`.
|
||||
|
||||
Config lives in three places. Check which one before editing.
|
||||
|
||||
## 1. Local (this repo)
|
||||
|
||||
`dot_*` trees committed here. Edit in place, commit here. Docs for each tool are in `docs/`; update the matching page (`docs/**/*.md`) when behavior changes.
|
||||
|
||||
- Never edit a rendered copy of a `.tmpl`; edit the `.tmpl` and run `chezmoi apply <path>`.
|
||||
- Scripts: `.chezmoiscripts/run_*`. Data: `.chezmoidata/*.yaml` (packages, aliases, skills).
|
||||
- Ignore rules: `.chezmoiignore.tmpl`. Repo docs (`AGENTS.md`, `README.md`, `docs/`) are listed there so they never land in `$HOME`.
|
||||
- Roles: `desktop` (default), `laptop`, `server`. Desktop/laptop get the Omarchy layer (hypr, waybar, uwsm, fontconfig, mimeapps, systemd user units, `omarchy-*` scripts); `server` gets the universal toolset only.
|
||||
|
||||
## 2. Submodules (`.gitmodules`)
|
||||
|
||||
| Path | Repo |
|
||||
| --- | --- |
|
||||
| `dot_config/fish` | prdlk/fish |
|
||||
| `dot_config/hypr` | prdlk/hypr |
|
||||
|
||||
Still applied by chezmoi like local files, but the git history is separate:
|
||||
|
||||
1. `cd dot_config/<app>`, edit, commit, push there.
|
||||
2. `cd` back to the root and commit the updated submodule pointer.
|
||||
|
||||
Fresh clone: `git submodule update --init` (chezmoi does this on `init`).
|
||||
|
||||
## 3. Externals (`.chezmoiexternals/*.toml`, `.chezmoiexternal.toml`)
|
||||
|
||||
`git-repo` externals. chezmoi clones them into `$HOME` when missing and fast-forwards (`--ff-only`) at most every `refreshPeriod`. The source tree holds nothing for these — only the `.toml`.
|
||||
|
||||
| Target | Repo | Declared in |
|
||||
| --- | --- | --- |
|
||||
| `~/.config/kitty` | prdlk/kitty | `.chezmoiexternals/kitty.toml` |
|
||||
| `~/.config/ghostty` | prdlk/ghostty | `.chezmoiexternals/ghostty.toml` |
|
||||
| `~/.config/tmux` | prdlk/tmux | `.chezmoiexternals/tmux.toml` |
|
||||
| `~/.config/tmux-palette` | prdlk/tmux-palette | `.chezmoiexternals/tmux-palette.toml` |
|
||||
| `~/.config/television` | prdlk/television | `.chezmoiexternals/television.toml` |
|
||||
| `~/.config/yazi` | prdlk/yazi | `.chezmoiexternals/yazi.toml` |
|
||||
| `~/.config/herdr` | prdlk/herdr | `.chezmoiexternals/herdr.toml` (`plugins/github/` gitignored, runtime plugin checkouts) |
|
||||
| `~/.config/omarchy` | prdlk/omarchy | `.chezmoiexternals/omarchy.toml` (git themes/plugins live in its `extras.txt`, not this repo) |
|
||||
| `~/.omp` | prdlk/omp | `.chezmoiexternals/omp.toml` |
|
||||
| `~/.local/bin/agent-root` | jankeesvw/agent-root (one `file` external, not a checkout; no edits, upstream script) | `.chezmoiexternals/agent-root.toml` (desktop/laptop roles only) |
|
||||
| `~/.config/nvim` | prdlk/nvim | `.chezmoiexternal.toml` (no refresh; local checkout wins) |
|
||||
| `~/.config/tmux/plugins/tpm` | tmux-plugins/tpm | `.chezmoiexternal.toml` |
|
||||
| `~/.config/bat/syntaxes/sublime-purescript-syntax` | tellnobody1/… | `.chezmoiexternal.toml` |
|
||||
|
||||
These stay on their GitHub URLs; they are separate repos, not part of this one.
|
||||
|
||||
Editing: `cd ~/.config/<app>` (the live checkout), edit, commit, push there. Nothing to commit in this repo. Do not `chezmoi add` these paths.
|
||||
|
||||
Local working copies under `~/Code/github.com/prdlk/<app>` are ordinary clones of the same repos; `~/.config/<app>` is the one chezmoi manages and the one tools read.
|
||||
|
||||
Pulling a remote change before the refresh window: `chezmoi apply --refresh-externals ~/.config/<app>` (or `git pull` in the checkout). `--ff-only` means a diverged local checkout silently stays put — commit or stash first.
|
||||
|
||||
## Moving a config out to an external
|
||||
|
||||
1. Create the repo, copy the files (strip chezmoi prefixes; a `symlink_x` file becomes a real symlink), commit, push.
|
||||
2. Add `.chezmoiexternals/<app>.toml` copying `tmux.toml`.
|
||||
3. `git rm -r dot_config/<app>`; drop any `<app>`-specific lines from `.chezmoiignore.tmpl` / `.gitignore`.
|
||||
4. `mv ~/.config/<app> /tmp/bak && chezmoi apply --force ~/.config/<app>`; diff against the repo, then delete the backup.
|
||||
5. Update `docs/` (the tool's page, `docs/terminal/README.md` or sibling index, `docs/chezmoi/externals-and-ignore.md`) and any alias pointing at the old source path (`dot_config/fish/conf.d/20-aliases.fish`, `.chezmoidata/aliases.yaml`).
|
||||
|
||||
## Packages: every referenced tool must be declared
|
||||
|
||||
`.chezmoidata/packages.yaml` is the install manifest; the goal is `chezmoi init --apply` on a fresh Omarchy machine yields a working setup. When a config, script, tmux-palette item, television cable `requirements`, or Hyprland binding starts calling a new binary, declare its package in the same change:
|
||||
|
||||
| Key | Installed by | When |
|
||||
| --- | --- | --- |
|
||||
| `arch.pacman` / `arch.aur` | `10-packages` (pacman / `yay` or `paru`; yay bootstrapped if neither exists) | every role |
|
||||
| `arch.desktop.pacman` / `.aur` | same | roles `desktop`, `laptop` |
|
||||
| `arch.desktop.omarchy` | pacman, only if `pacman-conf -l` lists `omarchy` | Omarchy machines |
|
||||
| `shared.cargo` | `15-tools`, after installing rustup if `cargo` is missing | every role |
|
||||
| `shared.mise` | `15-tools`: `mise use -g` for tools absent from the global config | every role |
|
||||
| `shared.gh_extensions` | `20-gh-extensions` (fish script, so fish config is sourced) | every role |
|
||||
|
||||
Find the package with `pacman -Qo "$(command -v <bin>)"`; `pacman -Qm` lists AUR/foreign packages, `pacman -Si <pkg>` shows the repo (`extra` vs `omarchy`). Verify names before committing: `pacman -Si` for repo packages, `https://aur.archlinux.org/rpc/v5/info?arg[]=<pkg>` for AUR, `mise registry <tool>` for mise (no registry entry: use a backend spec such as `github:owner/repo`). Hyprland/Waybar/`omarchy-*` come with Omarchy and are not declared. CLIs that mise can install (omp, opencode, …) go in `shared.mise`, not a curl installer; `15-tools` curl-installs only rustup and strata. `shared.mise` mirrors the global `~/.config/mise/config.toml`: a tool added there with `mise use -g` belongs in the list too.
|
||||
|
||||
## Verify
|
||||
|
||||
- `chezmoi diff` empty after apply.
|
||||
- `chezmoi managed | grep <app>` shows the target.
|
||||
- Externals: `git -C ~/.config/<app> status -sb` clean and tracking `origin/main`.
|
||||
@@ -0,0 +1,73 @@
|
||||
# omarchy
|
||||
|
||||
chezmoi source for an [Omarchy](https://omarchy.org) machine (Arch + Hyprland), hosted at <https://prad.codes/env/omarchy>.
|
||||
|
||||
Install Omarchy first, then on that machine:
|
||||
|
||||
```sh
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply https://prad.codes/env/omarchy.git
|
||||
# or over SSH:
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply git@prad.codes:env/omarchy.git
|
||||
```
|
||||
|
||||
chezmoi clones the `dot_config/fish` and `dot_config/hypr` submodules during `init`.
|
||||
|
||||
First apply prompts once for name, email, and machine role
|
||||
(`desktop` | `laptop` | `server`, default `desktop`). `desktop` and `laptop` get
|
||||
the Omarchy layer (Hyprland config, Waybar, uwsm env, fontconfig, mimeapps,
|
||||
systemd user units, `omarchy-*` scripts); `server` gets the universal toolset only.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- **Omarchy** installed (provides Hyprland, Waybar, the `omarchy-*` commands and `yay`).
|
||||
`sudo` for pacman; if no `yay`/`paru` exists the install script bootstraps `yay`.
|
||||
- **Secrets**: `age`-encrypted files need the key at
|
||||
`~/.config/chezmoi/key.txt`. Copy it there **before** `chezmoi apply`
|
||||
(distributed manually, never committed):
|
||||
|
||||
```sh
|
||||
mkdir -p ~/.config/chezmoi
|
||||
scp <existing-machine>:.config/chezmoi/key.txt ~/.config/chezmoi/key.txt
|
||||
chmod 600 ~/.config/chezmoi/key.txt
|
||||
```
|
||||
|
||||
## What's managed
|
||||
|
||||
Universal: fish, bash + zsh (starship prompt, shared aliases), nvim, tmux,
|
||||
kitty, ghostty, yazi, lazygit, lazydocker, gh (+ extensions), topgrade, git,
|
||||
ssh config, Claude Code and agent skills.
|
||||
Packages are declared in `.chezmoidata/packages.yaml` and installed by
|
||||
`.chezmoiscripts` (idempotent, re-run when the manifest changes).
|
||||
|
||||
Aliases are defined once in `.chezmoidata/aliases.yaml` and rendered
|
||||
into fish (`fish/conf.d/20-aliases.fish`) and bash/zsh
|
||||
(`~/.config/shell/aliases.sh`, sourced by `.bashrc`/`.zshrc`).
|
||||
|
||||
Shell utilities live as standalone sh/bash executables in `~/.local/bin`
|
||||
so all shells share one implementation; helpers that must mutate shell state
|
||||
(`cd`-style) are per-shell functions in `fish/functions/`, `bash/functions/`,
|
||||
and `zsh/functions/`.
|
||||
|
||||
Agent skills are not vendored: `.chezmoidata/skills.yaml` lists every
|
||||
skill and its upstream source, and
|
||||
`.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` installs them with the
|
||||
Skills CLI whenever that file changes.
|
||||
|
||||
Omarchy layer (roles `desktop`/`laptop`): `dot_config/hypr` (submodule),
|
||||
`dot_config/waybar`, `dot_config/uwsm`, fontconfig, mimeapps,
|
||||
`xdg-terminals.list`, systemd user units, and the `omarchy-*` scripts in
|
||||
`dot_local/bin`.
|
||||
|
||||
## Submodules and externals
|
||||
|
||||
- Submodules: `dot_config/fish` (prdlk/fish), `dot_config/hypr` (prdlk/hypr).
|
||||
- Externals (`.chezmoiexternals/`): kitty, ghostty, tmux, tmux-palette,
|
||||
television, yazi, herdr, omp, omarchy (`~/.config/omarchy`), agent-root,
|
||||
plus nvim, tpm and a bat syntax in `.chezmoiexternal.toml`.
|
||||
|
||||
`gh` needs `gh auth login` once per machine; the extension install script
|
||||
skips gracefully until then and re-runs on the next apply.
|
||||
|
||||
## Docs
|
||||
|
||||
See [`docs/README.md`](docs/README.md). Agent rules for working in this repo: [`AGENTS.md`](AGENTS.md).
|
||||
@@ -0,0 +1,71 @@
|
||||
# dots (omarchy)
|
||||
|
||||
prdlk's dotfiles for [Omarchy](https://omarchy.org) (Arch Linux + Hyprland), managed with chezmoi. One command installs chezmoi and applies the whole setup.
|
||||
|
||||
```sh
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply https://prad.codes/env/omarchy.git
|
||||
```
|
||||
|
||||
That command installs chezmoi, clones [env/omarchy](https://prad.codes/env/omarchy) together with its submodules, asks three questions (name, email, machine role), installs packages, and applies every config. See [Installation](installation.md) for prerequisites, the age key step, and the options.
|
||||
|
||||
## Table of contents
|
||||
|
||||
- [Installation](installation.md): Omarchy first, then the one-liner, the age key, roles, and updating.
|
||||
- [How it works](chezmoi/README.md): chezmoi layout, machine roles, symlink mode, age encryption, package manifests, apply scripts, and externals.
|
||||
- [Overview](chezmoi/README.md)
|
||||
- [Configuration](chezmoi/config.md)
|
||||
- [Data files](chezmoi/data.md)
|
||||
- [Scripts](chezmoi/scripts.md)
|
||||
- [Externals and ignore rules](chezmoi/externals-and-ignore.md)
|
||||
- [Shell](shell/README.md): fish, bash, and zsh with shared aliases, starship, atuin, and the `~/.local/bin` scripts.
|
||||
- [Overview](shell/README.md)
|
||||
- [fish](shell/fish.md)
|
||||
- [bash and zsh](shell/bash-zsh.md)
|
||||
- [Aliases](shell/aliases.md)
|
||||
- [Scripts](shell/scripts.md)
|
||||
- [Starship](shell/starship.md)
|
||||
- [Atuin](shell/atuin.md)
|
||||
- [Terminal](terminal/README.md): kitty, ghostty, tmux, and herdr.
|
||||
- [Overview](terminal/README.md)
|
||||
- [kitty](terminal/kitty.md)
|
||||
- [Ghostty](terminal/ghostty.md)
|
||||
- [tmux](terminal/tmux.md)
|
||||
- [herdr](terminal/herdr.md)
|
||||
- [Tools](tools/README.md): git, gh and gh-dash, neovim, yazi, lazygit, lazydocker, bat, topgrade, hunk, and more.
|
||||
- [Overview](tools/README.md)
|
||||
- [Git](tools/git.md)
|
||||
- [GitHub CLI](tools/github-cli.md)
|
||||
- [Neovim](tools/neovim.md)
|
||||
- [Yazi](tools/yazi.md)
|
||||
- [lazygit](tools/lazygit.md)
|
||||
- [lazydocker](tools/lazydocker.md)
|
||||
- [bat](tools/bat.md)
|
||||
- [television](tools/television.md)
|
||||
- [Topgrade](tools/topgrade.md)
|
||||
- [hunk](tools/hunk.md)
|
||||
- [drydock](tools/drydock.md)
|
||||
- [LeetCode](tools/leetcode.md)
|
||||
- [Desktop](desktop/README.md): Omarchy, Hyprland, Waybar, fonts, and default apps.
|
||||
- [Overview](desktop/README.md)
|
||||
- [Hyprland](desktop/hyprland.md)
|
||||
- [Waybar](desktop/waybar.md)
|
||||
- [Fonts and apps](desktop/fonts-and-apps.md)
|
||||
- [AI agents](ai/README.md): Claude Code, omp, and the shared agent skill library.
|
||||
- [Overview](ai/README.md)
|
||||
- [Skills](ai/skills.md)
|
||||
|
||||
## Machine roles
|
||||
|
||||
The first apply asks for a role. It controls which parts of the repo land on the machine.
|
||||
|
||||
| Role | Platform | Gets |
|
||||
| --- | --- | --- |
|
||||
| `desktop` | Omarchy (Arch Linux) | Everything: universal toolset plus the Linux desktop layer |
|
||||
| `laptop` | Omarchy (Arch Linux) | Same as `desktop` |
|
||||
| `server` | Any Linux | Universal toolset only |
|
||||
|
||||
The default is `desktop`. See [Configuration](chezmoi/config.md) and [Ignore rules](chezmoi/externals-and-ignore.md).
|
||||
|
||||
## Theme
|
||||
|
||||
The terminal and agent palette is **CherryBlossom** (background `#222120`, foreground `#dcc1b7`, accent `#cf716f`). Ghostty selects its `cherry-blossom` theme, tmux colors its tab bar, popups, and command palette with it, atuin selects `cherry-blossom`, television selects `cherry-blossom-transparent` (no background, so the terminal's shows through), lazygit and lazydocker use its border and selection colors, and omp selects its `cherry-blossom` dark theme. nvim, bat, and yazi still select **cyberdream**; fish ships a cyberdream theme but does not select it. kitty takes its colors from the active Omarchy theme. The koda and ii-auto variants are also shipped for ghostty, kitty, and yazi. The font is **Victor Mono Nerd Font**.
|
||||
@@ -0,0 +1,20 @@
|
||||
# AI agents
|
||||
|
||||
The shared agent skill library and the shell entry points for coding agents.
|
||||
|
||||
The repo manages the agent skill library only. Claude Code (`~/.claude`) and omp (`~/.omp`) configs are not in this repo. omp, opencode, and crush are global mise tools (`packages.shared.mise`, installed by [15-tools](../chezmoi/scripts.md#15-tools)) and are updated by topgrade's `mise upgrade`; no other agent CLI is installed by chezmoi.
|
||||
|
||||
- [Skills](skills.md): Agent skills declared in `.chezmoidata/skills.yaml` and installed into `~/.agents/skills` and `~/.claude/skills` by an apply script.
|
||||
|
||||
## Pages
|
||||
|
||||
| Page | Source in repo | Target in `$HOME` | Covers |
|
||||
| --- | --- | --- | --- |
|
||||
| [Skills](skills.md) | `.chezmoidata/skills.yaml`, `.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` | `~/.agents/skills/`, `~/.claude/skills/` | Skill list and sources; installed by the Skills CLI, not vendored |
|
||||
|
||||
## Shell entry points
|
||||
|
||||
- `ai` (fish function) opens a `gum choose` picker over `claude`, `opencode`, `codex`, `hermes`, and `fractal`. Picking `claude` runs `claude --dangerously-skip-permissions`; the others run the binary of the same name. See [fish](../shell/fish.md).
|
||||
- <kbd>Ctrl</kbd> <kbd>A</kbd> runs [`omp-session`](../shell/scripts.md#omp-session) from the fish and zsh prompt: on the default branch it resumes a session written in the last 3 hours, else opens the `omp-sessions` television cable; on any other branch it resumes that branch's newest session or starts a new one. `tv agents` still lists every installed agent CLI ([television](../tools/television.md#agents)).
|
||||
- <kbd>Ctrl</kbd> <kbd>N</kbd> starts a new omp session from the fish and zsh prompt, skipping every resume rule. Inside the `omp-sessions` cable, <kbd>ctrl-n</kbd> does the same instead of resuming the selected session.
|
||||
- `launch_omp_livediff_overlay` and `lc-elir` are omp helpers in `~/.local/bin`; see [scripts](../shell/scripts.md).
|
||||
@@ -0,0 +1,218 @@
|
||||
# Skills
|
||||
|
||||
Agent skills declared in .chezmoidata/skills.yaml and installed into ~/.agents/skills and ~/.claude/skills by a chezmoi script.
|
||||
|
||||
Agent skills are folders with a `SKILL.md` file (frontmatter `name` and `description`, then instructions) that agents load on demand. The repo does not vendor them. It declares each skill and its source in `.chezmoidata/skills.yaml`, and the `run_onchange_after_25-skills.sh.tmpl` script installs them with the Skills CLI (`npx skills`) on `chezmoi apply`.
|
||||
|
||||
## Files
|
||||
|
||||
| Source in repo | Target | Notes |
|
||||
| --- | --- | --- |
|
||||
| `.chezmoidata/skills.yaml` | chezmoi data `.skills` | CLI version, default agents, and one entry per source |
|
||||
| `.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` | runs `skills add` / `skills remove` | Re-runs when `.skills` changes; see [Scripts](../chezmoi/scripts.md#25-skills) |
|
||||
|
||||
Not role-gated; the sync runs on every machine. Installed skill files are machine state, not repo files:
|
||||
|
||||
| Path | Written by | Contents |
|
||||
| --- | --- | --- |
|
||||
| `~/.agents/skills/<name>/` | Skills CLI | Shared library for `universal` installs, read by Codex, Gemini CLI, OpenCode, Zed, … |
|
||||
| `~/.claude/skills/<name>` | Skills CLI | Relative symlink `../../.agents/skills/<name>` for universal installs; a real copied directory for Claude-only installs |
|
||||
| `$XDG_STATE_HOME/skills/.skill-lock.json` | Skills CLI | The CLI's own install record (`~/.agents/.skill-lock.json` when `XDG_STATE_HOME` is unset) |
|
||||
| `${XDG_STATE_HOME:-~/.local/state}/chezmoi/skills.txt` | sync script | Skill names installed by the previous sync, used to remove undeclared ones |
|
||||
|
||||
## skills.yaml
|
||||
|
||||
```yaml
|
||||
skills:
|
||||
cli: skills@1.7.0 # pinned CLI, run via npx -y
|
||||
agents: [universal, claude-code] # default install targets
|
||||
sources:
|
||||
- source: cloudflare/skills
|
||||
agents: [claude-code] # Claude Code only
|
||||
skills: [agents-sdk, durable-objects]
|
||||
```
|
||||
|
||||
| Key | Meaning |
|
||||
| --- | --- |
|
||||
| `cli` | npm spec of the Skills CLI, run as `npx -y <cli>` |
|
||||
| `agents` | Default `-a` targets. `universal` is `~/.agents/skills`; `claude-code` is `~/.claude/skills` |
|
||||
| `sources[].source` | Anything `skills add` accepts: `owner/repo` (default branch), a GitHub tree URL (pins a ref or subdirectory), or a well-known endpoint URL |
|
||||
| `sources[].skills` | Skill names to install from that source (`--skill`) |
|
||||
| `sources[].agents` | Optional override of the default `agents` |
|
||||
|
||||
108 skills across 42 source entries. `cloudflare/skills` appears twice: once with the defaults, once with `agents: [claude-code]`.
|
||||
|
||||
### Pinned sources
|
||||
|
||||
Unpinned sources track the upstream default branch, so skill content updates whenever the sync runs. Skills that upstream deleted or renamed are pinned to the last ref that still has them:
|
||||
|
||||
| Source | Skills | Reason |
|
||||
| --- | --- | --- |
|
||||
| `https://github.com/mattpocock/skills/tree/v1.1.0` | `design-an-interface`, `obsidian-vault`, `qa`, `request-refactor-plan`, `ubiquitous-language`, `writing-great-skills` | Removed upstream in c66bdee (`writing-great-skills` became `writing-for-agents`) |
|
||||
| `https://github.com/mattpocock/skills/tree/153fc1b…` | `resolving-merge-conflicts` | Removed upstream in daa01d8 |
|
||||
| `https://github.com/terrylica/cc-skills/tree/6d35f84…` | `mise-tasks` | Retired upstream in dd0d3f2f |
|
||||
| `https://github.com/cloudflare/skills/tree/30553f8…` | `sandbox-sdk` | Replaced upstream by `sandbox-stable` / `sandbox-next` in f96bff7 |
|
||||
|
||||
`create-beads-orchestration` uses the subdirectory URL `https://github.com/AvivK5498/Claude-Code-Beads-Orchestration/tree/main/skills/create-beads-orchestration`, because the bare repo's root `SKILL.md` would install the whole repository as the skill. The Mintlify skills come from the well-known endpoint `https://mintlify.com/docs`.
|
||||
|
||||
### Not managed
|
||||
|
||||
`omarchy` and `diagnose-crash` (symlinks into `/usr/share/omarchy`) and `terminal-browser` are installed by other packages. They are not in `skills.yaml`, and the sync never touches them.
|
||||
|
||||
## Managing skills
|
||||
|
||||
Find a skill's source and name with the CLI, then declare it:
|
||||
|
||||
```sh
|
||||
npx skills find <query> # search the registry
|
||||
npx skills add <source> --list # list the skills a source provides
|
||||
```
|
||||
|
||||
- **Add**: add the name under its source in `.chezmoidata/skills.yaml` (or a new `source` entry) and run `chezmoi apply`.
|
||||
- **Remove**: delete the name and run `chezmoi apply`; the sync runs `skills remove` for it.
|
||||
- **Claude Code only**: put it in an entry with `agents: [claude-code]`.
|
||||
|
||||
Do not `npx skills add` by hand and expect chezmoi to track it; only `skills.yaml` is the record. The script only re-runs when `.skills` changes, so unpinned sources pick up upstream updates on the next sync after an edit to `skills.yaml`.
|
||||
|
||||
## How the sync works
|
||||
|
||||
1. **Trigger**
|
||||
|
||||
The script is `run_onchange_after_`: chezmoi re-runs it after applying files whenever the sha256 of `.skills` (as JSON) changes. If `npx` is missing it warns and skips.
|
||||
|
||||
2. **Migrate**
|
||||
|
||||
One-time cleanup of the old vendored layout: deletes any directory in `~/.agents/skills` or `~/.claude/skills` that contains symlinks into the chezmoi source directory, and removes `~/.agents/.skill-lock.json` if it is a symlink into the source directory.
|
||||
|
||||
3. **Remove**
|
||||
|
||||
Skills listed in `skills.txt` (the previous sync) but no longer declared are removed with `skills remove -g -y`.
|
||||
|
||||
4. **Install**
|
||||
|
||||
One `skills add <source> -g -y -a <agents> --skill <names…>` per source entry. Output is captured; on failure the last 8 lines are printed.
|
||||
|
||||
5. **Record**
|
||||
|
||||
The declared names are written to `skills.txt`. Claude-only (`-a claude-code`) installs are not recorded in the CLI lock, which is why the script keeps its own state file.
|
||||
|
||||
6. **Retry**
|
||||
|
||||
If any source failed the script exits 1, so chezmoi keeps the old hash and runs it again on the next apply.
|
||||
|
||||
Every universal skill gets both a `~/.agents/skills` directory and a `~/.claude/skills` link. Claude Code resolves `~/.claude/skills/<name>` → `../../.agents/skills/<name>`, so both read the same files.
|
||||
|
||||
## Library
|
||||
|
||||
The Description column is the first sentence of each installed skill's `SKILL.md` frontmatter `description`. Source is the `source` from `skills.yaml` (GitHub URLs shortened to `owner/repo/tree/<ref>`). Agents `claude-code` means the skill is installed as a real directory in `~/.claude/skills` only.
|
||||
|
||||
| Skill | Source | Agents | Description |
|
||||
| --- | --- | --- | --- |
|
||||
| `absurd` | `earendil-works/absurd` | claude-code | Debug and operate Absurd durable workflows with absurdctl. |
|
||||
| `agents-sdk` | `cloudflare/skills` | claude-code | Build, debug, or review Cloudflare Agents SDK applications using the agents package. |
|
||||
| `brandkit` | `Leonxlnx/taste-skill` | universal + claude-code | Premium brand-kit image generation skill for creating high-end brand-guidelines boards, logo systems, identity decks, and visual-world presentations. |
|
||||
| `bun-development` | `sickn33/antigravity-awesome-skills` | universal + claude-code | Fast, modern JavaScript/TypeScript development with the Bun runtime, inspired by [oven-sh/bun](https://github.com/oven-sh/bun). |
|
||||
| `cloudflare` | `cloudflare/skills` | universal + claude-code | Discover and choose Cloudflare products for apps, APIs, AI agents, storage, networking, and security. |
|
||||
| `cloudflare-email-service` | `cloudflare/skills` | claude-code | Implement or troubleshoot Cloudflare Email Sending and Email Routing integrations and their delivery configuration. |
|
||||
| `cloudflare-one` | `cloudflare/skills` | claude-code | Design, configure, troubleshoot, or review Cloudflare One Zero Trust and SASE deployments. |
|
||||
| `cloudflare-one-migrations` | `cloudflare/skills` | claude-code | Assess and plan migrations from existing VPN, SWG, or SASE platforms to Cloudflare One, including policy mapping, parity gaps, and rollout. |
|
||||
| `codebase-design` | `mattpocock/skills` | universal + claude-code | Shared vocabulary for designing deep modules. |
|
||||
| `core` | `vercel-labs/json-render` | universal + claude-code | Core package for defining schemas, catalogs, and AI prompt generation for json-render. |
|
||||
| `create-beads-orchestration` | `AvivK5498/Claude-Code-Beads-Orchestration/tree/main/skills/create-beads-orchestration` | claude-code | Bootstrap lean multi-agent orchestration with beads task tracking. |
|
||||
| `deepinit` | `yeachan-heo/oh-my-claudecode` | universal + claude-code | Deep codebase initialization with hierarchical AGENTS.md documentation |
|
||||
| `design-an-interface` | `mattpocock/skills/tree/v1.1.0` | universal + claude-code | Generate multiple radically different interface designs for a module using parallel sub-agents. |
|
||||
| `design-taste-frontend` | `Leonxlnx/taste-skill` | universal + claude-code | Anti-slop frontend skill for landing pages, portfolios, and redesigns. |
|
||||
| `diagnosing-bugs` | `mattpocock/skills` | universal + claude-code | Diagnosis loop for hard bugs and performance regressions. |
|
||||
| `domain-modeling` | `mattpocock/skills` | universal + claude-code | Build and sharpen a project's domain model. |
|
||||
| `durable-objects` | `cloudflare/skills` | claude-code | Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination. |
|
||||
| `eli5` | `coldteadotai/pr-lens` | universal + claude-code | Explains a codebase, a folder, a feature, a command or a pull request to someone who knows nothing about it, as a PR Lens canvas whose walkthrough builds the picture one part at a time. |
|
||||
| `find-skills` | `vercel-labs/skills` | universal + claude-code | Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. |
|
||||
| `fumadocs-component-docs` | `TheOrcDev/8bitcn-ui` | universal + claude-code | Create component documentation with installation, usage examples, and preview sections. |
|
||||
| `fumadocs-mdx-structure` | `TheOrcDev/8bitcn-ui` | universal + claude-code | Create MDX documentation files with proper frontmatter, imports, and component integration. |
|
||||
| `fumadocs-registry-integration` | `TheOrcDev/8bitcn-ui` | universal + claude-code | Register 8-bit components in registry.json for shadcn/ui add command. |
|
||||
| `git-guardrails-claude-code` | `mattpocock/skills` | universal + claude-code | Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. |
|
||||
| `golang-pro` | `jeffallan/claude-skills` | universal + claude-code | Implements concurrent Go patterns using goroutines and channels, designs and builds microservices with gRPC or REST, optimizes Go application performance with pprof, and enforces idiomatic Go with generics, interfaces, and robust error handling. |
|
||||
| `gpt-taste` | `Leonxlnx/taste-skill` | universal + claude-code | Elite UX/UI & Advanced GSAP Motion Engineer. |
|
||||
| `grill-me` | `mattpocock/skills` | universal + claude-code | A relentless interview to sharpen a plan or design. |
|
||||
| `grill-with-docs` | `mattpocock/skills` | universal + claude-code | A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go. |
|
||||
| `grilling` | `mattpocock/skills` | universal + claude-code | Grill the user relentlessly about a plan, decision, or idea. |
|
||||
| `handoff` | `mattpocock/skills` | universal + claude-code | Compact the current conversation into a handoff document for another agent to pick up. |
|
||||
| `high-end-visual-design` | `Leonxlnx/taste-skill` | universal + claude-code | Teaches the AI to design like a high-end agency. |
|
||||
| `imagegen-frontend-web` | `Leonxlnx/taste-skill` | universal + claude-code | Elite frontend image-direction skill for generating premium, conversion-aware website design references. |
|
||||
| `implement` | `mattpocock/skills` | universal + claude-code | Implement a piece of work based on a spec or set of tickets. |
|
||||
| `improve-codebase-architecture` | `mattpocock/skills` | universal + claude-code | Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick. |
|
||||
| `interface-design` | `Dammyjay93/interface-design` | universal + claude-code | Craft-first interface design for dashboards, admin panels, SaaS apps, tools, settings pages, data interfaces, and interactive products. |
|
||||
| `laws-of-ux` | `RoleModel/rolemodel-skills` | universal + claude-code | Review and guide UI implementations using the 21 Laws of UX. |
|
||||
| `linear` | `openai/skills` | universal + claude-code | Manage issues, projects & team workflows in Linear. |
|
||||
| `linear-cli` | `schpet/linear-cli` | universal + claude-code | Manage Linear issues from the command line using the linear cli. |
|
||||
| `linear-documents` | `finesssee/linear-cli` | universal + claude-code | Manage Linear documents. |
|
||||
| `loop-me` | `mattpocock/skills` | universal + claude-code | Grill me about specs for the workflows I want to build, within this workspace. |
|
||||
| `loopy` | `Forward-Future/loop-library` | universal + claude-code | Discover, find, compare, audit, repair, adapt, craft, run, debrief, save, and prepare repeatable AI-agent loops for publication. |
|
||||
| `migrate-to-shoehorn` | `mattpocock/skills` | universal + claude-code | Migrate test files from `as` type assertions to @total-typescript/shoehorn. |
|
||||
| `minimalist-ui` | `Leonxlnx/taste-skill` | universal + claude-code | Clean editorial-style interfaces. |
|
||||
| `mintlify` | `https://mintlify.com/docs` | universal + claude-code | Build and maintain documentation sites with Mintlify. |
|
||||
| `mintlify-api` | `https://mintlify.com/docs` | universal + claude-code | Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically. |
|
||||
| `mintlify-docs` | `https://mintlify.com/docs` | universal + claude-code | Build and maintain documentation sites with Mintlify. |
|
||||
| `mise-tasks` | `terrylica/cc-skills/tree/6d35f84` | universal + claude-code | Orchestrate multi-step project workflows using mise task definitions with dependency management and argument handling. |
|
||||
| `native-sdk` | `vercel-labs/native` | universal + claude-code | Discovery skill for the Native SDK, the complete toolkit for building native desktop applications. |
|
||||
| `no-ai-slop` | `petergyang/no-ai-slop` | universal + claude-code | Edit drafts into sharper, more human writing while preserving the writer's personal voice, or detect AI-slop patterns without rewriting. |
|
||||
| `obscura` | `h4ckf0r0day/obscura` | universal + claude-code | Operate and validate Obscura for JavaScript page loading, stealth browsing, anti-fingerprinting, and browser automation. |
|
||||
| `obsidian-vault` | `mattpocock/skills/tree/v1.1.0` | universal + claude-code | Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. |
|
||||
| `openlogs-server-logs` | `charlietlamb/openlogs` | universal + claude-code | Fetch and inspect recent local server logs in repos that use openlogs or the `ol` CLI. |
|
||||
| `pr-lens` | `coldteadotai/pr-lens` | universal + claude-code | Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request. |
|
||||
| `prototype` | `mattpocock/skills` | universal + claude-code | Build a throwaway prototype to answer a design question. |
|
||||
| `qa` | `mattpocock/skills/tree/v1.1.0` | universal + claude-code | Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. |
|
||||
| `react` | `vercel-labs/json-render` | universal + claude-code | React renderer for json-render that turns JSON specs into React components. |
|
||||
| `react-email` | `vercel-labs/json-render` | universal + claude-code | React Email renderer for json-render that turns JSON specs into HTML or plain-text emails using @react-email/components and @react-email/render. |
|
||||
| `redesign-existing-projects` | `Leonxlnx/taste-skill` | universal + claude-code | Upgrades existing websites and apps to premium quality. |
|
||||
| `remix` | `remix-run/remix` | universal + claude-code | Builds, reviews, and refactors Remix 3 apps using the remix package and remix/* imports. |
|
||||
| `remotion-best-practices` | `remotion-dev/skills` | universal + claude-code | Router for all Remotion skills |
|
||||
| `remotion-captions` | `remotion-dev/skills` | universal + claude-code | Transcribing, displaying and animating captions |
|
||||
| `remotion-create` | `remotion-dev/skills` | universal + claude-code | Create a new Remotion video |
|
||||
| `remotion-docs` | `remotion-dev/skills` | universal + claude-code | Search Remotion documentation |
|
||||
| `remotion-interactivity` | `remotion-dev/skills` | universal + claude-code | Structure Remotion markup for interactivity |
|
||||
| `remotion-maps` | `remotion-dev/skills` | universal + claude-code | Remotion Map animation knowledge |
|
||||
| `remotion-markup` | `remotion-dev/skills` | universal + claude-code | Content, animation and effects best practices |
|
||||
| `remotion-multimedia` | `remotion-dev/skills` | universal + claude-code | Interacting with Mediabunny |
|
||||
| `remotion-render` | `remotion-dev/skills` | universal + claude-code | Export a Remotion video |
|
||||
| `remotion-saas` | `remotion-dev/skills` | universal + claude-code | Build an app with Remotion |
|
||||
| `remotion-studio` | `remotion-dev/skills` | universal + claude-code | Preview a Remotion video |
|
||||
| `remotion-upgrade` | `remotion-dev/skills` | universal + claude-code | Upgrade Remotion, and related packages |
|
||||
| `request-refactor-plan` | `mattpocock/skills/tree/v1.1.0` | universal + claude-code | Create a detailed refactor plan with tiny commits via user interview, then file it as a GitHub issue. |
|
||||
| `resolving-merge-conflicts` | `mattpocock/skills/tree/153fc1b` | universal + claude-code | Use when you need to resolve an in-progress git merge/rebase conflict. |
|
||||
| `rust-async-patterns` | `wshobson/agents` | universal + claude-code | Master Rust async programming with Tokio, async traits, error handling, and concurrent patterns. |
|
||||
| `rust-best-practices` | `apollographql/skills` | universal + claude-code | Guide for writing idiomatic Rust code based on Apollo GraphQL's best practices handbook. |
|
||||
| `rust-skills` | `leonardomso/rust-skills` | universal + claude-code | Comprehensive Rust coding guidelines with 265 rules across 26 categories. |
|
||||
| `rust-testing` | `affaan-m/everything-claude-code` | universal + claude-code | Rust testing patterns including unit tests, integration tests, async testing, property-based testing, mocking, and coverage. |
|
||||
| `sandbox-sdk` | `cloudflare/skills/tree/30553f8` | claude-code | Build sandboxed applications for secure code execution. |
|
||||
| `scaffold-exercises` | `mattpocock/skills` | universal + claude-code | Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. |
|
||||
| `setup-matt-pocock-skills` | `mattpocock/skills` | universal + claude-code | Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. |
|
||||
| `setup-pre-commit` | `mattpocock/skills` | universal + claude-code | Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. |
|
||||
| `shadcn` | `shadcn-ui/ui` | universal + claude-code | Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI, including chat interfaces. |
|
||||
| `solidity-foundry-development` | `whackur/solidity-agent-toolkit` | universal + claude-code | Foundry development workflow for Solidity smart contracts. |
|
||||
| `solidity-security` | `wshobson/agents` | universal + claude-code | Master smart contract security best practices to prevent common vulnerabilities and implement secure Solidity patterns. |
|
||||
| `stop-slop` | `hardikpandya/stop-slop` | universal + claude-code | Remove AI writing patterns from prose. |
|
||||
| `tanstack-form` | `tanstack-skills/tanstack-skills` | universal + claude-code | Headless, performant, and type-safe form state management for TS/JS, React, Vue, Angular, Solid, Lit, and Svelte. |
|
||||
| `tanstack-integration-best-practices` | `deckardger/tanstack-agent-skills` | universal + claude-code | Best practices for integrating TanStack Query with TanStack Router and TanStack Start. |
|
||||
| `tanstack-query-best-practices` | `deckardger/tanstack-agent-skills` | universal + claude-code | TanStack Query (React Query) best practices for data fetching, caching, mutations, and server state management. |
|
||||
| `tanstack-router-best-practices` | `deckardger/tanstack-agent-skills` | universal + claude-code | TanStack Router best practices for type-safe routing, data loading, search params, and navigation. |
|
||||
| `tanstack-start-best-practices` | `deckardger/tanstack-agent-skills` | universal + claude-code | TanStack Start best practices for full-stack React applications. |
|
||||
| `tanstack-table` | `tanstack-skills/tanstack-skills` | universal + claude-code | Headless UI for building powerful tables & datagrids for TS/JS, React, Vue, Solid, Svelte, Qwik, Angular, and Lit. |
|
||||
| `tdd` | `mattpocock/skills` | universal + claude-code | Test-driven development. |
|
||||
| `teach` | `mattpocock/skills` | universal + claude-code | Teach the user a new skill or concept, within this workspace. |
|
||||
| `todoist-cli` | `Doist/todoist-cli` | universal + claude-code | Manage Todoist tasks, projects, labels, filters, sections, comments, reminders, and workspaces via the `td` CLI. |
|
||||
| `triage` | `mattpocock/skills` | universal + claude-code | Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs. |
|
||||
| `turnstile-spin` | `cloudflare/skills` | claude-code | Set up, repair, or migrate to Cloudflare Turnstile bot verification in an existing frontend and backend, including server-side Siteverify. |
|
||||
| `typescript-expert` | `remix-run/remix` | universal + claude-code | Write, refactor, or review TypeScript code with strict, precise, maintainable types and without unnecessary `any`, type assertions, or type suppressions. |
|
||||
| `ubiquitous-language` | `mattpocock/skills/tree/v1.1.0` | universal + claude-code | Extract a DDD-style ubiquitous language glossary from the current conversation, flagging ambiguities and proposing canonical terms. |
|
||||
| `ui-ux-pro-max` | `nextlevelbuilder/ui-ux-pro-max-skill` | universal + claude-code | UI/UX design intelligence for web, mobile, and desktop. |
|
||||
| `uv-package-manager` | `wshobson/agents` | universal + claude-code | Master the uv package manager for fast Python dependency management, virtual environments, and modern Python project workflows. |
|
||||
| `web-design-guidelines` | `vercel-labs/agent-skills` | universal + claude-code | Review UI code for Web Interface Guidelines compliance. |
|
||||
| `web-perf` | `cloudflare/skills` | claude-code | Audit, diagnose, or optimize website loading and interaction performance, Core Web Vitals, and Lighthouse performance scores. |
|
||||
| `workers-best-practices` | `cloudflare/skills` | universal + claude-code | Cloudflare Workers best practices for production applications. |
|
||||
| `wrangler` | `cloudflare/skills` | universal + claude-code | Run or troubleshoot Wrangler CLI commands and configure Worker projects for local development, Previews, deployment, and Cloudflare resource management. |
|
||||
| `write-tests` | `remix-run/remix` | universal + claude-code | Write, refactor, or review tests in the Remix repository. |
|
||||
| `writing-beats` | `mattpocock/skills` | universal + claude-code | Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it. |
|
||||
| `writing-fragments` | `mattpocock/skills` | universal + claude-code | Writing, explore: mine raw fragments, no structure yet. |
|
||||
| `writing-great-skills` | `mattpocock/skills/tree/v1.1.0` | universal + claude-code | Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable. |
|
||||
| `writing-shape` | `mattpocock/skills` | universal + claude-code | Writing, exploit: shape raw material into an article, paragraph by paragraph. |
|
||||
@@ -0,0 +1,142 @@
|
||||
# How it works
|
||||
|
||||
Source layout, naming conventions, symlink mode, and the day-to-day chezmoi workflow for this repo.
|
||||
|
||||
The repo is a [chezmoi](https://chezmoi.io) source directory. It lives at `~/Code/prad.codes/env/omarchy` and chezmoi uses it as its source, either through `chezmoi init --source ~/Code/prad.codes/env/omarchy` or by cloning it into `~/.local/share/chezmoi`; both are the same checkout model chezmoi expects. Its remote is [env/omarchy](https://prad.codes/env/omarchy) (branch `main`). `chezmoi apply` renders it into `$HOME`. The [Installation](../installation.md) page covers first-time setup.
|
||||
|
||||
## Pages in this section
|
||||
|
||||
| Page | Covers |
|
||||
| --- | --- |
|
||||
| [Config and roles](config.md) | `.chezmoi.toml.tmpl`: prompts, machine role, symlink mode, age encryption, template data |
|
||||
| [Packages and aliases](data.md) | `.chezmoidata/packages.yaml` and `.chezmoidata/aliases.yaml`, and how they render |
|
||||
| [Apply scripts](scripts.md) | Every `run_*` script: when it runs, what triggers it, what it does per role |
|
||||
| [Externals and ignore rules](externals-and-ignore.md) | `.chezmoiexternal.toml` git clones and every `.chezmoiignore.tmpl` rule |
|
||||
|
||||
## Source layout
|
||||
|
||||
```text
|
||||
.chezmoi.toml.tmpl
|
||||
.chezmoidata/
|
||||
aliases.yaml
|
||||
packages.yaml
|
||||
skills.yaml
|
||||
.chezmoiexternal.toml
|
||||
.chezmoiexternals/
|
||||
agent-root.toml
|
||||
ghostty.toml
|
||||
herdr.toml
|
||||
kitty.toml
|
||||
omarchy.toml
|
||||
omp.toml
|
||||
television.toml
|
||||
tmux.toml
|
||||
tmux-palette.toml
|
||||
yazi.toml
|
||||
.chezmoiignore.tmpl
|
||||
.gitmodules
|
||||
.chezmoiscripts/
|
||||
run_onchange_before_10-packages.sh.tmpl
|
||||
run_onchange_after_15-tools.sh.tmpl
|
||||
run_onchange_after_20-gh-extensions.sh.tmpl
|
||||
run_onchange_after_25-skills.sh.tmpl
|
||||
run_once_after_30-user-services.sh.tmpl
|
||||
run_onchange_after_40-post.sh.tmpl
|
||||
run_onchange_after_build-bat-cache.sh.tmpl
|
||||
run_onchange_after_install-yazi-plugins.sh.tmpl
|
||||
dot_bashrc
|
||||
dot_zshrc
|
||||
dot_gitconfig.tmpl
|
||||
dot_config/
|
||||
atuin/
|
||||
bash/
|
||||
bat/
|
||||
drydock/
|
||||
fish/
|
||||
fontconfig/
|
||||
gh/
|
||||
gh-dash/
|
||||
go/
|
||||
herdr-nvim/
|
||||
hunk/
|
||||
hypr/
|
||||
lazydocker/
|
||||
lazygit/
|
||||
mimeapps.list
|
||||
shell/
|
||||
starship.toml
|
||||
systemd/
|
||||
topgrade.toml
|
||||
uwsm/
|
||||
waybar/
|
||||
xdg-terminals.list
|
||||
yazi.toml.tmpl
|
||||
zsh/
|
||||
dot_local/
|
||||
bin/
|
||||
dot_leetcode/
|
||||
docs/
|
||||
AGENTS.md
|
||||
README.md
|
||||
```
|
||||
|
||||
| Path | Target | Purpose |
|
||||
| --- | --- | --- |
|
||||
| `.chezmoi.toml.tmpl` | `~/.config/chezmoi/chezmoi.toml` | Config template rendered by `chezmoi init`. See [Config and roles](config.md). |
|
||||
| `.chezmoidata/` | — | YAML merged into template data (`.packages`, `.aliases`, `.skills`). See [Packages and aliases](data.md) and [Skills](../ai/skills.md). |
|
||||
| `.chezmoiexternal.toml` | — | Git repos cloned into `$HOME` (nvim config, a bat syntax, tpm). |
|
||||
| `.chezmoiexternals/` | — | One external per app or tool: agent-root, ghostty, herdr, kitty, omarchy, omp, television, tmux, tmux-palette, yazi. Plain config repos cloned into `~/.config/<app>`. See [Externals and ignore rules](externals-and-ignore.md#chezmoiexternals). |
|
||||
| `.gitmodules` | — | `dot_config/hypr` and `dot_config/fish` are git submodules. See [Submodules](externals-and-ignore.md#submodules). |
|
||||
| `.chezmoiignore.tmpl` | — | Target paths chezmoi skips; gates the Linux desktop layer by role. |
|
||||
| `.chezmoiscripts/`, root `run_*` | — | Install and housekeeping scripts. See [Apply scripts](scripts.md). |
|
||||
| `dot_config/` | `~/.config/` | Per-tool config. Documented under [Shell](../shell/README.md), [Terminal](../terminal/README.md), [Tools](../tools/README.md), [Desktop](../desktop/README.md). |
|
||||
| `dot_local/bin/` | `~/.local/bin/` | 37 standalone scripts shared by every shell, plus the `omarchy-*` helpers. |
|
||||
| `dot_leetcode/` | `~/.leetcode/` | leetcode CLI workspace state. |
|
||||
| `docs/`, `AGENTS.md`, `README.md` | — | These docs, the repo agent rules, and the repo README. Listed in `.chezmoiignore.tmpl`, never applied. |
|
||||
|
||||
Entries whose source name starts with `.` (`.claude/`, `.gitignore`) are ignored by chezmoi automatically and stay repo-only.
|
||||
|
||||
## Naming conventions
|
||||
|
||||
chezmoi encodes target names and attributes in source file names. These are the prefixes and suffixes the repo uses:
|
||||
|
||||
| Source form | Meaning | Examples here |
|
||||
| --- | --- | --- |
|
||||
| `dot_` | Target name starts with `.` | `dot_config` → `~/.config`, `dot_zshrc` → `~/.zshrc` |
|
||||
| `private_` | Target has group/world permissions cleared (`0600`/`0700`) | `dot_config/atuin/private_config.toml`, `dot_config/gh/private_config.yml`, `dot_config/hunk/private_state.json` |
|
||||
| `executable_` | Target gets the executable bit | Every script in `dot_local/bin/` |
|
||||
| `empty_` | File is kept even when empty | None currently |
|
||||
| `symlink_` | Target is a symlink; file content is the link destination | None currently |
|
||||
| `.tmpl` | Rendered with Go templates and chezmoi data | `dot_gitconfig.tmpl`, `dot_config/shell/aliases.sh.tmpl`, all scripts, the config and ignore files |
|
||||
| `run_once_` / `run_onchange_` + `before_` / `after_` | Script, with run frequency and phase | See [Apply scripts](scripts.md) |
|
||||
|
||||
Prefixes stack in chezmoi's fixed order, e.g. `private_dot_foo`, `executable_dot_bar`. No source file currently uses `encrypted_`, even though age encryption is configured.
|
||||
|
||||
## Symlink mode
|
||||
|
||||
`.chezmoi.toml.tmpl` sets `mode = "symlink"`. `chezmoi apply` then makes each managed dotfile a symlink into the source tree instead of a copy, as long as the file is a plain regular file. Files that are templates, `private_`, `executable_`, or encrypted are still written as real files.
|
||||
|
||||
What that means in practice:
|
||||
|
||||
- Editing a plain file in `$HOME` (for example `~/.config/waybar/config.jsonc`) edits the matching file in the source tree directly. The change is live and shows up in `git status` of the repo with no `chezmoi add` step.
|
||||
- Templates are rendered copies. Editing `~/.gitconfig` or `~/.config/shell/aliases.sh` changes only the copy; the next `chezmoi apply` overwrites it. Edit the `.tmpl` source (`chezmoi edit ~/.gitconfig`) instead.
|
||||
- `private_` and `executable_` targets are real files too. After editing one in place, run `chezmoi re-add <path>` to copy it back into the source.
|
||||
- Tools that rewrite their own config write through the symlink into the repo. The runtime state that would otherwise pollute the source (plugin dirs, lock files, `fish_variables`, `__pycache__`) is excluded in `.chezmoiignore.tmpl` and `.gitignore`; see [Externals and ignore rules](externals-and-ignore.md).
|
||||
|
||||
> [!NOTE]
|
||||
> Several fish aliases (`e.f`, `e.h`, `e.k`, `,,`) open the chezmoi source paths directly. Symlink mode makes that equivalent to editing the live config. `e.y` and `e.t` open the yazi and tmux external checkouts in `~/.config`.
|
||||
|
||||
## Daily workflow
|
||||
|
||||
| Command | What it does here |
|
||||
| --- | --- |
|
||||
| `chezmoi apply` | Runs `before_` scripts (package install), writes symlinks/files/templates into `$HOME`, clones missing externals, then runs `after_` scripts. |
|
||||
| `chezmoi update` | `git pull` in the source directory, then `apply`. |
|
||||
| `chezmoi diff` | Shows what `apply` would change, including rendered templates and scripts that would run. |
|
||||
| `chezmoi add <path>` | Moves a new file into the source tree under the right name. In symlink mode the target becomes a symlink on the next apply. Use `--template` or `--encrypt` for templated or secret files. |
|
||||
| `chezmoi re-add <path>` | Copies edits made to non-symlinked targets (private, executable) back into the source. |
|
||||
| `chezmoi edit <path>` | Opens the source file for a target, the right way to change templates. |
|
||||
| `chezmoi cd` | Opens a shell in the source directory for git work. The fish alias `,,` opens yazi there instead. |
|
||||
| `chezmoi init --prompt` | Re-asks name, email, and role and regenerates `~/.config/chezmoi/chezmoi.toml`. |
|
||||
|
||||
Commit and push from the source directory with plain git; the remote pushes over SSH (`git@prad.codes:env/omarchy.git`).
|
||||
@@ -0,0 +1,97 @@
|
||||
# Config and roles
|
||||
|
||||
The .chezmoi.toml.tmpl config template, its three prompts, symlink mode, age encryption, and where the resulting data is used.
|
||||
|
||||
`.chezmoi.toml.tmpl` is rendered once by `chezmoi init` into `~/.config/chezmoi/chezmoi.toml`. It asks three questions, turns on symlink mode and age encryption, and stores the answers as template data for every other `.tmpl` file.
|
||||
|
||||
## Source
|
||||
|
||||
**.chezmoi.toml.tmpl**
|
||||
|
||||
```toml
|
||||
{{- $name := promptStringOnce . "name" "Full name" "Prad Nukala" -}}
|
||||
{{- $email := promptStringOnce . "email" "Email" "prad@sonr.io" -}}
|
||||
{{- $roleDefault := "desktop" -}}
|
||||
{{- $role := promptChoiceOnce . "role" "Machine role" (list "desktop" "laptop" "server") $roleDefault -}}
|
||||
|
||||
mode = "symlink"
|
||||
encryption = "age"
|
||||
|
||||
[age]
|
||||
identity = "~/.config/chezmoi/key.txt"
|
||||
recipient = "age19tdqgavaekhvgqsd75n8a09vvshen2ykzy8kw6tenczz73449anqc3l7a6"
|
||||
useBuiltin = true
|
||||
|
||||
[data]
|
||||
name = {{ $name | quote }}
|
||||
email = {{ $email | quote }}
|
||||
role = {{ $role | quote }}
|
||||
```
|
||||
|
||||
## Prompts
|
||||
|
||||
| Key | Prompt | Type | Default |
|
||||
| --- | --- | --- | --- |
|
||||
| `name` | `Full name` | `promptStringOnce` | `Prad Nukala` |
|
||||
| `email` | `Email` | `promptStringOnce` | `prad@sonr.io` |
|
||||
| `role` | `Machine role` | `promptChoiceOnce` from `desktop`, `laptop`, `server` | `desktop` |
|
||||
|
||||
The `*Once` functions only prompt when the key is missing from the existing config, so re-running `chezmoi init` keeps earlier answers. `chezmoi init --prompt` forces all three prompts again. Changing the role changes the rendered ignore file and package script, so the next `chezmoi apply` adds or drops the desktop layer and re-runs the package install.
|
||||
|
||||
### Machine roles
|
||||
|
||||
| Role | Intended platform | Linux desktop layer | Desktop packages (`packages.arch.desktop`) |
|
||||
| --- | --- | --- | --- |
|
||||
| `desktop` | Arch Linux | Applied | Installed |
|
||||
| `laptop` | Arch Linux | Applied | Installed |
|
||||
| `server` | Omarchy/Arch Linux, headless | Skipped | Skipped |
|
||||
|
||||
`desktop` and `laptop` behave identically in the current templates; nothing branches on one without the other. The desktop layer is also skipped whenever the OS is not Linux, whatever the role. See [the ignore rules](externals-and-ignore.md#chezmoiignoretmpl) for the exact list of gated paths.
|
||||
|
||||
## Mode
|
||||
|
||||
`mode = "symlink"` makes `chezmoi apply` link plain files in `$HOME` back to the source tree. Templates, `private_`, `executable_`, and encrypted files are still written as real files. The [overview](README.md#symlink-mode) covers the editing consequences.
|
||||
|
||||
## Age encryption
|
||||
|
||||
| Setting | Value | Effect |
|
||||
| --- | --- | --- |
|
||||
| `encryption` | `"age"` | `chezmoi add --encrypt` and `encrypted_` source files use age. |
|
||||
| `age.identity` | `~/.config/chezmoi/key.txt` | Private key used to decrypt. Distributed by hand between machines, never committed. |
|
||||
| `age.recipient` | `age19tdqgavaekhvgqsd75n8a09vvshen2ykzy8kw6tenczz73449anqc3l7a6` | Public key files are encrypted to. Safe to publish. |
|
||||
| `age.useBuiltin` | `true` | Uses chezmoi's built-in age implementation; the `age` binary is not required. |
|
||||
|
||||
No source file currently carries the `encrypted_` attribute, so the key is only exercised when a secret is added with `chezmoi add --encrypt`. The [Installation](../installation.md) page still asks for the key to be copied into place before the first apply:
|
||||
|
||||
```sh
|
||||
mkdir -p ~/.config/chezmoi
|
||||
scp <existing-machine>:.config/chezmoi/key.txt ~/.config/chezmoi/key.txt
|
||||
chmod 600 ~/.config/chezmoi/key.txt
|
||||
```
|
||||
|
||||
## Template data
|
||||
|
||||
The `[data]` table exposes `.name`, `.email`, and `.role` to every template. chezmoi also merges `.chezmoidata/*.yaml` into the same namespace (`.packages`, `.aliases`; see [Packages and aliases](data.md)) and provides built-ins such as `.chezmoi.os`.
|
||||
|
||||
| Variable | Consumed by | Use |
|
||||
| --- | --- | --- |
|
||||
| `.name` | `dot_gitconfig.tmpl` | `[user] name` in `~/.gitconfig` |
|
||||
| `.email` | `dot_gitconfig.tmpl` | `[user] email` in `~/.gitconfig` |
|
||||
| `.role` | `.chezmoiignore.tmpl` | Skips the Linux desktop layer unless role is `desktop` or `laptop` |
|
||||
| `.role` | `.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl` | Adds the `arch.desktop` pacman and AUR packages for `desktop`/`laptop` |
|
||||
| `.chezmoi.os` | `.chezmoi.toml.tmpl` | Role default (`desktop`) |
|
||||
| `.chezmoi.os` | `.chezmoiignore.tmpl` | Desktop layer requires `linux` |
|
||||
| `.chezmoi.os` | `run_onchange_before_10-packages.sh.tmpl` | pacman/yay on `linux` |
|
||||
| `.chezmoi.os` | `run_once_after_30-user-services.sh.tmpl` | systemd user units on `linux` only |
|
||||
| `.chezmoi.os` | `run_onchange_after_40-post.sh.tmpl` | `fc-cache` on `linux` only |
|
||||
| `.chezmoi.os`, `.role` | `run_onchange_after_15-tools.sh.tmpl` | strata install on `linux` with role `desktop`/`laptop` |
|
||||
|
||||
**dot_gitconfig.tmpl**
|
||||
|
||||
```ini
|
||||
[user]
|
||||
email = {{ .email }}
|
||||
name = {{ .name }}
|
||||
```
|
||||
|
||||
The rest of `~/.gitconfig` is covered under [Tools](../tools/README.md).
|
||||
@@ -0,0 +1,182 @@
|
||||
# Packages and aliases
|
||||
|
||||
The .chezmoidata YAML files that declare every installed package and every shared shell alias, and how they render.
|
||||
|
||||
Files in `.chezmoidata/` are merged into chezmoi's template data on every run. Nothing in the directory is written to `$HOME`; the data only reaches the machine through templates and scripts.
|
||||
|
||||
| File | Data key | Consumed by |
|
||||
| --- | --- | --- |
|
||||
| `.chezmoidata/packages.yaml` | `.packages` | [`run_onchange_before_10-packages.sh.tmpl`](scripts.md#10-packages), [`run_onchange_after_15-tools.sh.tmpl`](scripts.md#15-tools), [`run_onchange_after_20-gh-extensions.sh.tmpl`](scripts.md#20-gh-extensions) |
|
||||
| `.chezmoidata/aliases.yaml` | `.aliases` | `dot_config/shell/aliases.sh.tmpl` (bash and zsh) |
|
||||
| `.chezmoidata/skills.yaml` | `.skills` | [`run_onchange_after_25-skills.sh.tmpl`](scripts.md#25-skills) |
|
||||
|
||||
## packages.yaml
|
||||
|
||||
One manifest for Arch, plus a `shared` block. Any edit to the file changes the hash embedded in the package script, so the next `chezmoi apply` re-runs the install. Installs are idempotent (`pacman --needed`, `yay`/`paru --needed`). The lists are derived from what the configs actually invoke: tmux-palette items, television cable `requirements`, fish functions, `~/.local/bin` scripts, and compositor bindings.
|
||||
|
||||
### Arch
|
||||
|
||||
`packages.arch.pacman`, installed on every Linux machine with `pacman -S --needed --noconfirm`:
|
||||
|
||||
| Group | Packages |
|
||||
| --- | --- |
|
||||
| Shell and editors | `fish`, `neovim`, `helix`, `micro`, `tmux` |
|
||||
| Terminals | `ghostty` (default), `kitty` |
|
||||
| TUI tools (tmux-palette, television cables) | `yazi`, `lazygit`, `lazydocker`, `docker`, `docker-compose`, `btop`, `fastfetch`, `onefetch`, `television`, `serie`, `tig`, `gitui`, `tldr`, `navi`, `mdfried` |
|
||||
| VCS and forge | `git`, `github-cli`, `git-delta`, `diffnav`, `tea` |
|
||||
| Search and files | `fzf`, `fd`, `ripgrep`, `zoxide`, `eza`, `bat`, `jq`, `duf` |
|
||||
| Media and preview (yazi and tv deps) | `ffmpeg`, `ffmpegthumbnailer`, `poppler`, `resvg`, `imagemagick`, `chafa`, `7zip`, `unzip` |
|
||||
| Remote | `mosh`, `sshfs`, `tailscale` |
|
||||
| Misc CLI | `mise`, `gum`, `glow`, `atuin`, `wget`, `starship`, `zsh-syntax-highlighting` |
|
||||
| Fonts | `ttf-victor-mono-nerd` |
|
||||
|
||||
`packages.arch.aur`, installed with `yay -S --needed --noconfirm` (or `paru`) on every Linux machine: `topgrade`, `portop`. Names some installed package already provides are skipped, and yay is bootstrapped when no helper exists ([10-packages](scripts.md#10-packages)).
|
||||
|
||||
`packages.arch.desktop`, added only for roles `desktop` and `laptop`:
|
||||
|
||||
| Source | Packages |
|
||||
| --- | --- |
|
||||
| pacman | `uwsm`, `xdg-user-dirs`; Wayland utilities `wl-clipboard`, `cliphist`, `wtype`, `ydotool`, `grim`, `slurp`, `hyprpicker`, `pamixer`, `brightnessctl`, `libnotify`; apps `nautilus`, `imv`, `mpv`, `evince`, `chromium`, `obsidian`; strata runtime deps `bubblewrap`, `desktop-file-utils`, `fontconfig`, `gstreamer`, `gst-libav`, `gst-plugins-base`, `gst-plugins-good`, `gtk4`, `gtksourceview5`, `gvfs`, `poppler-glib`, `xdg-utils` |
|
||||
| AUR (or a sync repo with the same name) | `tldraw-offline-bin`; desktop apps `beeper-bin`, `fastmail`, `1password`, `brave-origin-bin`, `claude-desktop`, `spotify` |
|
||||
| `[omarchy]` repo (`packages.arch.desktop.omarchy`, only when `pacman-conf -l` lists that repo) | `herdr`, `flea`, `voxtype-bin`, `xdg-terminal-exec`, `hyprland-preview-share-picker` |
|
||||
|
||||
Hyprland, Waybar and the `omarchy-*` commands come with the Omarchy install and are not declared. strata (the folder handler) has no package; [15-tools](scripts.md#15-tools) runs its installer.
|
||||
|
||||
### Shared
|
||||
|
||||
`packages.shared.gh_extensions`, installed by the gh-extensions script:
|
||||
|
||||
| Extension | Purpose |
|
||||
| --- | --- |
|
||||
| `davidraviv/gh-clean-branches` | `gh clean-branches`: delete local branches whose upstream is gone |
|
||||
| `prdlk/gh-commit` | `gh commit` |
|
||||
| `dlvhdr/gh-dash` | `gh dash`: PR and issue dashboard |
|
||||
| `meiji163/gh-notify` | `gh notify`: notifications in the terminal |
|
||||
|
||||
`packages.shared.cargo` lists `suvadu`, `mandible` (the tmux-palette "mandible" item runs `~/.local/bin/mandible-pick`), and `worktrunk` (`wt`, git worktree management for parallel agent work). [`run_onchange_after_15-tools.sh.tmpl`](scripts.md#15-tools) installs rustup when `cargo` is missing, then any crate `cargo install --list` lacks.
|
||||
|
||||
`packages.shared.mise` lists the global mise tools: `ghq`, `bun`, `node`, `uv`, `opencode`, `crush`, and omp as `github:can1357/oh-my-pi` (omp is not in the mise registry, so it uses the GitHub-releases backend, which installs the release binary as `omp`). The same script runs `mise use -g` for each one not yet in the global config (`~/.config/mise/config.toml`, local per machine), then `mise install` on the list. A tool already there keeps its pinned version. topgrade's mise step (`mise upgrade`) updates them.
|
||||
|
||||
> [!NOTE]
|
||||
> AUR packages need `yay` or `paru`. The package script bootstraps `yay` when neither exists; only when that is impossible (running as root with no repo shipping yay) does it print a warning listing the skipped AUR packages and continue.
|
||||
|
||||
## aliases.yaml
|
||||
|
||||
The single source for aliases shared across shells. Each entry has a `section` and a list of `{ name, cmd }` items.
|
||||
|
||||
### Editors / file managers
|
||||
|
||||
| Alias | Command |
|
||||
| --- | --- |
|
||||
| `e` | `nvim` |
|
||||
| `e.d` | `cd ~/.config/dotstate/storage/Rogz/.config && yazi` |
|
||||
| `e.f` | `cd ~/.config/fish && yazi` |
|
||||
| `e.k` | `yazi ~/.config/kitty` |
|
||||
| `e.v` | `yazi ~/.config/nvim/lua` |
|
||||
| `e.y` | `yazi ~/.config/yazi` |
|
||||
| `e.t` | `nvim ~/.config/tmux/tmux.conf` |
|
||||
| `hx` | `helix` |
|
||||
|
||||
### Quick directory jumps
|
||||
|
||||
| Alias | Command |
|
||||
| --- | --- |
|
||||
| `cdc` | `cd ~/.config && yazi` |
|
||||
| `cdd` | `cd ~/Developer && yazi` |
|
||||
| `cdk` | `cd ~/Documents/Knowledge && obsidian` |
|
||||
| `cdl` | `cd ~/.local && yazi` |
|
||||
| `cds` | `cd ~/.local/share/services && ls` |
|
||||
| `cdw` | `cd ~/Downloads && yazi` |
|
||||
|
||||
### Tools
|
||||
|
||||
| Alias | Command |
|
||||
| --- | --- |
|
||||
| `dd` | `lazydocker` |
|
||||
| `gg` | `lazygit` |
|
||||
| `ff` | `exec fish` |
|
||||
| `npx` | `bunx` |
|
||||
| `sm` | `sudo micro` |
|
||||
| `sd` | `ssh prad@<lan-host>` |
|
||||
| `oc` | `opencode` |
|
||||
| `dss` | `dotstate sync` |
|
||||
| `fabric` | `fabric-ai` |
|
||||
| `bk` | `bead-kanban` |
|
||||
| `lc` | `leetcode` |
|
||||
| `tk` | `task` |
|
||||
|
||||
`dd` shadows coreutils `dd` in interactive shells.
|
||||
|
||||
## How aliases render
|
||||
|
||||
### bash and zsh
|
||||
|
||||
`dot_config/shell/aliases.sh.tmpl` renders to `~/.config/shell/aliases.sh`. Because it is a template it is written as a real file, not a symlink; edit the YAML and run `chezmoi apply` to regenerate it.
|
||||
|
||||
**dot_config/shell/aliases.sh.tmpl**
|
||||
|
||||
```sh
|
||||
{{- range .aliases }}
|
||||
|
||||
# {{ .section }}
|
||||
{{- range .items }}
|
||||
alias {{ .name }}='{{ .cmd }}'
|
||||
{{- end }}
|
||||
{{- end }}
|
||||
```
|
||||
|
||||
After the generated block the file adds shell-specific pieces that are not in the YAML:
|
||||
|
||||
| Name | Definition |
|
||||
| --- | --- |
|
||||
| `cpy` / `pst` | `wl-copy` / `wl-paste` when `wl-copy` exists |
|
||||
| `q` | Function: if `$YAZI_ID` is set and `ya` exists, runs `ya emit quit` so the parent yazi also exits, then `exit` |
|
||||
| `celar`, `claer` | Typo guards for `clear` |
|
||||
| `ls` | `eza --icons`, when `eza` is installed |
|
||||
|
||||
`~/.bashrc` and `~/.zshrc` source it for interactive shells:
|
||||
|
||||
**dot_bashrc**
|
||||
|
||||
```sh
|
||||
[ -f "$HOME/.config/shell/aliases.sh" ] && . "$HOME/.config/shell/aliases.sh"
|
||||
```
|
||||
|
||||
See [bash and zsh](../shell/README.md) for the rest of those files.
|
||||
|
||||
### fish
|
||||
|
||||
`dot_config/fish/conf.d/20-aliases.fish` is not a template. It is a hand-maintained plain file (symlinked into `~/.config/fish/conf.d/`) whose header says it is generated from the YAML; the YAML header likewise names a `20-aliases.fish.tmpl` that does not exist. The fish file has drifted from `aliases.yaml`:
|
||||
|
||||
| Alias | aliases.yaml (bash/zsh) | fish |
|
||||
| --- | --- | --- |
|
||||
| `e.d` | `cd ~/.config/dotstate/storage/Rogz/.config && yazi` | not defined |
|
||||
| `e.f` | `cd ~/.config/fish && yazi` | `cd ~/.local/share/chezmoi/dot_config/fish && yazi` |
|
||||
| `e.h` | not defined | `cd ~/.local/share/chezmoi/dot_config/hypr && yazi` |
|
||||
| `e.k` | `yazi ~/.config/kitty` | ✓ |
|
||||
| `e.y` | `yazi ~/.config/yazi` | ✓ |
|
||||
| `e.t` | `nvim ~/.config/tmux/tmux.conf` | ✓ |
|
||||
| `cdd` | `cd ~/Developer && yazi` | not defined |
|
||||
| `,,` | not defined | `cd ~/.local/share/chezmoi && yazi` |
|
||||
| `..` | not defined | `cd ..` |
|
||||
|
||||
fish-only Bun aliases:
|
||||
|
||||
| Alias | Command |
|
||||
| --- | --- |
|
||||
| `br` | `bun run` |
|
||||
| `br.d` | `bun run dev` |
|
||||
| `br.b` | `bun run build` |
|
||||
| `br.t` | `bun run test` |
|
||||
| `bi` | `bun install` |
|
||||
| `bg` | `bun install -g` (shadows fish's `bg` job-control builtin) |
|
||||
| `bx` | `bunx` |
|
||||
|
||||
Every other YAML alias (`e`, `e.v`, `hx`, `cdc`, `cdk`, `cdl`, `cds`, `cdw`, and the whole Tools section) is defined identically in fish. The file ends with the same extras as the sh version: `cpy`/`pst` clipboard detection, the `q` function, and, in interactive sessions only, `celar`/`claer` and `ls` → `eza --icons`. `clear` itself is an autoloaded function (`functions/clear.fish`), which is why it is not aliased. See [fish](../shell/fish.md).
|
||||
|
||||
> [!TIP]
|
||||
> To add an alias for every shell, add it to `aliases.yaml` for bash/zsh and to `20-aliases.fish` by hand for fish.
|
||||
|
||||
## skills.yaml
|
||||
|
||||
Declares the agent skills installed by the Skills CLI. `skills.cli` is the pinned CLI (`skills@1.7.0`, run with `npx -y`), `skills.agents` the default install targets (`[universal, claude-code]`), and `skills.sources` a list of `{ source, skills, agents? }` entries: 110 skills across 42 entries. The full list, pinned sources, and add/remove workflow are on the [Skills](../ai/skills.md) page.
|
||||
@@ -0,0 +1,176 @@
|
||||
# Externals and ignore rules
|
||||
|
||||
The git repos chezmoi clones into $HOME and every rule in .chezmoiignore.tmpl, including the role gate for the Linux desktop layer.
|
||||
|
||||
## .chezmoiexternal.toml
|
||||
|
||||
Externals are content chezmoi fetches instead of storing in the repo. Every entry is a `git-repo` external: chezmoi runs `git clone` when the target directory is missing. Because they are real git checkouts, they are never symlinked into the source tree.
|
||||
|
||||
**.chezmoiexternal.toml**
|
||||
|
||||
```toml
|
||||
[".config/nvim"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/nvim.git"
|
||||
[".config/nvim".pull]
|
||||
args = ["--ff-only"]
|
||||
|
||||
[".config/bat/syntaxes/sublime-purescript-syntax"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/tellnobody1/sublime-purescript-syntax.git"
|
||||
[".config/bat/syntaxes/sublime-purescript-syntax".pull]
|
||||
args = ["--ff-only"]
|
||||
|
||||
[".config/tmux/plugins/tpm"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/tmux-plugins/tpm.git"
|
||||
[".config/tmux/plugins/tpm".pull]
|
||||
args = ["--ff-only"]
|
||||
```
|
||||
|
||||
| Target | Repo | Used by |
|
||||
| --- | --- | --- |
|
||||
| `~/.config/nvim` | [prdlk/nvim](https://github.com/prdlk/nvim) | Neovim config, kept in its own repo |
|
||||
| `~/.config/bat/syntaxes/sublime-purescript-syntax` | [tellnobody1/sublime-purescript-syntax](https://github.com/tellnobody1/sublime-purescript-syntax) | PureScript syntax for bat, compiled into bat's cache by the [bat cache scripts](scripts.md#build-bat-cache) |
|
||||
| `~/.config/tmux/plugins/tpm` | [tmux-plugins/tpm](https://github.com/tmux-plugins/tpm) | tmux plugin manager, run from the bottom of `tmux.conf` ([tmux](../terminal/tmux.md)). Cloned inside the tmux checkout, whose `.gitignore` excludes `plugins/` |
|
||||
|
||||
### No refreshPeriod
|
||||
|
||||
No entry in `.chezmoiexternal.toml` sets `refreshPeriod`, so it stays at chezmoi's default of never. chezmoi clones each repo on a fresh machine and otherwise leaves it alone: `chezmoi apply` and `chezmoi update` do not pull. The local nvim checkout always wins over the remote, so in-progress Neovim edits and unpushed commits are never disturbed by an apply.
|
||||
|
||||
To update explicitly, run `chezmoi apply --refresh-externals` (`-R`), which pulls with `git pull --ff-only`. `--ff-only` makes the pull fail instead of creating a merge commit when the local checkout has diverged.
|
||||
|
||||
## .chezmoiexternals/
|
||||
|
||||
Per-app config repos, one file each in `.chezmoiexternals/<app>.toml`. Each is a `git-repo` external with `refreshPeriod = "168h"` and `pull.args = ["--ff-only"]`, so `chezmoi apply` fast-forwards them at most once a week. The repos hold plain config files (no chezmoi prefixes) and are not part of `chezmoi managed` contents. The exception is [`agent-root.toml`](#agent-root), a single downloaded script.
|
||||
|
||||
**.chezmoiexternals/tmux.toml**
|
||||
|
||||
```toml
|
||||
[".config/tmux"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/tmux.git"
|
||||
refreshPeriod = "168h"
|
||||
[".config/tmux".pull]
|
||||
args = ["--ff-only"]
|
||||
```
|
||||
|
||||
| File | Target | Repo |
|
||||
| --- | --- | --- |
|
||||
| `tmux.toml` | `~/.config/tmux` | [prdlk/tmux](https://github.com/prdlk/tmux) |
|
||||
| `tmux-palette.toml` | `~/.config/tmux-palette` | [prdlk/tmux-palette](https://github.com/prdlk/tmux-palette) |
|
||||
| `television.toml` | `~/.config/television` | [prdlk/television](https://github.com/prdlk/television) |
|
||||
| `yazi.toml` | `~/.config/yazi` | [prdlk/yazi](https://github.com/prdlk/yazi) |
|
||||
| `kitty.toml` | `~/.config/kitty` | [prdlk/kitty](https://github.com/prdlk/kitty) |
|
||||
| `ghostty.toml` | `~/.config/ghostty` | [prdlk/ghostty](https://github.com/prdlk/ghostty) |
|
||||
| `herdr.toml` | `~/.config/herdr` | [prdlk/herdr](https://github.com/prdlk/herdr) — `plugins/github/` (runtime plugin checkouts) is gitignored there |
|
||||
| `omarchy.toml` | `~/.config/omarchy` | [prdlk/omarchy](https://github.com/prdlk/omarchy) — `shell.json`, hooks, menu extensions, themed templates; git-installed themes/plugins are gitignored there and restored by its `install-extras` script, `calendars.json` is never committed |
|
||||
| `omp.toml` | `~/.omp` | [prdlk/omp](https://github.com/prdlk/omp) — omp agent config and the global agent instructions |
|
||||
|
||||
Edit these in place under `~/.config/<app>`, then commit and push from that checkout.
|
||||
|
||||
### agent-root
|
||||
|
||||
`agent-root.toml` is the one `file` external: chezmoi downloads [jankeesvw/agent-root](https://github.com/jankeesvw/agent-root)'s single bash script to `~/.local/bin/agent-root` (mode `0755`) and re-fetches it at most once a week (`refreshPeriod = "168h"`). Coding agents run `agent-root "<why>" <command>` instead of `sudo`; it wraps `pkexec` (`polkit`) so the session's polkit agent shows the command, and `notify-send` (`libnotify`) shows the reason. Exit 126 means the dialog was dismissed. The usage rules agents follow live in the global omp instructions, `~/.omp/agent/AGENTS.md` ([prdlk/omp](https://github.com/prdlk/omp)). Linux desktop/laptop roles only ([role gate](#chezmoiignoretmpl)), since there is no polkit agent elsewhere.
|
||||
|
||||
**.chezmoiexternals/agent-root.toml**
|
||||
|
||||
```toml
|
||||
[".local/bin/agent-root"]
|
||||
type = "file"
|
||||
url = "https://raw.githubusercontent.com/jankeesvw/agent-root/main/agent-root"
|
||||
executable = true
|
||||
refreshPeriod = "168h"
|
||||
```
|
||||
|
||||
## Submodules
|
||||
|
||||
Two source directories are git submodules, listed in `.gitmodules`. They keep chezmoi source naming and are applied in symlink mode like the rest of the tree. `chezmoi init` clones them.
|
||||
|
||||
| Source | Target | Repo |
|
||||
| --- | --- | --- |
|
||||
| `dot_config/hypr` | `~/.config/hypr` | [prdlk/hypr](https://github.com/prdlk/hypr) |
|
||||
| `dot_config/fish` | `~/.config/fish` | [prdlk/fish](https://github.com/prdlk/fish) |
|
||||
|
||||
Edit them inside the submodule in the chezmoi source, commit there, then commit the updated submodule pointer in the root repo.
|
||||
|
||||
## .chezmoiignore.tmpl
|
||||
|
||||
Patterns match target paths (relative to `$HOME`). Matching entries are neither written nor removed. The file is a template, so the desktop block appears only on machines where it applies. Source entries that start with `.` (`.claude/`, `.gitignore`) are ignored by chezmoi without needing a rule.
|
||||
|
||||
### Repo docs
|
||||
|
||||
```txt
|
||||
README.md
|
||||
CLAUDE.md
|
||||
AGENTS.md
|
||||
docs
|
||||
```
|
||||
|
||||
Files at the source root that would otherwise land in `$HOME` as `~/README.md` or `~/docs`. This covers the repo README, the agent instruction files, and these docs.
|
||||
|
||||
### Compositor hook from the fish submodule
|
||||
|
||||
```txt
|
||||
.config/fish/auto-Niri.fish
|
||||
```
|
||||
|
||||
The shared fish submodule ships a compositor auto-start hook this repo never uses. It is ignored on every machine, outside the role gate.
|
||||
|
||||
### Runtime and plugin state inside managed trees
|
||||
|
||||
| Pattern | Why |
|
||||
| --- | --- |
|
||||
| `.config/lazygit/.omc/**` | Tool state written inside the lazygit config dir |
|
||||
| `.config/tmux/plugins/**`, except `!.config/tmux/plugins/tpm` | Plugins tpm installs with `prefix I`; tpm itself is the external above |
|
||||
| `.config/fish/fish_variables` | fish universal variables, rewritten by fish at runtime |
|
||||
| `.config/fish/conf.d/secrets.fish` | Plaintext credentials. Local-only, never in git (the fish repo's `.gitignore` also lists it) |
|
||||
| `.config/nvim/lazy-lock.json` | lazy.nvim lockfile inside the nvim external |
|
||||
| `.config/nvim/.git`, `.config/nvim/.git/**` | The external's git metadata |
|
||||
| `.config/nvim/.omc/**`, `.config/nvim/.crush/**`, `.config/nvim/.understand-anything/**` | Agent tool state inside the nvim checkout |
|
||||
|
||||
`.gitignore` covers the source side of the same problem: `dot_config/lazygit/dot_omc` and `__pycache__/` never get committed even though symlink mode lets tools write into the source tree.
|
||||
|
||||
### mise
|
||||
|
||||
```txt
|
||||
.config/mise
|
||||
.config/mise/**
|
||||
```
|
||||
|
||||
mise tool versions stay local to each machine and are not managed.
|
||||
|
||||
### Linux desktop layer (role-gated)
|
||||
|
||||
**.chezmoiignore.tmpl**
|
||||
|
||||
```txt
|
||||
{{ if or (ne .chezmoi.os "linux") (and (ne .role "desktop") (ne .role "laptop")) }}
|
||||
.config/hypr
|
||||
.config/hypr/**
|
||||
.config/waybar
|
||||
.config/waybar/**
|
||||
.config/uwsm
|
||||
.config/uwsm/**
|
||||
.local/bin/agent-root
|
||||
.config/fontconfig
|
||||
.config/fontconfig/**
|
||||
.config/mimeapps.list
|
||||
.config/xdg-terminals.list
|
||||
.config/systemd
|
||||
.config/systemd/**
|
||||
.local/bin/kitty-day-save
|
||||
.local/bin/cp-appid
|
||||
.local/bin/projects-sync
|
||||
{{ end }}
|
||||
```
|
||||
|
||||
The block is emitted, and these paths skipped, unless the OS is `linux` and the role is `desktop` or `laptop`. `server` machines, and any non-Linux machine regardless of role, never receive the Hyprland config (`dot_config/hypr/`), the Waybar config (`dot_config/waybar/`), the uwsm environment (`dot_config/uwsm/`), fontconfig (`dot_config/fontconfig/fonts.conf`), default-app associations (`dot_config/mimeapps.list`, `dot_config/xdg-terminals.list`), the systemd user units (`dot_config/systemd/user/kitty-day-save.service`, `projects-sync.service`, `projects-sync.timer`), or the `agent-root`, `cp-appid`, `kitty-day-save` and `projects-sync` scripts.
|
||||
|
||||
| Machine | Desktop layer |
|
||||
| --- | --- |
|
||||
| Linux, `desktop` or `laptop` | Applied |
|
||||
| Linux, `server` | Ignored |
|
||||
| Other OS, any role | Ignored |
|
||||
|
||||
See [Desktop](../desktop/README.md) for what the layer contains. The `omarchy-*` scripts in `dot_local/bin/` are not in the block, so they apply on every role.
|
||||
@@ -0,0 +1,146 @@
|
||||
# Apply scripts
|
||||
|
||||
Every run_ script chezmoi executes during apply, when each one fires, and what it does on each OS and role.
|
||||
|
||||
Seven scripts run during `chezmoi apply`. Five live in `.chezmoiscripts/`, a directory whose scripts run as if they sat at the source root without creating a matching target directory. Two sit at the repo root. All seven are templates; `20-gh-extensions` is a fish script, the rest use `#!/bin/sh` with `set -eu` (except `25-skills`, which uses `set -u`).
|
||||
|
||||
## Execution order
|
||||
|
||||
`before_` scripts run before any file is written; `after_` scripts run after every file, symlink, and external is in place. Within a phase chezmoi runs scripts in ASCII order of their target names, so the numeric prefixes come first.
|
||||
|
||||
1. **10-packages (before, onchange)**
|
||||
|
||||
Install system packages from `packages.yaml`.
|
||||
|
||||
2. **Files, symlinks, externals**
|
||||
|
||||
chezmoi writes the target state.
|
||||
|
||||
3. **15-tools (after, onchange)**
|
||||
|
||||
rustup and cargo crates, omp, global mise tools, strata on Linux desktops.
|
||||
|
||||
4. **20-gh-extensions (after, onchange)**
|
||||
|
||||
Install gh extensions from a fish session.
|
||||
|
||||
5. **25-skills (after, onchange)**
|
||||
|
||||
Install and prune agent skills.
|
||||
|
||||
6. **30-user-services (after, once)**
|
||||
|
||||
Enable systemd user units (kitty-day-save, projects-sync.timer).
|
||||
|
||||
7. **40-post (after, onchange)**
|
||||
|
||||
bat cache, font cache.
|
||||
|
||||
8. **build-bat-cache (after, onchange)**
|
||||
|
||||
Rebuild bat cache when its theme or config changes.
|
||||
|
||||
9. **install-yazi-plugins (after, onchange)**
|
||||
|
||||
Reinstall yazi plugins when the manifest changes.
|
||||
|
||||
| Script | Phase | Frequency | Re-run trigger |
|
||||
| --- | --- | --- | --- |
|
||||
| `.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl` | before | onchange | sha256 of `.chezmoidata/packages.yaml`; also the role and OS, which change the rendered package list |
|
||||
| `.chezmoiscripts/run_onchange_after_15-tools.sh.tmpl` | after | onchange | sha256 of `packages.shared.cargo` and `packages.shared.mise` as JSON; also the OS and role, which add the strata step |
|
||||
| `.chezmoiscripts/run_onchange_after_20-gh-extensions.sh.tmpl` | after | onchange | sha256 of `packages.shared.gh_extensions` as JSON |
|
||||
| `.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` | after | onchange | sha256 of `.skills` as JSON |
|
||||
| `.chezmoiscripts/run_once_after_30-user-services.sh.tmpl` | after | once | Runs once per distinct rendered content |
|
||||
| `.chezmoiscripts/run_onchange_after_40-post.sh.tmpl` | after | onchange | Edits to the script itself or an OS change |
|
||||
| `run_onchange_after_build-bat-cache.sh.tmpl` | after | onchange | sha256 of `dot_config/bat/themes/cyberdream.tmTheme` and `dot_config/bat/config` |
|
||||
| `run_onchange_after_install-yazi-plugins.sh.tmpl` | after | onchange | sha256 of `~/.config/yazi/package.toml` (empty when the file is absent) |
|
||||
|
||||
`run_onchange_` scripts re-run whenever their rendered content differs from the last successful run. The hash triggers work by writing a checksum of another file into a comment, so editing that file changes the script's content:
|
||||
|
||||
```sh
|
||||
# packages.yaml hash: {{ include ".chezmoidata/packages.yaml" | sha256sum }}
|
||||
```
|
||||
|
||||
`run_once_` scripts run once per unique rendered content and again only if that content changes or the previous run failed.
|
||||
|
||||
## 10-packages
|
||||
|
||||
`.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl` installs everything in [`packages.yaml`](data.md#packagesyaml). It runs before files are applied so the tools exist when configs land. On a non-Linux OS it renders to just the shebang and does nothing.
|
||||
|
||||
### Steps
|
||||
|
||||
1. Uses `pacman` directly when running as root, otherwise `sudo pacman`.
|
||||
2. `pacman -T` filters each list down to names no installed package provides (so `mise-bin` satisfies `mise`, `yazi-git` satisfies `yazi`), then `pacman -S --needed --noconfirm` installs the rest of `packages.arch.pacman`.
|
||||
3. For roles `desktop` and `laptop`, the same for `packages.arch.desktop.pacman`, and for `packages.arch.desktop.omarchy` when `pacman-conf -l` lists an `omarchy` repo.
|
||||
4. Builds the AUR list: `packages.arch.desktop.aur` plus `packages.arch.aur` for `desktop`/`laptop`, only `packages.arch.aur` for other roles, then drops every name `pacman -T` says is already provided. Desktop apps already installed from a sync repo (`[omarchy]`) are therefore neither rebuilt nor replaced.
|
||||
5. If anything is left and neither `yay` nor `paru` is installed, bootstraps `yay`: from a sync repo when `pacman -Si yay` finds one, otherwise by building `yay-bin` from the AUR with `makepkg -si` (installs `git` and `base-devel` first; skipped as root, since makepkg refuses root). Omarchy ships `yay`, so this is normally a no-op.
|
||||
6. Runs `yay -S --needed --noconfirm` on the remaining names, falling back to `paru`. yay prefers a sync repo over the AUR when both have the name. If no helper could be bootstrapped it prints `warning: no yay/paru and none could be bootstrapped — skipping AUR packages: …` and continues.
|
||||
|
||||
## 15-tools
|
||||
|
||||
`.chezmoiscripts/run_onchange_after_15-tools.sh.tmpl` installs the tools that do not come from pacman. It prepends `~/.cargo/bin` to `PATH`, since chezmoi's environment can predate the shell config that adds it. Any failing step aborts the script, so chezmoi keeps the old hash and retries on the next apply.
|
||||
|
||||
| Step | Condition | Action |
|
||||
| --- | --- | --- |
|
||||
| rustup | `cargo` not on `PATH` | `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \| sh -s -- -y --no-modify-path`. `-y` because there is no prompt under chezmoi; `--no-modify-path` because the shell rc files are symlinks into this repo and already source `~/.cargo/env` |
|
||||
| cargo crates | every OS | `cargo install --locked <crate>` for each `packages.shared.cargo` entry missing from `cargo install --list` |
|
||||
| mise tools | `mise` installed (warning otherwise) | `mise use -g <tools…>` for each `packages.shared.mise` entry absent from `mise ls --global --json`, then `mise install <tools…>`. A tool already in the global config keeps its pinned version. omp and opencode come from here |
|
||||
| old omp binary | `~/.local/bin/omp` is a regular file and `mise which omp` resolves | Deletes it: a copy from omp's own installer (`omp.sh/install`) sits ahead of mise's shims on `PATH` |
|
||||
| strata | Linux, roles `desktop`/`laptop`, no `~/.local/bin/strata` | `curl -fsSL https://raw.githubusercontent.com/lgse/strata/main/install.sh \| bash -s -- --with-desktop-entry --with-file-manager` |
|
||||
| strata file chooser | Linux, roles `desktop`/`laptop`, `~/.local/bin/strata` exists and `~/.local/share/xdg-desktop-portal/portals/strata.portal` does not | `strata --install-portal` |
|
||||
|
||||
The strata flags install the binary, `~/.local/share/applications/io.github.lgse.Strata.desktop`, and the `org.freedesktop.FileManager1` D-Bus service in `~/.local/share/dbus-1/services` ("Open file location" from other apps). The folder default (`inode/directory`) comes from the managed `~/.config/mimeapps.list` instead of `--with-folder-association`, because `xdg-mime default` would replace that symlink with a plain file. The installer's own dependency step runs `sudo -n pacman`, which fails without cached credentials, so its runtime packages are declared in `packages.arch.desktop.pacman` and are already present when it runs.
|
||||
|
||||
`strata --install-portal` makes strata the system file chooser for portal-aware apps (browsers, GTK file dialogs). It writes `strata.portal` and the `org.freedesktop.impl.portal.desktop.strata` D-Bus service under `~/.local/share`, prepends `strata;` to the `org.freedesktop.impl.portal.FileChooser` line of `~/.config/xdg-desktop-portal/<desktop>-portals.conf` (`hyprland-portals.conf`, copied from `/usr/share/xdg-desktop-portal/` when absent, so the compositor's backends stay as fallbacks), marks the in-app offer answered (`~/.config/strata/portal-opt-in-v1`), and restarts `xdg-desktop-portal.service`. That config file is strata's, not chezmoi's: `strata --uninstall-portal` restores it. Check: `gdbus call --session --dest org.freedesktop.impl.portal.desktop.strata --object-path /org/freedesktop/portal/desktop --method org.freedesktop.DBus.Properties.Get org.freedesktop.impl.portal.FileChooser version` prints `uint32 4`. Apps that draw their own picker instead of calling the portal are unchanged.
|
||||
|
||||
## 20-gh-extensions
|
||||
|
||||
`.chezmoiscripts/run_onchange_after_20-gh-extensions.sh.tmpl` installs each `packages.shared.gh_extensions` entry. It is a fish script (`#!/usr/bin/env fish`), so fish sources `~/.config/fish` first: `PATH` (mise, `~/.local/bin`, `~/.cargo/bin`) and `GITHUB_TOKEN` (from `gh auth token` in `conf.d/10-env.fish`) are those of a fish session. It runs after every file is applied and after [15-tools](#15-tools), so the fish config and `~/.cargo/env.fish` exist.
|
||||
|
||||
- Exits 0 with `warning: gh not installed — skipping extensions` if `gh` is missing.
|
||||
- Exits 0 with `warning: gh not authenticated — run 'gh auth login', then 'chezmoi apply' again` if `gh auth status` fails.
|
||||
- Reads `gh extension list`, then runs `gh extension install <repo>` only for extensions not already present.
|
||||
- Exits 1 listing the failed extensions if any install failed, so the next apply retries.
|
||||
|
||||
> [!WARNING]
|
||||
> A skipped run still exits 0, so chezmoi records this content as done and a plain re-apply does not retry it, despite what the warning text says. After `gh auth login`, either run `gh extension install` for each entry by hand, or clear chezmoi's onchange state with `chezmoi state delete-bucket --bucket=entryState` and apply again (this re-runs every `run_onchange_` script).
|
||||
|
||||
## 25-skills
|
||||
|
||||
`.chezmoiscripts/run_onchange_after_25-skills.sh.tmpl` installs the agent skills declared in [`skills.yaml`](data.md#skillsyaml) with the Skills CLI (`npx -y skills@1.7.0`). See [Skills](../ai/skills.md).
|
||||
|
||||
- Exits 0 with a warning if `npx` is missing.
|
||||
- One-time migration: deletes any directory in `~/.agents/skills` or `~/.claude/skills` that contains symlinks into the chezmoi source directory (the old vendored layout), and removes `~/.agents/.skill-lock.json` if it is a symlink into the source directory.
|
||||
- Removes skills listed in `${XDG_STATE_HOME:-~/.local/state}/chezmoi/skills.txt` that are no longer declared, with `skills remove -g -y`.
|
||||
- Runs one `skills add <source> -g -y -a <agents> --skill <names…>` per source entry. Output is captured; on failure the last 8 lines are printed.
|
||||
- Writes the declared names to `skills.txt`. Claude-only installs are not in the CLI's lock, so the script keeps its own record.
|
||||
- Exits 1 if any source failed, so chezmoi keeps the old hash and retries on the next apply.
|
||||
|
||||
## 30-user-services
|
||||
|
||||
`.chezmoiscripts/run_once_after_30-user-services.sh.tmpl` enables session-critical systemd user units on Linux.
|
||||
|
||||
- Same check for `~/.config/systemd/user/kitty-day-save.service` (from `dot_config/systemd/user/`, so Linux desktop/laptop roles only), then `systemctl --user enable --now kitty-day-save.service`. See [kitty-day-save](../shell/scripts.md#kitty-day-save).
|
||||
- Same check for `~/.config/systemd/user/projects-sync.timer`, then `systemctl --user enable --now projects-sync.timer`. See [projects-sync](../shell/scripts.md#projects-sync).
|
||||
- On non-Linux systems it renders to `#!/bin/sh` / `exit 0`.
|
||||
|
||||
Other personal automation units (brain-lens, omp-loop, rclone, hermes, voxtype) are deliberately not enabled; the script comment says to enable them by hand per machine. Their unit files are not in the repo, so they have to exist on the machine already.
|
||||
|
||||
## 40-post
|
||||
|
||||
`.chezmoiscripts/run_onchange_after_40-post.sh.tmpl` is post-apply housekeeping. It re-runs when the script is edited.
|
||||
|
||||
| Step | Condition | Action |
|
||||
| --- | --- | --- |
|
||||
| bat cache | `bat` installed | `bat cache --build` |
|
||||
| Font cache | Linux, `fc-cache` installed | `fc-cache -f` |
|
||||
|
||||
Each step ignores failures (`|| true`). tpm is cloned by [`.chezmoiexternal.toml`](externals-and-ignore.md#chezmoiexternaltoml), not here.
|
||||
|
||||
## build-bat-cache
|
||||
|
||||
`run_onchange_after_build-bat-cache.sh.tmpl` rebuilds bat's syntax and theme cache when the managed inputs change. It hashes `dot_config/bat/themes/cyberdream.tmTheme` and `dot_config/bat/config`, exits quietly if `bat` is missing, and otherwise runs `bat cache --build`. This registers the cyberdream theme and the PureScript syntax cloned by [`.chezmoiexternal.toml`](externals-and-ignore.md#chezmoiexternaltoml).
|
||||
|
||||
## install-yazi-plugins
|
||||
|
||||
`run_onchange_after_install-yazi-plugins.sh.tmpl` reinstalls yazi plugins whenever `~/.config/yazi/package.toml` changes (the template hashes it via `joinPath .chezmoi.homeDir`, guarded with `stat`). It exits quietly if `ya` is missing or `${XDG_CONFIG_HOME:-$HOME/.config}/yazi/package.toml` does not exist, and otherwise runs `ya pkg install`. If that fails, it deletes ya's clone cache (`${XDG_CACHE_HOME:-$HOME/.cache}/yazi/packages`), since clones made by an older ya can break a newer one, and retries once. `~/.config/yazi` is the [prdlk/yazi](https://github.com/prdlk/yazi) external checkout, so the plugins land in its `plugins/`, which that repo's `.gitignore` excludes apart from the vendored `bunny.yazi`. The plugin list is on the [yazi page](../tools/yazi.md).
|
||||
@@ -0,0 +1,30 @@
|
||||
# Desktop
|
||||
|
||||
The Linux desktop layer: Omarchy, the Hyprland config on top of it, the Waybar bar, fontconfig, and default applications.
|
||||
|
||||
> [!NOTE]
|
||||
> **Role gating**
|
||||
>
|
||||
> `.chezmoiignore.tmpl` skips the Linux desktop layer unless the machine runs Linux **and** its role is `desktop` or `laptop`. The gated targets are `~/.config/hypr`, `~/.config/waybar`, `~/.config/uwsm`, `~/.config/fontconfig`, `~/.config/mimeapps.list`, `~/.config/xdg-terminals.list`, `~/.config/systemd`, `~/.local/bin/agent-root`, `~/.local/bin/kitty-day-save`, `~/.local/bin/cp-appid`, and `~/.local/bin/projects-sync`. On the `server` role these are not applied.
|
||||
>
|
||||
> The `omarchy-*` scripts in `~/.local/bin` are **not** listed there, so chezmoi applies them on every role.
|
||||
|
||||
The desktop is [Omarchy](https://omarchy.org) (Arch Linux with Hyprland). Omarchy provides the compositor, the defaults, the theme, the menus, and the `omarchy-*` commands. This repo only overrides: a Hyprland Lua config (the `dot_config/hypr` submodule), a replacement Waybar layout, the `omarchy-*` helper scripts, the uwsm session environment, and the `~/.config/omarchy` external.
|
||||
|
||||
| Page | Covers |
|
||||
| --- | --- |
|
||||
| [Hyprland](hyprland.md) | `~/.config/hypr` Lua config on Omarchy: bindings, input, look and feel, monitors, hyprsunset, the portal; every `omarchy-*` script in `~/.local/bin`. `~/.config/omarchy` (shell, hooks, menus, themes) is the [prdlk/omarchy](https://github.com/prdlk/omarchy) external, see [externals](../chezmoi/externals-and-ignore.md#chezmoiexternals) |
|
||||
| [Waybar](waybar.md) | `~/.config/waybar`: module layout, stylesheet, the `window_pill.py` title module |
|
||||
| [Fonts and default apps](fonts-and-apps.md) | `~/.config/fontconfig/fonts.conf`, `~/.config/mimeapps.list`, the Victor Mono Nerd Font package |
|
||||
|
||||
## Packages
|
||||
|
||||
`.chezmoidata/packages.yaml` declares the desktop packages under `packages.arch.desktop`. `.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl` installs them only when the role is `desktop` or `laptop`:
|
||||
|
||||
| Source | Packages |
|
||||
| --- | --- |
|
||||
| pacman | `uwsm`, `xdg-user-dirs`, Wayland utilities (`wl-clipboard`, `cliphist`, `wtype`, `ydotool`, `grim`, `slurp`, `hyprpicker`, `pamixer`, `brightnessctl`, `libnotify`), the bound apps (`nautilus`, `imv`, `mpv`, `evince`, `chromium`, `obsidian`), and strata's runtime deps |
|
||||
| AUR via `yay` (a sync repo wins when it has the name) | `tldraw-offline-bin` and the desktop apps `beeper-bin`, `fastmail`, `1password`, `brave-origin-bin`, `claude-desktop`, `spotify` |
|
||||
| `[omarchy]` repo, when configured | `herdr`, `flea`, `voxtype-bin`, `xdg-terminal-exec`, `hyprland-preview-share-picker` |
|
||||
|
||||
AUR names that an installed package already provides are skipped; with no `yay` or `paru` the script bootstraps `yay` first. strata, the default file manager, comes from its own installer in [15-tools](../chezmoi/scripts.md#15-tools). Hyprland, Waybar, and the `omarchy-*` commands that the scripts call (`omarchy-menu`, `omarchy-launch-or-focus`, and others) come from the Omarchy install. This repo does not install them. See [chezmoi scripts](../chezmoi/scripts.md) for the full install flow and [packages.yaml](../chezmoi/data.md#packagesyaml) for the complete lists.
|
||||
@@ -0,0 +1,94 @@
|
||||
# Fonts and default apps
|
||||
|
||||
Fontconfig monospace override to Victor Mono Nerd Font, the Nerd Font packages, and the XDG default-application table.
|
||||
|
||||
Two small files set system-wide defaults: `fonts.conf` picks the monospace font, and `mimeapps.list` picks which application opens each file type and URL scheme.
|
||||
|
||||
> [!NOTE]
|
||||
> Linux `desktop` and `laptop` roles only. `.chezmoiignore.tmpl` skips `~/.config/fontconfig/**` and `~/.config/mimeapps.list` on other roles.
|
||||
|
||||
## Fontconfig
|
||||
|
||||
| Source (repo) | Target |
|
||||
| --- | --- |
|
||||
| `dot_config/fontconfig/fonts.conf` | `~/.config/fontconfig/fonts.conf` |
|
||||
|
||||
**~/.config/fontconfig/fonts.conf**
|
||||
|
||||
```xml
|
||||
<fontconfig>
|
||||
<match target="pattern">
|
||||
<test name="family" qual="any">
|
||||
<string>monospace</string>
|
||||
</test>
|
||||
<edit name="family" mode="prepend_first" binding="strong">
|
||||
<string>VictorMono Nerd Font</string>
|
||||
</edit>
|
||||
</match>
|
||||
</fontconfig>
|
||||
```
|
||||
|
||||
Any font request that includes the generic `monospace` family gets `VictorMono Nerd Font` added to the front of its family list (`prepend_first`) with strong binding. Apps that ask for "monospace" therefore render in Victor Mono with Nerd Font glyphs, and fall back through fontconfig's normal monospace list if a glyph is missing. The file does not configure sans/serif families, hinting, antialiasing, or subpixel rendering. Those stay at system defaults.
|
||||
|
||||
Some tools set their own fonts. Waybar uses `CaskaydiaCove Nerd Font Propo` (see [Waybar](waybar.md)), and the terminals set fonts in their own configs (see [kitty](../terminal/kitty.md)).
|
||||
|
||||
### Font packages
|
||||
|
||||
Victor Mono Nerd Font is installed on every role by `run_onchange_before_10-packages.sh.tmpl` from `.chezmoidata/packages.yaml`, not only on desktop roles. The package is `ttf-victor-mono-nerd` (pacman, `packages.arch.pacman`). `fonts.conf` is Linux desktop only, but the font package is also installed on `server`.
|
||||
|
||||
## Default applications
|
||||
|
||||
| Source (repo) | Target |
|
||||
| --- | --- |
|
||||
| `dot_config/mimeapps.list` | `~/.config/mimeapps.list` |
|
||||
|
||||
`mimeapps.list` is the XDG file that `xdg-open`, GTK/Qt file dialogs, and browsers use to choose a handler. `[Default Applications]` sets the preferred handler. `[Added Associations]` adds entries to "Open with" lists.
|
||||
|
||||
### Default applications
|
||||
|
||||
| Group | MIME types / schemes | Handler (`.desktop`) |
|
||||
| --- | --- | --- |
|
||||
| Text and scripts | `text/plain`, `text/x-shellscript`, `text/x-python`, `text/x-script.python` | `vim.desktop` |
|
||||
| Notes | `text/markdown`, `application/x-obsidian-canvas`, `application/x-obsidian-base`, `x-scheme-handler/obsidian` | `obsidian.desktop` (`obsidian` from `packages.arch.desktop.pacman`) |
|
||||
| Web pages | `text/html`, `application/xhtml+xml`, `application/x-extension-htm`, `-html`, `-shtml`, `-xhtml`, `-xht` | `brave-origin.desktop` |
|
||||
| Web links | `x-scheme-handler/http`, `https`, `chrome` | `brave-origin.desktop` |
|
||||
| Browser internals | `x-scheme-handler/about`, `unknown` | `chromium.desktop` |
|
||||
| PDF | `application/pdf` | `brave-origin.desktop` |
|
||||
| Directories | `inode/directory` | `io.github.lgse.Strata.desktop` ([strata](../chezmoi/scripts.md#15-tools), which also registers the `org.freedesktop.FileManager1` service for "Open file location" and serves the portal file chooser) |
|
||||
| Mail | `x-scheme-handler/mailto` | `omamail.desktop` |
|
||||
| Windows executables | `application/vnd.microsoft.portable-executable` | `wine.desktop` |
|
||||
| AI tools | `x-scheme-handler/claude` | `com.anthropic.Claude.desktop` |
|
||||
| | `x-scheme-handler/claude-cli` | `claude-code-url-handler.desktop` |
|
||||
| | `x-scheme-handler/opencode` | `ai.opencode.desktop.desktop` |
|
||||
| | `x-scheme-handler/antigravity` | `antigravity.desktop` |
|
||||
| | `x-scheme-handler/piebald` | `piebald-handler.desktop` |
|
||||
| | `x-scheme-handler/openhuman` | `OpenHuman-handler.desktop` |
|
||||
| Productivity | `x-scheme-handler/todoist`, `com.todoist` | `todoist.desktop` |
|
||||
| | `x-scheme-handler/notion` | `notion.desktop` |
|
||||
| | `x-scheme-handler/anytype` | `anytype.desktop` |
|
||||
| | `x-scheme-handler/tolaria` | `tolaria-handler.desktop` |
|
||||
| | `x-scheme-handler/tldraw-offline` | `tldraw-offline.desktop` |
|
||||
| | `x-scheme-handler/figma` | `figma-linux.desktop` |
|
||||
| Chat | `x-scheme-handler/slack` | `slack.desktop` |
|
||||
| | `x-scheme-handler/discord-647066573147996160` | `discord-647066573147996161.desktop` |
|
||||
| Feeds | `x-scheme-handler/follow`, `folo` | `folo.desktop` |
|
||||
|
||||
### Added associations
|
||||
|
||||
| MIME types / schemes | Also offered |
|
||||
| --- | --- |
|
||||
| `http`, `https`, `chrome` schemes; `text/html`, `application/xhtml+xml`, and the `x-extension-*` web types | `brave-origin.desktop`, `userapp-Floorp-8MTFP3.desktop` |
|
||||
| `x-scheme-handler/mailto` | `userapp-Evolution-PCEYQ4.desktop` |
|
||||
| `application/vnd.microsoft.portable-executable` | `wine.desktop` |
|
||||
| `application/pdf` | `brave-origin.desktop` |
|
||||
| `x-scheme-handler/opencode` | `ai.opencode.desktop.desktop` |
|
||||
|
||||
The added mail association is Evolution, but the default mail handler is `omamail.desktop`.
|
||||
|
||||
> [!TIP]
|
||||
> In symlink mode, `~/.config/mimeapps.list` is a symlink into the repo. When `xdg-mime default` or a "set as default" dialog updates it, the tool either writes through the symlink and edits the repo file directly, or replaces the symlink with a regular file. Check `git status` or `chezmoi status` after changing defaults.
|
||||
|
||||
## Related
|
||||
|
||||
- [Hyprland](hyprland.md): the compositor these defaults serve.
|
||||
- [Installation](../installation.md): role selection that decides whether this layer applies.
|
||||
@@ -0,0 +1,384 @@
|
||||
# Hyprland
|
||||
|
||||
Hyprland Lua config layered on Omarchy — master layout, terminal-only blur, monitors, and the omarchy-* helper scripts.
|
||||
|
||||
[Hyprland](https://hypr.land) is a dynamic tiling Wayland compositor. This config uses Hyprland's Lua configuration and sits on top of [Omarchy](https://omarchy.org), which provides the defaults, theme, menus, and `omarchy-*` commands. The files here only override.
|
||||
|
||||
> [!NOTE]
|
||||
> Linux `desktop` and `laptop` roles only. `.chezmoiignore.tmpl` skips `~/.config/hypr/**` on other roles. The `omarchy-*` scripts are **not** listed there, so chezmoi applies them on every role and OS; they only take effect where Omarchy is installed.
|
||||
>
|
||||
> `dot_config/hypr` is a git submodule ([prdlk/hypr](https://github.com/prdlk/hypr)). Edit inside the submodule, commit there, then commit the updated pointer in the chezmoi repo.
|
||||
|
||||
## Files
|
||||
|
||||
| Source (repo) | Target | Purpose |
|
||||
| --- | --- | --- |
|
||||
| `dot_config/hypr/hyprland.lua` | `~/.config/hypr/hyprland.lua` | Entry point, workspace and window rules |
|
||||
| `dot_config/hypr/autostart.lua` | `~/.config/hypr/autostart.lua` | Extra autostart (empty) |
|
||||
| `dot_config/hypr/bindings.lua` | `~/.config/hypr/bindings.lua` | Keybindings |
|
||||
| `dot_config/hypr/input.lua` | `~/.config/hypr/input.lua` | Key repeat, tablet/touch mapping |
|
||||
| `dot_config/hypr/looknfeel.lua` | `~/.config/hypr/looknfeel.lua` | Layout, decoration, blur |
|
||||
| `dot_config/hypr/monitors.lua` | `~/.config/hypr/monitors.lua` | Monitor modes and positions |
|
||||
| `dot_config/hypr/hyprsunset.conf` | `~/.config/hypr/hyprsunset.conf` | Night-light profile |
|
||||
| `dot_config/hypr/xdph.conf` | `~/.config/hypr/xdph.conf` | xdg-desktop-portal-hyprland |
|
||||
| `dot_config/hypr/dot_luarc.json` | `~/.config/hypr/.luarc.json` | Lua language server settings |
|
||||
| `dot_local/bin/executable_omarchy-*` | `~/.local/bin/omarchy-*` | Helper scripts (see [below](#omarchy-scripts)) |
|
||||
|
||||
None are templates. Hyprland and Omarchy are not in `.chezmoidata/packages.yaml`. They come from the Omarchy install.
|
||||
|
||||
## Entry point
|
||||
|
||||
`hyprland.lua` loads Omarchy, then the personal files, then Omarchy's toggles:
|
||||
|
||||
**~/.config/hypr/hyprland.lua**
|
||||
|
||||
```lua
|
||||
dofile((os.getenv("OMARCHY_PATH") or "/usr/share/omarchy") .. "/default/hypr/bootstrap.lua")
|
||||
require("default.hypr.omarchy")
|
||||
|
||||
require("hypr.monitors")
|
||||
require("hypr.input")
|
||||
require("hypr.bindings")
|
||||
require("hypr.looknfeel")
|
||||
require("hypr.autostart")
|
||||
|
||||
require("default.hypr.toggles")
|
||||
```
|
||||
|
||||
Omarchy's default bindings stay enabled. `omarchy_default_bindings` and `omarchy_preinstalled_bindings` are left commented. `bindings.lua` unbinds each default it replaces.
|
||||
|
||||
### Workspace rules
|
||||
|
||||
| Workspace | Monitor |
|
||||
| --- | --- |
|
||||
| 1 (default), 2, 3, 4 | The main external display: `desc:Apple Computer Inc StudioDisplay 0x984262A7` if connected, else `desc:Samsung Electric Company S34CG50 HNTY501103` (Studio Display while neither is). Chosen at config load; `monitors.lua` reloads the config when the main external changes, and existing workspaces 1–4 are moved over |
|
||||
| 5 (default), 6, 7, 8 | `eDP-1` |
|
||||
|
||||
`default` marks the workspace each monitor shows when it connects.
|
||||
|
||||
### Window rules
|
||||
|
||||
| Class | Rule |
|
||||
| --- | --- |
|
||||
| `^brave-www\.tldraw\.com__-Default$` | Workspace 3 |
|
||||
| `^tldraw-offline$` | Workspace 5, fullscreen |
|
||||
| `^so\.stencil\.tern$` | `special:scratchpad silent` |
|
||||
| `^com\.anthropic\.Claude$` | `special:claude silent` |
|
||||
| `^com\.fastmail\.Fastmail$` | `special:fastmail silent` |
|
||||
| `^Beeper$` | `special:beeper silent` |
|
||||
| `^brave-home\.google\.com__.*` | `special:home silent` |
|
||||
| `^ai\.elementlabs\.lmstudio$` | `special:lmstudio silent` |
|
||||
| `brave-(www\.)?youtube\.com__.*`, title not matching `.*Picture.?in.?[Pp]icture.*` | Float, pin, size 30% × 30% of the monitor, move to `10, monitor_h*0.7-10` (bottom-left corner) |
|
||||
|
||||
Scratch residents are placed `silent` so that [`omarchy-toggle-scratch`](#omarchy-toggle-scratch) decides when to reveal them. The YouTube rule matches both `youtube.com` and `www.youtube.com` because Chromium's class changes once a video plays. It excludes the picture-in-picture overlay so Omarchy's own PiP rule still applies. Its size and inset must stay in sync with [`omarchy-pip`](#omarchy-pip).
|
||||
|
||||
## Input
|
||||
|
||||
`input.lua`:
|
||||
|
||||
- `repeat_delay = 250` (Omarchy's value), `repeat_rate = 50` (raised from 40). The file's comments record that 200/50 felt too fast. The typing lag it was meant to fix came from the keyboard's firmware tap-hold handling and was fixed on the keyboard itself.
|
||||
- Tablet and touch devices are pinned to one output each:
|
||||
|
||||
| Device | Output | Extra |
|
||||
| --- | --- | --- |
|
||||
| `elan9008:00-04f3:43c7-stylus` (Flow Z13 pen) | `eDP-1` | |
|
||||
| `elan9008:00-04f3:43c7` (Flow Z13 touchscreen) | `eDP-1` | Taps land on the panel instead of the focused monitor |
|
||||
| `wacom-intuos-bt-s-pen` | The main external display (Studio Display or Samsung ultrawide) | `active_area_size = { 152, 152 × height / width }` (85.5 on the Studio Display, 63.6 on the ultrawide), `active_area_position = { 0, 0 }` — a full-width band with the display's aspect ratio |
|
||||
|
||||
The layout, touchpad, and gesture examples in the file are commented out. Palm rejection is done by a libinput quirks file in `/etc`, which chezmoi does not manage.
|
||||
|
||||
## Look and feel
|
||||
|
||||
`looknfeel.lua` loads after the Omarchy theme's `hyprland.lua`, so its values override the theme's. The theme sets colors. This file sets everything else. The approach is flat windows by default, with blur only behind terminals.
|
||||
|
||||
| Setting | Value |
|
||||
| --- | --- |
|
||||
| `general.layout` | `master` (instead of Omarchy's dwindle; per-workspace layouts saved by `omarchy-hyprland-workspace-layout-toggle` still win) |
|
||||
| `decoration.rounding` | 0 |
|
||||
| `decoration.dim_special` | 0.33 (darkens the desktop behind any open scratch workspace) |
|
||||
| `decoration.blur` | enabled; `size 5`, `passes 2`, `brightness 0.8`, `contrast 1.1`, `vibrancy 0.15`, `noise 0.01`, `new_optimizations`, `popups = false` |
|
||||
| `decoration.shadow` | disabled |
|
||||
| `group.groupbar.gradient_rounding` | 0 |
|
||||
| Workspace animation | disabled (`hl.animation({ leaf = "workspaces", enabled = false })`) |
|
||||
|
||||
Blur must be enabled globally before any window can use it, so every window tagged `default-opacity` gets `no_blur = true`, and terminals get it back:
|
||||
|
||||
**~/.config/hypr/looknfeel.lua**
|
||||
|
||||
```lua
|
||||
o.window({ tag = "default-opacity" }, { no_blur = true })
|
||||
o.window(
|
||||
"^(kitty(-.*)?|Alacritty|com\\.mitchellh\\.ghostty|foot|org\\.codeberg\\.dnkl\\.foot|wezterm)$",
|
||||
{ no_blur = false }
|
||||
)
|
||||
```
|
||||
|
||||
Omarchy's stock fade (0.985 active / 0.96 inactive) is kept. Terminals get their transparency from kitty's `background_opacity 0.9` (see [kitty](../terminal/kitty.md)). The comments give the reason for limiting blur: the cyberdream and Spectra themes enabled rounding, blur, and shadow on every window, and that costs frame time on an iGPU driving the laptop panel plus a 5K display.
|
||||
|
||||
## Monitors
|
||||
|
||||
`monitors.lua`:
|
||||
|
||||
| Output | Mode | Position | Scale |
|
||||
| --- | --- | --- | --- |
|
||||
| any (fallback) | `preferred` | `auto` | 3.2 |
|
||||
| `eDP-1` (laptop) | `2560x1600@180` | `auto-right` | 2 |
|
||||
| `DP-4` (Apple Studio Display) | `5120x2880@60` | `0x0` | 2 |
|
||||
| `desc:Samsung Electric Company S34CG50 HNTY501103` (ultrawide, USB-C to HDMI from the iGPU; shows up as a `DP-n` connector) | `3440x1440@100` | `0x0` | 1 |
|
||||
|
||||
`GDK_SCALE=3` is exported. The external display sits left of the laptop panel; `auto-right` puts `eDP-1` at its logical width (2560 for the Studio Display, 3440 for the ultrawide), or at 0 when undocked. `monitors.lua` returns the "main external display" (Studio Display, else Samsung ultrawide) used by the workspace rules, the Wacom mapping, and `omarchy-toggle-scratch`, and reloads the config on hotplug when it changes.
|
||||
|
||||
`~/.config/uwsm/env-hyprland` (source `dot_config/uwsm/env-hyprland`, Linux desktop/laptop only) is sourced by uwsm before Hyprland starts. It sets `AQ_DRM_DEVICES` to the AMD iGPU, resolved from `/dev/dri/by-path/pci-0000:c4:00.0-card`, so Hyprland never opens the Thunderbolt eGPU (RTX 5060 Ti, compute only: AI models, CUDA). Every display, the Samsung ultrawide included, hangs off the iGPU. It leaves the variable unset if that path is missing. It also sets `__EGL_VENDOR_LIBRARY_FILENAMES` to Mesa's `50_mesa.json`, so neither Hyprland nor session apps load `libEGL_nvidia` and hold `/dev/nvidiactl`; CUDA does not use EGL.
|
||||
|
||||
The system side (kernel cmdline, `nvidia` without KMS, `thunderbolt host_reset=0`) lives outside chezmoi.
|
||||
|
||||
## hyprsunset and portal
|
||||
|
||||
**~/.config/hypr/hyprsunset.conf**
|
||||
|
||||
```ini
|
||||
profile {
|
||||
time = 07:00
|
||||
identity = true
|
||||
}
|
||||
```
|
||||
|
||||
The identity profile stops hyprsunset from tinting the screen. A commented 20:00 / 4000 K night profile and an `o.launch_on_start("hyprsunset")` hint remain in the file.
|
||||
|
||||
**~/.config/hypr/xdph.conf**
|
||||
|
||||
```ini
|
||||
screencopy {
|
||||
allow_token_by_default = true
|
||||
custom_picker_binary = hyprland-preview-share-picker
|
||||
}
|
||||
```
|
||||
|
||||
Screen-share requests get a restore token by default and use `hyprland-preview-share-picker` as the source picker.
|
||||
|
||||
## .luarc.json
|
||||
|
||||
Configures lua-language-server for the Lua config: the library path is `/usr/share/hypr/stubs`, `checkThirdParty` is off, and `hl` and `o` are declared as globals.
|
||||
|
||||
`autostart.lua` contains only a commented `o.launch_on_start` example.
|
||||
|
||||
## Keybindings
|
||||
|
||||
Every binding defined in `bindings.lua`. Bindings not listed here are Omarchy defaults. The *Replaces* column gives the Omarchy default that was unbound first.
|
||||
|
||||
### Windows
|
||||
|
||||
| Keys | Action | Replaces |
|
||||
| --- | --- | --- |
|
||||
| `SUPER + Q` | Close window | same (made explicit) |
|
||||
| `SUPER + W` | `omarchy-toggle-layout` — flip workspace layout | close window |
|
||||
| `SUPER + BACKSPACE` | Focus last window | toggle transparency |
|
||||
| `SUPER + TAB` | Next window in the active workspace | next workspace |
|
||||
| `SUPER + SHIFT + TAB` | Previous window in the active workspace | previous workspace |
|
||||
| `SUPER + H` / `J` / `K` / `L` | Focus left / down / up / right | `J`: toggle split, `K`: keybindings menu, `L`: toggle layout |
|
||||
| `SUPER + D` | Toggle split (dwindle `togglesplit`) | — |
|
||||
| `SUPER + SHIFT + H` | `omarchy-smart-move l` — move/merge left; floating: bottom-left corner | — |
|
||||
| `SUPER + SHIFT + J` | `omarchy-smart-move d` — move/merge down; floating: top-left | — |
|
||||
| `SUPER + SHIFT + K` | `omarchy-smart-move u` — move/merge up; floating: top-right | — |
|
||||
| `SUPER + SHIFT + L` | `omarchy-smart-move r` — move/merge right; floating: bottom-right | — |
|
||||
| `SUPER + SHIFT + T` | `omarchy-pip` — toggle picture-in-picture | — |
|
||||
|
||||
`SUPER + TAB` walks a ring built only from the active workspace's mapped windows, ordered by `stable_id`. Grouped windows stay in the ring and hidden ones are skipped. It raises the focused window afterwards. It avoids `cyclenext`, which would pull in a hidden scratchpad. `binds.movefocus_cycles_groupfirst = true` makes `hjkl` focus step through a group's tabs before leaving the group.
|
||||
|
||||
### Workspaces and monitors
|
||||
|
||||
| Keys | Action | Replaces |
|
||||
| --- | --- | --- |
|
||||
| `SUPER + CTRL + J` | Next workspace (`e+1`) | — |
|
||||
| `SUPER + CTRL + K` | Previous workspace (`e-1`) | Herdr keybindings |
|
||||
| `ALT + Q` / `W` / `E` / `R` | Switch to workspace 1 / 2 / 3 / 4 (main external display) | — |
|
||||
| `ALT + Y` / `U` / `I` / `O` | Switch to workspace 5 / 6 / 7 / 8 (laptop panel) | — |
|
||||
| `ALT + SHIFT + Q` / `W` / `E` / `R` / `Y` / `U` / `I` / `O` | Move window to workspace 1–8 | — |
|
||||
| `SUPER + CTRL + S` | `omarchy-toggle-scratch scratchpad` | share menu |
|
||||
| `SUPER + A` | `omarchy-toggle-scratch scratchpad` (Tern) | — |
|
||||
| `SUPER + O`, `SUPER + SHIFT + O` | Unbound | pop window out, Obsidian |
|
||||
| `ALT + SHIFT + J` | Move window to next monitor | — |
|
||||
| `ALT + SHIFT + K` | Move window to previous monitor | — |
|
||||
| `SUPER + SHIFT + CTRL + ALT + W` | Workspace `name:w` | — |
|
||||
| `SUPER + SHIFT + CTRL + ALT + H` | Workspace `name:h` | — |
|
||||
| `SUPER + CTRL + ALT + X` | Workspace `name:x` | — |
|
||||
|
||||
Named workspaces provide the per-app workspaces. `SUPER + ALT + S` (send to scratchpad) keeps its Omarchy default.
|
||||
|
||||
### Sizing
|
||||
|
||||
| Keys | Action |
|
||||
| --- | --- |
|
||||
| `SUPER + R` | `omarchy-cycle-window-size` — next preset size |
|
||||
| `SUPER + SHIFT + R` | `omarchy-cycle-window-size prev` |
|
||||
| `ALT + SHIFT + H` / `SUPER + ,` | Width −100 px |
|
||||
| `ALT + SHIFT + L` / `SUPER + .` | Width +100 px |
|
||||
| `SUPER + CTRL + K` | Height −100 px |
|
||||
| `SUPER + CTRL + J` | Height +100 px |
|
||||
| `SUPER + ALT + C` | Fit active column (scrolling layout only) |
|
||||
| `SUPER + SHIFT + ALT + C` | Fit visible columns (scrolling layout only) |
|
||||
|
||||
### Applications
|
||||
|
||||
| Keys | Action | Replaces |
|
||||
| --- | --- | --- |
|
||||
| `SUPER + CTRL + A` | Claude: `omarchy-launch-or-focus claude "gtk-launch com.anthropic.Claude"` | audio panel |
|
||||
| `SUPER + CTRL + G` | Gemini: `omarchy-launch-or-focus gemini "gtk-launch gemini-desktop"` | — |
|
||||
| `SUPER + CTRL + ALT + H` | `omarchy-cycle ai` | — |
|
||||
| `SUPER + CTRL + ALT + J` | `omarchy-cycle-terminal` | — |
|
||||
| `SUPER + CTRL + ALT + K` | `omarchy-cycle-browser` | — |
|
||||
| `SUPER + CTRL + ALT + G` | `omarchy-cycle ghostty` | — |
|
||||
| `SUPER + CTRL + ALT + O` | `omarchy-cycle obsidian` | — |
|
||||
| `SUPER + CTRL + ALT + F` | strata: `omarchy-launch-or-focus io.github.lgse.Strata "gtk-launch io.github.lgse.Strata"` | — |
|
||||
| `SUPER + CTRL + ALT + E` | `omarchy-toggle-scratch fastmail` | — |
|
||||
| `SUPER + CTRL + ALT + M` | `omarchy-toggle-scratch beeper` | — |
|
||||
| `SUPER + CTRL + L` | `omarchy-toggle-scratch lmstudio` (LM Studio) | toggle window gaps |
|
||||
| `SUPER + CTRL + ALT + Y` | `omarchy-summon youtube` | web apps cycle |
|
||||
| `SUPER + SHIFT + Y` | `omarchy-summon youtube` | YouTube desktop entry |
|
||||
| `SUPER + CTRL + ALT + T` | tldraw offline: `omarchy-launch-or-focus tldraw-offline "gtk-launch tldraw-offline"` | show time |
|
||||
| `SUPER + CTRL + ALT + W` | tldraw: `omarchy-launch-or-focus tldraw "gtk-launch TLDraw"` | toggle weather |
|
||||
| `SUPER + CTRL + ALT + SPACE` | Sticky Notes Canvas via `gtk-launch io.github.faridjaff.StickyNotesCanvas` | — |
|
||||
| `SUPER + SHIFT + G` | Goliath: `kitty --class=kitty-goliath --title=goliath --config ~/.config/kitty/goliath.conf` | Signal |
|
||||
| `SUPER + ALT + SHIFT + F` | `uwsm-app -- "$HOME/.local/bin/strata" "$(omarchy-cmd-terminal-cwd)"` — strata in the terminal's cwd | unbound first (default unnamed) |
|
||||
|
||||
strata is the default file manager: `inode/directory` in `mimeapps.list` and the `org.freedesktop.FileManager1` D-Bus service both point at it ([15-tools](../chezmoi/scripts.md#15-tools)). The cwd bind uses the absolute path because `~/.local/bin` may be missing from uwsm-app's `PATH`. Omarchy's own file-manager bind on `SUPER + SHIFT + F` is replaced by full screen (below). A rule tagging `com.thisisgm.flea.picker` as `+floating-window` still sits between `flea --picker` marker comments, which the `flea` tool writes and removes itself.
|
||||
|
||||
### Screenshots, session, menus
|
||||
|
||||
| Keys | Action | Replaces |
|
||||
| --- | --- | --- |
|
||||
| `SUPER + S` | `omarchy-capture-screenshot region` | toggle scratchpad |
|
||||
| `SUPER + SHIFT + S` | `omarchy-capture-screenshot windows` | Google Maps |
|
||||
| `SUPER + SHIFT + ALT + S` | `omarchy-capture-screenshot fullscreen` | — |
|
||||
| `SUPER + SHIFT + E` | `omarchy-menu toggle system` | Email |
|
||||
| `SUPER + SHIFT + Q` | `omarchy-menu toggle system` | — |
|
||||
| `SUPER + F24` | `voxtype record toggle --profile hermes` — dictation | — |
|
||||
| `SUPER + SHIFT + SPACE` | Emoji picker (`omarchy-shell shell toggle omarchy.emojis`) | toggle top bar |
|
||||
| `SUPER + P` | Clipboard manager (`omarchy-shell shell toggle omarchy.clipboard`) | pseudo window |
|
||||
| `ALT + TAB` | ScrollOverview `toggle all` (only when the plugin is loaded) | Omarchy's two `ALT + TAB` binds |
|
||||
|
||||
`SUPER + SPACE` (Omarchy menu) and `SUPER + ALT + SPACE` (apps menu) keep their Omarchy defaults. `SUPER + RETURN` (terminal) and `SUPER + SHIFT + RETURN` (browser) are unbound; terminals and browsers live on `SUPER + CTRL + ALT + J` / `K`.
|
||||
|
||||
### ScrollOverview plugin
|
||||
|
||||
When `hl.plugin.scrolloverview` is present, `bindings.lua` configures it:
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `gesture_distance` | 300 |
|
||||
| `scale` | 0.5 |
|
||||
| `workspace_gap` | 100 |
|
||||
| `layout` | `vertical` |
|
||||
| `wallpaper` | 2 (global and per-workspace) |
|
||||
| `blur` | true |
|
||||
| `shadow` | enabled, range 50 |
|
||||
|
||||
## omarchy scripts
|
||||
|
||||
The scripts live in `dot_local/bin/` as `executable_omarchy-*` and deploy to `~/.local/bin/`. Each one calls the Lua dispatcher first (`hyprctl dispatch "hl.dsp…"`) and falls back to the classic dispatcher name on older Hyprland.
|
||||
|
||||
### omarchy-cycle
|
||||
|
||||
```sh
|
||||
omarchy-cycle <app|browser|brave|terminal|ai|ghostty|kitty|kitty-CLASS|webapp|webapp-NAME>
|
||||
```
|
||||
|
||||
Focuses an app's window, cycles to the next one on repeated presses, or launches the app when none is open. Windows are matched on `class` or `initialClass` (case-insensitive) and sorted by workspace, then address. If the focused window is not in the set, focus goes to the first one. Launches use `setsid uwsm-app --`.
|
||||
|
||||
| Argument | Matches | Launches when none |
|
||||
| --- | --- | --- |
|
||||
| `webapp` | `^(webapp-\|chrome-)` | re-runs as `webapp-youtube` |
|
||||
| `webapp-NAME` | `webapp-NAME` or `^chrome-.*NAME` | `gtk-launch` on the first `WebApp-NAME*.desktop` or `*NAME*.desktop` in `~/.local/share/applications` |
|
||||
| `kitty` | `^kitty` | `kitty` |
|
||||
| `kitty-CLASS` | `^kitty-CLASS$` | `kitty --class kitty-CLASS` (command from the empty `KITTY_CMDS` map, if set) |
|
||||
| `ghostty` | `ghostty` | `ghostty` |
|
||||
| `browser` | zen, brave, chromium, google-chrome, firefox, librewolf, vivaldi, microsoft-edge, helium — excluding `chrome-`/`webapp-` web apps | `omarchy-launch-browser` |
|
||||
| `brave` | `^brave` (Brave Origin and its web apps) | `omarchy-launch-browser` |
|
||||
| `terminal` | kitty, alacritty, ghostty, foot, wezterm (Tern, the scratchpad terminal, does not match) | `omarchy-launch-terminal` (`xdg-terminal-exec`: the OS default terminal from `~/.config/xdg-terminals.list`, in the focused terminal's cwd) |
|
||||
| `ai` | `claude\|hermes` | `hermes desktop` |
|
||||
| anything else | `^APP$` | the argument as a command |
|
||||
|
||||
Bound to `SUPER + CTRL + ALT + H` (`ai`), `G` (`ghostty`), and `O` (`obsidian`).
|
||||
|
||||
### omarchy-cycle-browser / omarchy-cycle-terminal
|
||||
|
||||
One-line wrappers: `omarchy-cycle brave` and `omarchy-cycle terminal`. Bound to `SUPER + CTRL + ALT + K` and `SUPER + CTRL + ALT + J`.
|
||||
|
||||
### omarchy-launch-browser
|
||||
|
||||
```sh
|
||||
omarchy-launch-browser [--private] [url]
|
||||
```
|
||||
|
||||
Shadows Omarchy's `/usr/bin/omarchy-launch-browser` (`~/.local/bin` comes first on `PATH`) and hands off to it. When Brave Origin is the default browser and not running, it prepends `--restore-last-session --hide-crash-restore-bubble`, so the first launch after a reboot or power-off reopens the last session's windows without the "Restore pages?" prompt. Chromium treats a killed browser as crashed and skips the restore; `--hide-crash-restore-bubble` clears that state. Private launches and launches into a running browser pass through unchanged.
|
||||
|
||||
### omarchy-cycle-window-size
|
||||
|
||||
```sh
|
||||
omarchy-cycle-window-size [next|prev]
|
||||
```
|
||||
|
||||
Steps the focused window through preset widths `0.333, 0.5, 0.667` of the monitor.
|
||||
|
||||
- **Scrolling layout (tiled):** sends `colresize +conf` / `-conf`, so the layout's own preset list is used.
|
||||
- **Floating:** resizes to the fraction × monitor width and 0.8 × monitor height, then centers. The index is stored per window.
|
||||
- **Dwindle/master (tiled):** sets `splitratio` to `2 × fraction`, mirrored when the window is on the right or bottom half, clamped to 0.1–1.9. The index is stored per workspace.
|
||||
|
||||
Indices are stored in `$XDG_STATE_HOME/omarchy/window-sizes/`. Bound to `SUPER + R` and `SUPER + SHIFT + R`.
|
||||
|
||||
### omarchy-pip
|
||||
|
||||
```sh
|
||||
omarchy-pip [toggle|on] [address:0x...]
|
||||
```
|
||||
|
||||
Picture-in-picture for any window. Floats and pins it, resizes it to 30% of the focused monitor on both axes, and places it in the bottom-left corner with a 10 px inset (matching `general:gaps_out`). `toggle` (the default) unpins and re-tiles a window that is already floating and pinned. `on` always applies the fit. Defaults to the active window. The dispatcher is called with `on`/`off` because `set` toggles on Hyprland 0.56. Bound to `SUPER + SHIFT + T`. `omarchy-summon` also calls it.
|
||||
|
||||
### omarchy-smart-move
|
||||
|
||||
```sh
|
||||
omarchy-smart-move <l|r|u|d>
|
||||
```
|
||||
|
||||
- **Tiled:** finds the nearest tiled, visible window in that direction that overlaps on the other axis. If that neighbor, or the focused window, is in a group, it runs a group-aware move (`movewindoworgroup`), which merges into or leaves a group. Otherwise it swaps with the neighbor.
|
||||
- **Floating:** moves the window to a corner of its monitor without resizing, inside the reserved area (the bar) and inset 10 px. Corners go clockwise from bottom-left: `l` bottom-left, `d` top-left, `u` top-right, `r` bottom-right.
|
||||
|
||||
Bound to `SUPER + SHIFT + H/J/K/L`.
|
||||
|
||||
### omarchy-summon
|
||||
|
||||
```sh
|
||||
omarchy-summon [youtube]
|
||||
```
|
||||
|
||||
The only profile is `youtube`, which matches class `^brave-(www\.)?youtube\.com__.*$` and skips Picture-in-Picture titles. With no window open, it runs `gtk-launch YouTube`, and the window rule in `hyprland.lua` floats and positions it. With a window open, it moves the window to the focused monitor, runs `omarchy-pip on` to refit it (the two panels differ in logical size), and focuses it. Bound to `SUPER + CTRL + ALT + Y` and `SUPER + SHIFT + Y`.
|
||||
|
||||
### omarchy-toggle-layout
|
||||
|
||||
```sh
|
||||
omarchy-toggle-layout [width]
|
||||
```
|
||||
|
||||
Runs `omarchy-hyprland-workspace-layout-toggle`, then polls the workspace layout (6 × 50 ms). If it became `scrolling`, it runs `colresize all <width>` (default `0.75`). Dwindle needs no widths. Bound to `SUPER + W`.
|
||||
|
||||
### omarchy-toggle-scratch
|
||||
|
||||
```sh
|
||||
omarchy-toggle-scratch [scratchpad|claude|fastmail|beeper|home|lmstudio]
|
||||
```
|
||||
|
||||
| Profile | Special workspace | Home monitor | Residents (class → launch) |
|
||||
| --- | --- | --- | --- |
|
||||
| `scratchpad` | `special:scratchpad` | Studio Display, else Samsung ultrawide | `so.stencil.tern` → `tern` |
|
||||
| `claude` | `special:claude` | Studio Display, else Samsung ultrawide | `com.anthropic.Claude` → `claude-desktop` |
|
||||
| `fastmail` | `special:fastmail` | `eDP-1` | `com.fastmail.Fastmail` → `gtk-launch com.fastmail.Fastmail` |
|
||||
| `beeper` | `special:beeper` | `eDP-1` | `Beeper` → `gtk-launch beeper` |
|
||||
| `home` | `special:home` | focused | `brave-home\.google\.com__.*` → `gtk-launch 'Google Home'` |
|
||||
| `lmstudio` | `special:lmstudio` | focused | `ai\.elementlabs\.lmstudio` → `gtk-launch ai.elementlabs.lmstudio` |
|
||||
|
||||
If the workspace is visible, the script hides it. If not, it launches any resident with no window there, waits up to 8 s for the first new window, and reveals the workspace on the home monitor (or the focused one if the home monitor is absent). Launching only missing residents avoids duplicate web-app windows. Bound to `SUPER + CTRL + S`, `SUPER + A`, `SUPER + CTRL + ALT + E`, `SUPER + CTRL + ALT + M`, `SUPER + CTRL + H`, and `SUPER + CTRL + L`.
|
||||
|
||||
## Related
|
||||
|
||||
- [Waybar](waybar.md): the bar used with this setup.
|
||||
- [kitty](../terminal/kitty.md): the `herdr` and `goliath` kitty configs launched here.
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 366 KiB |
@@ -0,0 +1,136 @@
|
||||
# Waybar
|
||||
|
||||
Bottom Waybar for Hyprland/Omarchy — module layout, a drawer of system indicators, the window-title pill, and theme-driven styling.
|
||||
|
||||
[Waybar](https://github.com/Alexays/Waybar) is a status bar for wlroots-based and Hyprland compositors. This config replaces Omarchy's default bar with a bottom-docked layout. It uses Hyprland and Omarchy modules and commands, so it pairs with the [Hyprland](hyprland.md) setup.
|
||||
|
||||
> [!NOTE]
|
||||
> `~/.config/waybar` is part of the role-gated desktop layer in `.chezmoiignore.tmpl`, so it applies on `desktop` and `laptop` roles only. Waybar itself comes from Omarchy and is not in `.chezmoidata/packages.yaml`.
|
||||
|
||||
## Files
|
||||
|
||||
| Source (repo) | Target |
|
||||
| --- | --- |
|
||||
| `dot_config/waybar/config.jsonc` | `~/.config/waybar/config.jsonc` |
|
||||
| `dot_config/waybar/style.css` | `~/.config/waybar/style.css` |
|
||||
| `dot_config/waybar/window_pill.py` | `~/.config/waybar/window_pill.py` |
|
||||
| `dot_config/waybar/V6.cb.png` | `~/.config/waybar/V6.cb.png` |
|
||||
|
||||
> [!WARNING]
|
||||
> `window_pill.py` has no `executable_` prefix, and the repo file is mode `0644`. In symlink mode, chezmoi links `~/.config/waybar/window_pill.py` to that non-executable file. The module's `exec` calls the path directly, so it only runs if the executable bit is set by hand (`chmod +x` on the source) or the file is renamed to `executable_window_pill.py`.
|
||||
|
||||
`V6.cb.png` is a 1920×921 reference screenshot of this bar, taken with a floating btop window over a plain background. No config file references it.
|
||||
|
||||
|
||||
|
||||
## Bar settings
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `position` | `bottom` |
|
||||
| `exclusive` | true (reserves space) |
|
||||
| `fixed-center` | true |
|
||||
| `spacing` | 2 |
|
||||
| `margin-top` | 1 |
|
||||
| `reload_style_on_change` | true |
|
||||
|
||||
## Layout
|
||||
|
||||
**Left**
|
||||
|
||||
- separator
|
||||
- `custom/omarchy`
|
||||
- separator
|
||||
- `hyprland/workspaces`
|
||||
- separator
|
||||
- `tray`
|
||||
- separator
|
||||
- `custom/voxtype`
|
||||
- `custom/update`
|
||||
- `custom/screenrecording-indicator`
|
||||
- `custom/updatespacman`
|
||||
- separator
|
||||
- `idle_inhibitor`
|
||||
|
||||
**Center**
|
||||
|
||||
- `custom/windowpill`
|
||||
|
||||
**Right**
|
||||
|
||||
- `group/right-group2` → `group/right2` → `group/tray-expander`
|
||||
- `group/right-group1` → `group/right1` → `clock`
|
||||
|
||||
The right side nests groups in vertical wrappers so the drawer and the two-line clock align. `group/tray-expander` is a drawer (600 ms transition, children class `tray-group-item`). It shows only `custom/expand-icon` until hovered, then reveals: `backlight`, `bluetooth`, `pulseaudio#output`, `pulseaudio#input`, `power-profiles-daemon`, `network`, `memory`, `cpu`, `battery`.
|
||||
|
||||
## Modules
|
||||
|
||||
| Module | Configuration |
|
||||
| --- | --- |
|
||||
| `custom/separator` (also `separator2`, `separator3`, defined but unused) | Literal `\|`, no tooltip |
|
||||
| `custom/omarchy` | Omarchy logo glyph (`omarchy` font). Click: `omarchy-menu`. Right-click: `xdg-terminal-exec`. Tooltip "Omarchy Menu — Super + Alt + Space" |
|
||||
| `hyprland/workspaces` | `format "{icon}"`, click to activate, pointer cursor. Persistent workspaces per output, matching the [Hyprland workspace rules](hyprland.md#workspace-rules): 1–4 on `DP-4` (Studio Display), 5–8 on `eDP-1`. Keyed by connector name, so a re-dock onto another DP port needs the key updated |
|
||||
| `tray` | Icon size 12, spacing 5, shows passive items |
|
||||
| `custom/voxtype` | `omarchy-voxtype-status` (JSON). Icons for `idle` (none), `recording`, `transcribing`. Click: `omarchy-voxtype-model`. Right-click: `omarchy-voxtype-config` |
|
||||
| `custom/update` | `omarchy-update-available` every 6 h (`interval 21600`, `signal 7`). Click runs `omarchy-update` in a floating terminal |
|
||||
| `custom/screenrecording-indicator` | `$OMARCHY_PATH/default/waybar/indicators/screen-recording.sh` (JSON, `signal 8`). Click: `omarchy-capture-screenrecording` |
|
||||
| `custom/updatespacman` | `waybar-module-pacman-updates --no-zero-output`, only if that binary exists. Shows an icon when updates are pending |
|
||||
| `idle_inhibitor` | Activated/deactivated icons |
|
||||
| `custom/windowpill` | `~/.config/waybar/window_pill.py` (JSON, `restart-interval 1`), centered |
|
||||
| `clock` | `{:%H:%M\n%d/%m/%Y}` (two lines); alt `{:%H:%M - %d/%m/%Y}`. Month calendar tooltip (3 columns; month `#ffead3`, weekdays `#ffcc66`, today `#ff6699`). Right-click: `omarchy-tz-select` in a floating terminal |
|
||||
| `backlight` | Device `intel_backlight`, 15-step icon ramp, tooltip shows percent |
|
||||
| `bluetooth` | Off/on/connected icons, tooltip shows connection count. Click: `omarchy-launch-bluetooth` |
|
||||
| `pulseaudio#output` | Icon only (headphone or 3-step speaker, muted icon). Max 100%, scroll step 2. Click: `omarchy-launch-audio`. Right-click: `pamixer -t` (mute) |
|
||||
| `pulseaudio#input` | Mic / muted-mic icon. Max 100%, scroll step 1 via `pactl set-source-volume`. Click: `omarchy-launch-audio`. Right-click: `pamixer -t` |
|
||||
| `power-profiles-daemon` | Icons for performance / balanced / power-saver. Tooltip shows profile and driver |
|
||||
| `network` | 5-step Wi-Fi signal icons; ethernet and disconnected icons. Tooltips show ESSID, frequency, and bandwidth. Polls every 3 s. Click: `omarchy-launch-wifi` |
|
||||
| `memory` | `{used:0.1f}G` every 2 s. Click: `omarchy-launch-or-focus-tui btop` |
|
||||
| `cpu` | `{usage}%` every 10 s. Click: btop |
|
||||
| `battery` | `{capacity}% {icon}` with 10-step charging and discharging ramps. Warning at 20%, critical at 10%, polled every 5 s. Click: `omarchy-menu power`. Right-click: `notify-send` of `omarchy-battery-status` |
|
||||
|
||||
Icons are Nerd Font glyphs.
|
||||
|
||||
## window_pill.py
|
||||
|
||||
A Python script that feeds `custom/windowpill` a two-line label for the focused window:
|
||||
|
||||
- **Top line:** the window class, small, `#a6adc8`, lowered with `rise='-2000'`.
|
||||
- **Bottom line:** the title, bold, size 11000, `#ffffff`, truncated to 80 characters (`MAX_TITLE_LEN`). For Discord/Vesktop it removes the unread counter prefix such as `(209) ` and a leading `Discord | `.
|
||||
- **No focused window:** shows `Workspace <id>` over a non-breaking space.
|
||||
|
||||
Text is HTML-escaped for Pango and printed as JSON (`class: custom-window`, tooltip `class: title`). After the first print it connects to Hyprland's event socket `/tmp/hypr/$HYPRLAND_INSTANCE_SIGNATURE/.socket2.sock` and reprints on `activewindow>>` and `workspace>>` events. It exits if `HYPRLAND_INSTANCE_SIGNATURE` is unset, which means the module does nothing outside Hyprland.
|
||||
|
||||
## Styling
|
||||
|
||||
`style.css` imports the active Omarchy theme's palette, so colors follow whatever theme Omarchy has selected (for example cyberdream):
|
||||
|
||||
**~/.config/waybar/style.css**
|
||||
|
||||
```css
|
||||
@import "/home/prad/.local/state/omarchy/current/theme/waybar.css";
|
||||
```
|
||||
|
||||
The import path is hard-coded to `/home/prad`. On another account the import fails and the `@background` / `@foreground` colors are undefined.
|
||||
|
||||
| Element | Style |
|
||||
| --- | --- |
|
||||
| All | `font-family: 'CaskaydiaCove Nerd Font Propo'`, no borders or text shadow, square corners |
|
||||
| Bar box (`#waybar > box`) | `@background` fill, `@foreground` text, 2px/6px margins, 4px radius, `box-shadow 0 1px 2px` black, weight 700, size 12px, min height 30px, 0.5 s background transition |
|
||||
| Window background | `@transparent` |
|
||||
| Workspace buttons | Opacity 0.55. Active 1.0. Empty 0.2. Empty and active 1.0. Bold 12px |
|
||||
| Modules | 6px horizontal padding, 1px margins, min width 12px |
|
||||
| Separators | Opacity 0.25 |
|
||||
| `custom/updatespacman` | Opacity 0.55 |
|
||||
| `custom/expand-icon` | Opacity 0.5 |
|
||||
| `custom/update` | 10px font |
|
||||
| Tray | `@background`. Passive items dimmed, attention items highlighted |
|
||||
| Tooltips | `@background`, 12px, 8px radius, `1.5px solid rgba(255,255,255,0.25)` border |
|
||||
| Screen recording active | `#eb7087`, blinks to `@background` every 0.5 s |
|
||||
| Voxtype recording | `#a55555` |
|
||||
| Battery warning | `#c95d0f` |
|
||||
| Battery critical (not charging) | `#e6d8ba` on transparent, blinking to `#f53c3c` (0.5 s, 12 steps) |
|
||||
|
||||
## Related
|
||||
|
||||
- [Hyprland](hyprland.md): the compositor this bar is built for.
|
||||
- [Fonts and default apps](fonts-and-apps.md): Nerd Font packages.
|
||||
@@ -0,0 +1,101 @@
|
||||
# Installation
|
||||
|
||||
Install Omarchy, then install chezmoi and apply these dotfiles with one command.
|
||||
|
||||
## Before you run it
|
||||
|
||||
1. **Omarchy**
|
||||
|
||||
Install [Omarchy](https://omarchy.org) first. It provides Arch Linux, Hyprland, Waybar, the `omarchy-*` commands, the `[omarchy]` pacman repo, and a working AUR helper (`yay`). The desktop layer in this repo (the `dot_config/hypr` submodule, Waybar, `uwsm`, the `omarchy-*` scripts) layers on top of that install and does not replace it.
|
||||
|
||||
2. **age key**
|
||||
|
||||
chezmoi is configured for age encryption with the identity at `~/.config/chezmoi/key.txt`. The key is never committed. Copy it from an existing machine before applying:
|
||||
|
||||
```sh
|
||||
mkdir -p ~/.config/chezmoi
|
||||
scp <existing-machine>:.config/chezmoi/key.txt ~/.config/chezmoi/key.txt
|
||||
chmod 600 ~/.config/chezmoi/key.txt
|
||||
```
|
||||
|
||||
3. **Repository access**
|
||||
|
||||
[env/omarchy](https://prad.codes/env/omarchy) is a public repository on the prad.codes Gitea, so the HTTPS clone needs no credentials. The submodules (`dot_config/fish`, `dot_config/hypr`) are cloned by chezmoi on init. Use the SSH remote (`git@prad.codes:env/omarchy.git`) if you plan to push.
|
||||
|
||||
## One-liner
|
||||
|
||||
```sh
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply https://prad.codes/env/omarchy.git
|
||||
```
|
||||
|
||||
This is chezmoi's official install script. It installs chezmoi to `./bin` (run it from `~` or pass `-b ~/.local/bin`), clones the repo into `~/.local/share/chezmoi`, and runs `chezmoi apply`.
|
||||
|
||||
## Options
|
||||
|
||||
Arguments after `--` go to chezmoi:
|
||||
|
||||
**SSH**
|
||||
|
||||
```sh
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b ~/.local/bin init --apply git@prad.codes:env/omarchy.git
|
||||
```
|
||||
|
||||
**Dry run**
|
||||
|
||||
```sh
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b ~/.local/bin init https://prad.codes/env/omarchy.git
|
||||
chezmoi diff
|
||||
chezmoi apply
|
||||
```
|
||||
|
||||
**chezmoi only**
|
||||
|
||||
```sh
|
||||
sh -c "$(curl -fsLS get.chezmoi.io)" -- -b ~/.local/bin --version
|
||||
```
|
||||
|
||||
| Flag | Effect |
|
||||
| --- | --- |
|
||||
| `-b <dir>` | Install directory (default `./bin`) |
|
||||
| `-t <tag>` | chezmoi release tag (default `latest`) |
|
||||
| `-d` | Debug logging |
|
||||
|
||||
## Roles
|
||||
|
||||
The first apply asks once for a machine role:
|
||||
|
||||
| Role | Gets |
|
||||
| --- | --- |
|
||||
| `desktop` (default) | Universal toolset plus the Linux desktop layer (Hyprland config, Waybar, `omarchy-*` scripts, fonts, default apps) |
|
||||
| `laptop` | Same as `desktop` |
|
||||
| `server` | Universal toolset only; no desktop layer |
|
||||
|
||||
See [Configuration](chezmoi/config.md) for how the role is stored and [Ignore rules](chezmoi/externals-and-ignore.md) for what it gates.
|
||||
|
||||
## First apply
|
||||
|
||||
1. **Prompts**
|
||||
|
||||
`.chezmoi.toml.tmpl` asks once for **name**, **email**, and **role** (`desktop`, `laptop`, `server`). Answers are stored in `~/.config/chezmoi/chezmoi.toml` and not asked again. See [Configuration](chezmoi/config.md).
|
||||
|
||||
2. **Packages**
|
||||
|
||||
`run_onchange_before_10-packages` installs everything in `.chezmoidata/packages.yaml` with pacman and yay before any file is written. See [Scripts](chezmoi/scripts.md).
|
||||
|
||||
3. **Files and externals**
|
||||
|
||||
Configs are linked into `$HOME` (symlink mode). The neovim config, Omarchy's `~/.config/omarchy` checkout, and the terminal and tool configs are cloned as externals. See [Externals and ignore rules](chezmoi/externals-and-ignore.md).
|
||||
|
||||
4. **Post-apply scripts**
|
||||
|
||||
rustup and cargo crates, the global mise tools (`ghq`, `bun`, `node`, `uv`, `opencode`, `crush`, omp), strata on Linux desktops, then gh extensions (from a fish session), skills, the bat cache, the font cache, yazi plugins, and the systemd user services. tpm arrives earlier as an external.
|
||||
|
||||
> [!NOTE]
|
||||
> The gh extension script skips with a warning until `gh auth login` has run. A skipped run still exits 0, so a plain `chezmoi apply` does not retry it. See [Scripts](chezmoi/scripts.md#20-gh-extensions) for how to re-run it.
|
||||
|
||||
## Updating
|
||||
|
||||
```sh
|
||||
chezmoi update # git pull + apply
|
||||
chezmoi diff # what apply would change
|
||||
```
|
||||
@@ -0,0 +1,37 @@
|
||||
# Shell
|
||||
|
||||
fish, bash, and zsh with shared aliases, the starship prompt, atuin history, and the ~/.local/bin scripts.
|
||||
|
||||
fish is the main interactive shell. bash and zsh are set up to feel the same: they share aliases, the prompt, atuin history, and ports of the cd-style helper functions. General-purpose tools are POSIX or bash scripts in `~/.local/bin`, so each has a single implementation that all three shells call.
|
||||
|
||||
| Page | Covers |
|
||||
| --- | --- |
|
||||
| [fish](fish.md) | `~/.config/fish`: `config.fish`, every `conf.d/` file (PATH, env, aliases, ssh-agent, tool init, secrets by name), vi-mode key bindings, the cyberdream theme, completions, the nvm.fish plugin, and every function in `functions/` |
|
||||
| [bash and zsh](bash-zsh.md) | `~/.bashrc`, `~/.zshrc`, zsh and bash key bindings, `~/.config/shell/aliases.sh`, per-shell function ports |
|
||||
| [Aliases](aliases.md) | Every alias from `.chezmoidata/aliases.yaml` plus the fish-only and shell-specific ones |
|
||||
| [Scripts](scripts.md) | Every general-purpose executable in `~/.local/bin` (`pj`, `ghn`, `gop`, `mtime-sort`, `atuin-pick`, …) |
|
||||
| [Starship](starship.md) | `~/.config/starship.toml`: format, modules, symbols, cyberdream palette |
|
||||
| [atuin](atuin.md) | `~/.config/atuin`: history search settings, AI inline integration, cyberdream theme |
|
||||
|
||||
## Shared across shells
|
||||
|
||||
| Concern | fish | bash | zsh |
|
||||
| --- | --- | --- | --- |
|
||||
| Aliases | `conf.d/20-aliases.fish` (hand-maintained) | `~/.config/shell/aliases.sh` (rendered from YAML) | same as bash |
|
||||
| Prompt | starship + transient prompt | starship | starship + transient prompt |
|
||||
| History | atuin (hishtory also sourced if installed) | atuin | atuin, plus suvadu if installed |
|
||||
| Key bindings | vi mode plus custom binds | atuin defaults only | emacs keymap plus ports of the fish binds |
|
||||
| cd-style helpers | `functions/*.fish` | `~/.config/bash/functions/*.bash` | `~/.config/zsh/functions/*.zsh` |
|
||||
| Directory jumping | `cd` wrapper with zoxide fallback, `zoxide init` | `cd` wrapper | `cd` wrapper |
|
||||
|
||||
## Theme
|
||||
|
||||
fish syntax colors, `FZF_DEFAULT_OPTS`, the starship palette, and the atuin theme all use **cyberdream** ([cyberdream.nvim](https://github.com/scottmckendry/cyberdream.nvim)). In fish, `40-tools.fish` also replays quickshell's wallpaper-generated terminal color sequences if that file exists.
|
||||
|
||||
## Role gating
|
||||
|
||||
Everything in this section applies on every role (`desktop`, `laptop`, `server`). The desktop helpers in `~/.local/bin` are the exception; they come with the rest of the [desktop layer](../desktop/README.md).
|
||||
|
||||
## Packages
|
||||
|
||||
`.chezmoidata/packages.yaml` supplies the shell tooling through pacman: `fish`, `starship`, `atuin`, `zoxide`, `fzf`, `fd`, `ripgrep`, `eza`, `bat`, `jq`, `gum`, `glow`, `yazi`, `lazygit`, and `zsh-syntax-highlighting`. See [chezmoi scripts](../chezmoi/scripts.md).
|
||||
@@ -0,0 +1,121 @@
|
||||
# Aliases
|
||||
|
||||
Every alias and alias-like helper across fish, bash, and zsh, and where each one is defined.
|
||||
|
||||
## Single source
|
||||
|
||||
`.chezmoidata/aliases.yaml` holds the shell-agnostic aliases as a list of sections, each with `name`/`cmd` items. chezmoi loads the file as template data ([chezmoi data](../chezmoi/data.md)), and `dot_config/shell/aliases.sh.tmpl` ranges over it to produce `~/.config/shell/aliases.sh`, which `~/.bashrc` and `~/.zshrc` source:
|
||||
|
||||
**.chezmoidata/aliases.yaml**
|
||||
|
||||
```yaml
|
||||
aliases:
|
||||
- section: "Editors / file managers"
|
||||
items:
|
||||
- { name: "e", cmd: "nvim" }
|
||||
# …
|
||||
```
|
||||
|
||||
**~/.config/shell/aliases.sh**
|
||||
|
||||
```text
|
||||
# Editors / file managers
|
||||
alias e='nvim'
|
||||
```
|
||||
|
||||
To add an alias for bash and zsh, add it to the YAML and run `chezmoi apply`.
|
||||
|
||||
> [!NOTE]
|
||||
> The YAML and template comments say fish renders the same data through `fish/conf.d/20-aliases.fish.tmpl`. That template no longer exists. `dot_config/fish/conf.d/20-aliases.fish` is a plain, hand-maintained fish file, so a YAML change does not reach fish. The fish column below shows where the two sets differ.
|
||||
|
||||
## Shared aliases
|
||||
|
||||
A ✓ means the alias exists in that shell with the command shown. Where fish uses a different command, the fish command is shown instead.
|
||||
|
||||
### Editors / file managers
|
||||
|
||||
| Alias | bash / zsh (YAML) | fish (`20-aliases.fish`) |
|
||||
| --- | --- | --- |
|
||||
| `e` | `nvim` | ✓ |
|
||||
| `e.d` | `cd ~/.config/dotstate/storage/Rogz/.config && yazi` | not defined |
|
||||
| `e.f` | `cd ~/.config/fish && yazi` | `cd ~/.local/share/chezmoi/dot_config/fish && yazi` |
|
||||
| `e.h` | not defined | `cd ~/.local/share/chezmoi/dot_config/hypr && yazi` |
|
||||
| `e.k` | `yazi ~/.config/kitty` | ✓ |
|
||||
| `e.v` | `yazi ~/.config/nvim/lua` | ✓ |
|
||||
| `e.y` | `yazi ~/.config/yazi` | ✓ |
|
||||
| `e.t` | `nvim ~/.config/tmux/tmux.conf` | ✓ |
|
||||
| `hx` | `helix` | ✓ (listed under Tools in fish) |
|
||||
|
||||
The fish `e.f`, `e.h`, and `e.k` aliases open the chezmoi source tree directly. In symlink mode, `~/.config/<tool>` files are symlinks into that tree, so both versions edit the same files. yazi and tmux are external checkouts in `~/.config`, so `e.y` and `e.t` open them there.
|
||||
|
||||
### Quick directory jumps
|
||||
|
||||
| Alias | bash / zsh (YAML) | fish |
|
||||
| --- | --- | --- |
|
||||
| `cdc` | `cd ~/.config && yazi` | ✓ |
|
||||
| `cdd` | `cd ~/Developer && yazi` | not defined |
|
||||
| `cdk` | `cd ~/Documents/Knowledge && obsidian` | ✓ |
|
||||
| `cdl` | `cd ~/.local && yazi` | ✓ |
|
||||
| `cds` | `cd ~/.local/share/services && ls` | ✓ |
|
||||
| `cdw` | `cd ~/Downloads && yazi` | ✓ |
|
||||
| `,,` | not defined | `cd ~/.local/share/chezmoi && yazi` |
|
||||
|
||||
### Tools
|
||||
|
||||
| Alias | Command | fish |
|
||||
| --- | --- | --- |
|
||||
| `dd` | `lazydocker` | ✓ |
|
||||
| `gg` | `lazygit` | ✓ |
|
||||
| `ff` | `exec fish` | ✓ |
|
||||
| `npx` | `bunx` | ✓ |
|
||||
| `sm` | `sudo micro` | ✓ |
|
||||
| `sd` | `ssh prad@<lan-host>` (a machine on the local network) | ✓ |
|
||||
| `oc` | `opencode` | ✓ |
|
||||
| `dss` | `dotstate sync` | ✓ |
|
||||
| `fabric` | `fabric-ai` | ✓ |
|
||||
| `bk` | `bead-kanban` | ✓ |
|
||||
| `lc` | `leetcode` | ✓ |
|
||||
| `tk` | `task` | ✓ |
|
||||
| `..` | not defined | `cd ..` |
|
||||
|
||||
`dd` shadows coreutils `dd` in interactive shells. Use `command dd` for the real one.
|
||||
|
||||
## fish-only aliases
|
||||
|
||||
### Bun
|
||||
|
||||
| Alias | Command |
|
||||
| --- | --- |
|
||||
| `br` | `bun run` |
|
||||
| `br.d` | `bun run dev` |
|
||||
| `br.b` | `bun run build` |
|
||||
| `br.t` | `bun run test` |
|
||||
| `bi` | `bun install` |
|
||||
| `bg` | `bun install -g` |
|
||||
| `bx` | `bunx` |
|
||||
|
||||
`bg` replaces fish's job-control builtin. Use `builtin bg` to resume a background job.
|
||||
|
||||
## Shell-specific extras
|
||||
|
||||
All three shells define these outside the YAML: in `20-aliases.fish` for fish, and in the tail of `aliases.sh.tmpl` for bash and zsh.
|
||||
|
||||
| Name | Kind | Definition |
|
||||
| --- | --- | --- |
|
||||
| `cpy` | alias | `wl-copy` if available |
|
||||
| `pst` | alias | `wl-paste` if available |
|
||||
| `q` | function | `exit`. Runs `ya emit quit` first when `$YAZI_ID` is set, so the parent yazi also quits |
|
||||
| `celar`, `claer` | alias | `clear` (interactive only) |
|
||||
| `ls` | alias | `eza --icons` when eza is installed (interactive only) |
|
||||
|
||||
## Abbreviations
|
||||
|
||||
No fish `abbr` definitions are committed. Abbreviations live in `fish_variables`, which chezmoi ignores.
|
||||
|
||||
## Related helpers
|
||||
|
||||
The following are functions or scripts, not aliases, and are documented elsewhere:
|
||||
|
||||
- `c`, `cd`, `y`/`yy`, `clip-last`, `ghg`, `ghn`, `gho`: per-shell functions ([fish](fish.md#functions), [bash and zsh](bash-zsh.md#per-shell-functions)).
|
||||
- `pnpmf`, `pnpmfd`, `pnpmfr`, `pnpmfw`, `pnpmfx`: fish workspace helpers ([fish](fish.md#pnpm-filterfish)).
|
||||
- `ai`, `pj`, `gop`, `fab`, `gdc`, and the other `~/.local/bin` tools: [Scripts](scripts.md).
|
||||
@@ -0,0 +1,128 @@
|
||||
# atuin
|
||||
|
||||
Shell history search with a daemon, directory-scoped up-arrow, tmux popups, a CherryBlossom theme, and the atuin AI inline command generator.
|
||||
|
||||
[atuin](https://atuin.sh) replaces shell history search in fish, bash, and zsh. It also provides `atuin ai inline`, a natural-language command generator that the fish config binds to keys.
|
||||
|
||||
| Source (repo) | Target | Notes |
|
||||
| --- | --- | --- |
|
||||
| `dot_config/atuin/private_config.toml` | `~/.config/atuin/config.toml` | `private_`: written as a regular `0600` file, not a symlink |
|
||||
| `dot_config/atuin/themes/cherry-blossom.toml`, `dot_config/atuin/themes/cyberdream.toml` | `~/.config/atuin/themes/*.toml` | symlinks |
|
||||
|
||||
chezmoi runs in symlink mode, but `private_` files are written as real files, so edits to `~/.config/atuin/config.toml` do not reach the repo on their own. Copy them back with `chezmoi re-add` (or `czs`, see [fish](fish.md#functions)). None of the files are templates, and they apply on every role.
|
||||
|
||||
## Installation
|
||||
|
||||
`atuin` is listed in `.chezmoidata/packages.yaml` for pacman, and the shells use that package's binary (`/usr/bin/atuin` on Arch). Each shell runs `atuin init` only if `atuin` is on `PATH`.
|
||||
|
||||
> [!NOTE]
|
||||
> **No standalone install**
|
||||
>
|
||||
> An earlier setup also kept atuin's standalone installer layout in `~/.atuin/bin` (with a cargo-dist `atuin-receipt.json` in the repo) and prepended it to `PATH` from `conf.d/atuin.env.fish` and `. "$HOME/.atuin/bin/env"` in `.bashrc`/`.zshrc`. That copy fell behind the package: the daemon, from the newer package, migrated the history database, and every command the shells ran through the old binary failed with `migration 20260818000000 was previously applied but is missing in the resolved migrations`. The standalone install, its receipt, and the `PATH` lines are gone. Do not reinstall atuin with its curl installer on this setup.
|
||||
|
||||
## Shell integration
|
||||
|
||||
| Shell | Where | What |
|
||||
| --- | --- | --- |
|
||||
| fish | `config.fish`, interactive only | `atuin init fish \| source`, and a copy of the `?` binding (atuin 18.21 removed the `atuin ai init` command that used to emit it) |
|
||||
| fish | `functions/fish_user_key_bindings.fish` | <kbd>ctrl-w</kbd> runs `atuin ai inline` |
|
||||
| bash | end of `~/.bashrc` | `eval "$(atuin init bash)"` |
|
||||
| zsh | end of `~/.zshrc` | `eval "$(atuin init zsh)"` |
|
||||
|
||||
In fish, `40-tools.fish` sources hishtory before atuin, but atuin's init runs later in `config.fish` and takes <kbd>ctrl-r</kbd>. zsh also loads `suv init zsh` (suvadu) if installed.
|
||||
|
||||
### Key bindings
|
||||
|
||||
| Key | Shells | Action |
|
||||
| --- | --- | --- |
|
||||
| <kbd>ctrl-r</kbd> | all | Interactive search (`_atuin_search`) |
|
||||
| <kbd>up</kbd> | all | Search opened from the up arrow. `filter_mode_shell_up_key_binding = "directory"` limits it to history from the current directory |
|
||||
| <kbd>?</kbd> | fish, vi normal mode | On an empty buffer, runs `atuin ai inline --hook` |
|
||||
| <kbd>ctrl-w</kbd> | fish, insert and normal mode | `atuin ai inline`, then repaint |
|
||||
| <kbd>ctrl+shift+p</kbd> | kitty | [`atuin-pick`](scripts.md#atuin-pick): directory-filtered search in a split, running the pick in a fresh fish |
|
||||
|
||||
Under tmux, atuin's `[tmux]` settings open the search in a tmux popup (80% wide, 60% tall) instead of inline.
|
||||
|
||||
## AI inline
|
||||
|
||||
Commit `a82921c` ("add Atuin AI inline integration and keybinding") added the <kbd>ctrl-w</kbd> bind to `fish_user_key_bindings.fish`, `atuin ai init fish | source` to `config.fish`, and a copy of the `_atuin_ai_question_mark` function that command printed, with `bind "?" _atuin_ai_question_mark`. atuin 18.21 removed `atuin ai init`, so `config.fish` keeps only the copied function and binding; `atuin ai inline --hook` still works.
|
||||
|
||||
The config also sets `[ai] enabled = true`.
|
||||
|
||||
`_atuin_ai_question_mark` works like this:
|
||||
|
||||
- **Buffer empty (or just `?`):** clears the line, prints OSC `133;C` to `/dev/tty` to close the terminal's semantic prompt zone (so shell-integrated terminals do not erase the TUI during a prompt reflow), then runs `atuin ai inline --hook` with stdout and stderr swapped. The TUI draws on the terminal, and the result comes back tagged:
|
||||
|
||||
| Output prefix | Effect |
|
||||
| --- | --- |
|
||||
| `__atuin_ai_print__:` | Print the text, repaint |
|
||||
| `__atuin_ai_cancel__` | Repaint only |
|
||||
| `__atuin_ai_execute__:` | Put the command on the line and execute it |
|
||||
| `__atuin_ai_insert__:` | Put the command on the line for editing |
|
||||
| anything else, non-empty | Put it on the line for editing |
|
||||
|
||||
- **Buffer not empty:** inserts a literal `?` under emacs bindings. Under vi or hybrid bindings, which this config uses, it does nothing.
|
||||
|
||||
`bind "?"` in `config.fish` has no `-M` flag, so it applies to fish's `default` mode, which is vi **normal** mode here. In insert mode <kbd>?</kbd> types a question mark. To ask for a command, press <kbd>Esc</kbd> and then <kbd>?</kbd> on an empty line, or press <kbd>ctrl-w</kbd> from either mode. The <kbd>ctrl-w</kbd> bind calls `atuin ai inline` without `--hook` and replaces fish's default <kbd>ctrl-w</kbd> word deletion.
|
||||
|
||||
bash and zsh have no AI binding.
|
||||
|
||||
## Configuration
|
||||
|
||||
`config.toml` is atuin's generated sample with a few keys set. The rest are commented-out defaults. The settings that take effect:
|
||||
|
||||
| Key | Value | Effect |
|
||||
| --- | --- | --- |
|
||||
| `filter_mode_shell_up_key_binding` | `"directory"` | Up-arrow search shows only the current directory's history |
|
||||
| `dotfiles.enabled` | `true` | Enables atuin's dotfiles feature (aliases and vars managed by atuin) |
|
||||
| `daemon.enabled` | `true` | Uses the background daemon |
|
||||
| `daemon.autostart` | `true` | atuin starts and manages the daemon itself |
|
||||
| `pty_proxy.enabled` | `false` | `atuin init` does not re-exec the shell inside `atuin pty-proxy` |
|
||||
| `theme.name` | `"cherry-blossom"` | Loads `themes/cherry-blossom.toml` |
|
||||
| `tmux.enabled` | `true` | Search opens in a tmux popup when inside tmux (tmux 3.2+) |
|
||||
| `tmux.width` / `tmux.height` | `"80%"` / `"60%"` | Popup size |
|
||||
| `ai.enabled` | `true` | Enables `atuin ai` |
|
||||
|
||||
No sync server, key, or session is configured in the repo. atuin keeps its encryption key and session under `~/.local/share/atuin`, outside chezmoi, and uses the default sync server.
|
||||
|
||||
> [!WARNING]
|
||||
> **Misplaced keys**
|
||||
>
|
||||
> Several keys sit after the `[dotfiles]` table header, so TOML puts them inside `[dotfiles]` rather than at the top level, and atuin ignores them. `atuin config get --resolved` confirms it:
|
||||
>
|
||||
> | Key as written | Intended | Resolved |
|
||||
> | --- | --- | --- |
|
||||
> | `search_mode` | `"daemon-fuzzy"` | `fuzzy` |
|
||||
> | `enter_accept` | `true` | `false` |
|
||||
> | `workspaces` | `true` | `false` |
|
||||
> | `style` | `"auto"` | `compact` |
|
||||
> | `inline_height_shell_up_key_binding` | `20` | unknown key |
|
||||
> | `auto_sync` | `true` | `true` (the default) |
|
||||
> | `update_check` | `true` | `true` (the default) |
|
||||
>
|
||||
> `syntax_highlight = true` has the same problem: it sits under `[ai]`, while the comment block above it documents the `[ui]` table.
|
||||
>
|
||||
> To apply these settings, move the keys above `[dotfiles]` (and `syntax_highlight` under `[ui]`) in `dot_config/atuin/private_config.toml`.
|
||||
|
||||
## Theme
|
||||
|
||||
`themes/cherry-blossom.toml` defines the selected theme, from the CherryBlossom palette shared with Ghostty, tmux, lazygit, and omp:
|
||||
|
||||
| Key | Color |
|
||||
| --- | --- |
|
||||
| `AlertInfo` | `#a78266` |
|
||||
| `AlertWarn` | `#ae825f` |
|
||||
| `AlertError` | `#bf615d` |
|
||||
| `Annotation` | `#a6958f` |
|
||||
| `Guidance` | `#8f9aa0` |
|
||||
| `Important` | `#cf716f` |
|
||||
| `Title` | `#cf716f` |
|
||||
| `Muted` | `#a6958f` |
|
||||
| `SyntaxCommand` | `#cf716f` |
|
||||
| `SyntaxFlag` | `#a78266` |
|
||||
| `SyntaxString` | `#a6b084` |
|
||||
| `SyntaxVariable` | `#c17e4a` |
|
||||
| `SyntaxOperator` | `#ad6756` |
|
||||
| `SyntaxComment` | `#a6958f` |
|
||||
|
||||
`themes/cyberdream.toml` is still shipped (the palette shared with [fish](fish.md#theme) and [Starship](starship.md#palette)) but not selected.
|
||||
@@ -0,0 +1,156 @@
|
||||
# bash and zsh
|
||||
|
||||
Secondary shells that share fish's aliases, starship prompt, atuin history, and cd-style helper functions.
|
||||
|
||||
bash and zsh are set up so a shell other than fish feels the same: the same aliases, the same starship prompt, atuin history, ports of the fish helpers that have to change the shell's own directory, and the same picker key bindings.
|
||||
|
||||
| Source (repo) | Target |
|
||||
| --- | --- |
|
||||
| `dot_bashrc` | `~/.bashrc` |
|
||||
| `dot_zshrc` | `~/.zshrc` |
|
||||
| `dot_config/zsh/keybinds.zsh` | `~/.config/zsh/keybinds.zsh` |
|
||||
| `dot_config/bash/keybinds.bash` | `~/.config/bash/keybinds.bash` |
|
||||
| `dot_config/shell/aliases.sh.tmpl` | `~/.config/shell/aliases.sh` (template) |
|
||||
| `dot_config/bash/functions/*.bash` | `~/.config/bash/functions/` |
|
||||
| `dot_config/zsh/functions/*.zsh` | `~/.config/zsh/functions/` |
|
||||
|
||||
`aliases.sh.tmpl` is the only template. It renders the alias list from `.chezmoidata/aliases.yaml` ([chezmoi data](../chezmoi/data.md)). The other files apply as-is on every role.
|
||||
|
||||
## Installation
|
||||
|
||||
bash is part of the base system. zsh itself is not listed in `.chezmoidata/packages.yaml`, but `zsh-syntax-highlighting`, `starship`, `atuin`, `eza`, and `zoxide` are. `suvadu` (the `suv` history tool) is declared under `packages.shared.cargo` and installed by [15-tools](../chezmoi/scripts.md#15-tools).
|
||||
|
||||
## ~/.bashrc
|
||||
|
||||
Interactive shells only (`[[ $- != *i* ]] && return`). In order:
|
||||
|
||||
1. **PATH.** Prepends `~/.local/bin` if missing, sources `~/.cargo/env` if present, and appends `~/.maestro/bin` if it exists. Exports `GHQ_ROOT` and `CODE_ROOT` as `~/Code`.
|
||||
2. **Go.** `GOPATH=~/.local/share/go`, `GOBIN=$GOPATH/bin`, and `GOBIN` prepended to `PATH`. mise provides `GOROOT`. The same two values are also in `~/.config/go/env` (`dot_config/go/env.tmpl`), Go's own config file, so every `go` invocation uses them even without these variables (cron, `sudo -u`, `env -i`, GUI apps).
|
||||
3. **Android SDK.** `ANDROID_HOME` and `ANDROID_SDK_ROOT` set to `~/.local/share/android`. `platform-tools`, `cmdline-tools/latest/bin`, and `emulator` are appended if they exist. Exports `GITHUB_TOKEN` from `gh auth token` unless it is already set.
|
||||
4. **Aliases.** Sources `~/.config/shell/aliases.sh`.
|
||||
5. **Functions.** Sources every `~/.config/bash/functions/*.bash`.
|
||||
6. **Flyline.** If `~/.local/lib/libflyline.so` exists, loads it with `enable -f … flyline` for richer line editing.
|
||||
7. Sources `~/.config/envman/load.sh` if it is non-empty.
|
||||
8. **Prompt.** `eval "$(starship init bash)"` if starship is installed.
|
||||
9. **television.** `eval "$(tv init bash)"` if `tv` is installed (the `_tv` completion), then sources `~/.config/bash/keybinds.bash`.
|
||||
10. **atuin.** `eval "$(atuin init bash)"` if atuin is installed (the package's binary; see [atuin](atuin.md#installation)). atuin comes after tv, so it keeps <kbd>ctrl-r</kbd> and <kbd>up</kbd>.
|
||||
|
||||
## ~/.zshrc
|
||||
|
||||
1. **History.** `HISTFILE=~/.zsh_history`, `HISTSIZE=10000`, `SAVEHIST=10000`, `setopt SHARE_HISTORY HIST_IGNORE_DUPS`.
|
||||
2. **Completion.** `autoload -Uz compinit && compinit`.
|
||||
3. The same PATH, Go, Android, and `GITHUB_TOKEN` blocks as `.bashrc`, including `GHQ_ROOT` and `CODE_ROOT`.
|
||||
4. Sources `~/.config/shell/aliases.sh`.
|
||||
5. Sources every `~/.config/zsh/functions/*.zsh`.
|
||||
6. Sources `~/.config/zsh/keybinds.zsh`.
|
||||
7. `eval "$(suv init zsh)"` if suvadu is installed.
|
||||
8. Sources `~/.config/envman/load.sh` if it is non-empty.
|
||||
9. **Prompt.** If starship is installed: `eval "$(starship init zsh)"`, `ZLE_RPROMPT_INDENT=0` (the right-prompt clock sits flush with the edge), and a transient prompt. A `line-finish` zle hook swaps `PROMPT`/`RPROMPT` to the `transient` and `transient_right` starship profiles (`❯`, colored by the last exit status, and the time) and redraws, so past prompts collapse as in fish; a `precmd` hook restores the full prompt. Starship's zsh init also sets `PROMPT2`, the `∙` continuation prompt for unfinished lines. See [Starship](starship.md#shell-integration).
|
||||
**Window title.** A `precmd` hook ports `fish_title`: it sets the terminal title to `%~`, prefixed with the first 10 characters of the hostname over SSH, and inside tmux also sets the window name (`ESC k`), like fish's `50-terminal-title.fish`. Unlike fish's `prompt_pwd`, the path is not abbreviated.
|
||||
10. `eval "$(tv init zsh)"` if `tv` is installed (<kbd>ctrl-t</kbd> smart autocomplete).
|
||||
11. **Syntax highlighting.** Sources the first `zsh-syntax-highlighting.zsh` found in `/usr/share/zsh/plugins/zsh-syntax-highlighting/`. The comment says this must stay last, because it wraps every zle widget defined before it.
|
||||
12. **atuin.** `eval "$(atuin init zsh)"` if atuin is installed. This line comes after the syntax-highlighting block, so despite the comment, syntax highlighting is not actually last. atuin loads after tv, so it keeps <kbd>ctrl-r</kbd>.
|
||||
|
||||
## zsh key bindings
|
||||
|
||||
`keybinds.zsh` ports `fish_user_key_bindings.fish` to zle. Unlike fish, zsh uses the **emacs** keymap: `bindkey -e` pins it so that `$EDITOR=nvim` does not switch zsh into vi mode. `unsetopt flow_control` frees <kbd>ctrl-q</kbd> and <kbd>ctrl-s</kbd> from the terminal.
|
||||
|
||||
A generic widget `_zle-run` is registered as `run-<cmd>` for `purple`, `clip-last`, `omp`, `yy`, and `lazygit`. It clears the pending display (`zle -I`), runs the command with the tty on stdin, then `zle reset-prompt`. Widgets run in the shell process, so directory changes made by `gho` and `yy` persist.
|
||||
|
||||
The tv pickers have their own widgets, because `tv --inline` opens on the line below the prompt and leaves the cursor there on exit. `zle -I` followed by `zle reset-prompt` redraws the prompt where zle last drew it, wiping anything printed below; `zle -I` alone draws a fresh prompt under the output.
|
||||
|
||||
| Widget | Runs | Then |
|
||||
| --- | --- | --- |
|
||||
| `tv-git-files` | `tv git-files --inline` | `\033[A`, `reset-prompt` |
|
||||
| `gho-inline` | `gho` | cwd unchanged: `\033[A`, `reset-prompt`. After a cd: nothing, so the new prompt lands below onefetch |
|
||||
| `pj-inline`, `pj-down` | `_zle-pj`: `pj` with `PJ_STATE` set to a temp file (`PJ_QUIET=1` for `pj-down`) | `open` (cancelled): `\033[A`, `reset-prompt`. `ran`: nothing, so the task output stays. Empty (no task sources): `reset-prompt` |
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>ctrl-e</kbd> | `tv-git-files` (pick a file, open it in nvim) |
|
||||
| <kbd>ctrl-f</kbd> | `yy` |
|
||||
| <kbd>ctrl-b</kbd> | `purple` (an external command; this repo does not provide it) |
|
||||
| <kbd>ctrl-y</kbd> | `clip-last` |
|
||||
| <kbd>ctrl-o</kbd> | `gho-inline` (`ghq-repos` cable, cd) |
|
||||
| <kbd>ctrl-p</kbd> | `pj-inline` (`pj` cable) |
|
||||
| <kbd>ctrl-t</kbd> | tv smart autocomplete (from `tv init zsh`) |
|
||||
| <kbd>down</kbd> | `pj-down`: `PJ_QUIET=1 pj` on an empty prompt, otherwise `down-line-or-history` (bound to `^[[B` and `^[OB`) |
|
||||
| <kbd>ctrl-a</kbd> | `omp-session`: resume or start omp for the current repo ([Scripts](scripts.md#omp-session)) |
|
||||
| <kbd>ctrl-n</kbd> | `omp`: always a new omp session (replaces zsh's `down-line-or-history` on that key; <kbd>down</kbd> still walks history) |
|
||||
| <kbd>ctrl-g</kbd> | `lazygit` |
|
||||
| <kbd>ctrl-q</kbd> | `exit` |
|
||||
| <kbd>ctrl-c</kbd> | At the prompt: kill the buffer, clear the screen and kitty scrollback (`ESC[2J ESC[3J`), reset the prompt |
|
||||
|
||||
<kbd>ctrl-c</kbd> is the tty interrupt character, so `bindkey '^C'` would never fire. The binding is a `TRAPINT` function instead. At the prompt it runs `zle .kill-buffer`, prints the clear sequence, and runs `zle .reset-prompt`. While a command is running, SIGINT keeps its normal behavior (returns `128+SIGINT`).
|
||||
|
||||
The fish-only binds <kbd>ctrl-w</kbd> (atuin AI) and <kbd>?</kbd> have no zsh equivalent. <kbd>ctrl-h/j/k/l</kbd> belong to kitty ([kitty](../terminal/kitty.md)) and are not bound here. The cables are described on the [television](../tools/television.md) page.
|
||||
|
||||
## bash key bindings
|
||||
|
||||
`keybinds.bash` gives bash the same picker keys as fish and zsh. bash keeps readline's default emacs keymap. Every picker runs `tv --inline`; when nothing was printed below the prompt, `_kb_up` (`\033[A` on `/dev/tty`) steps back so readline redraws the prompt in place after `bind -x`.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>ctrl-o</kbd> | Macro `\C-x1\C-x2\C-x3\C-x0` (below): pick from the `ghq-repos` cable and cd |
|
||||
| <kbd>ctrl-e</kbd> | `_kb_git_files`: `tv git-files --inline`, then `_kb_up` |
|
||||
| <kbd>ctrl-p</kbd> | `_kb_pj`: `pj` with `PJ_STATE` set to a temp file; `_kb_up` only when the state is `open` (cancelled) |
|
||||
| <kbd>down</kbd> | `PJ_QUIET=1 _kb_pj` on an empty prompt, otherwise `history-search-forward` |
|
||||
| <kbd>ctrl-t</kbd> | `_kb_tv_autocomplete`: runs `tv --autocomplete-prompt … --inline` on the text left of the cursor, `_kb_up`, and inserts the picks there, each `printf %q`-quoted |
|
||||
|
||||
`bind -x` runs in the shell process, so a `cd` persists, but readline keeps drawing the prompt it started with. <kbd>ctrl-o</kbd> is therefore a macro:
|
||||
|
||||
1. `\C-x1` runs `_kb_gho`: stashes `READLINE_LINE`, runs `tv ghq-repos --inline`, `_kb_up`, and cds into the pick. It does not call the `gho` function. After a cd it empties the line and rebinds `\C-x2` to `accept-line` and `\C-x3` to `bind -x _kb_gho_show`; when cancelled it rebinds both to `redraw-current-line`.
|
||||
2. `\C-x2` accepts the empty line, so bash prints a fresh prompt for the new cwd. Nothing reaches history.
|
||||
3. `\C-x3` runs `_kb_gho_show` (`clear`, then `onefetch` in git repos); readline redraws the prompt below the output.
|
||||
4. `\C-x0` runs `_kb_restore`, which puts the typed text back.
|
||||
|
||||
<kbd>down</kbd> (`\e[B` and `\eOB`) is the macro `\C-x4\C-x5`. `bind -x` cannot call readline functions, so `_kb_down` (`\C-x4`) rebinds `\C-x5` to `history-search-forward` when the line is non-empty, or runs `PJ_QUIET=1 _kb_pj` and rebinds `\C-x5` to `redraw-current-line`.
|
||||
|
||||
## Shared aliases: aliases.sh
|
||||
|
||||
`~/.config/shell/aliases.sh` is rendered from `.chezmoidata/aliases.yaml`. Each YAML `section` becomes a comment, and each item becomes `alias <name>='<cmd>'`. The template then appends shell-specific extras that are not in the YAML:
|
||||
|
||||
**~/.config/shell/aliases.sh**
|
||||
|
||||
```sh
|
||||
# Clipboard
|
||||
if command -v wl-copy >/dev/null 2>&1; then
|
||||
alias cpy='wl-copy'
|
||||
alias pst='wl-paste'
|
||||
fi
|
||||
|
||||
q() {
|
||||
if [ -n "$YAZI_ID" ] && command -v ya >/dev/null 2>&1; then
|
||||
ya emit quit 2>/dev/null
|
||||
fi
|
||||
exit
|
||||
}
|
||||
|
||||
alias celar='clear'
|
||||
alias claer='clear'
|
||||
if command -v eza >/dev/null 2>&1; then
|
||||
alias ls='eza --icons'
|
||||
fi
|
||||
```
|
||||
|
||||
- **Clipboard detection.** `cpy`/`pst` map to Wayland's `wl-copy`/`wl-paste` when available.
|
||||
- **`q`.** Exits the shell. If the shell was spawned from yazi's own `q` binding (`$YAZI_ID` set), it runs `ya emit quit` first so the parent yazi closes too instead of bouncing back.
|
||||
- **Typo guards and eza.** `celar`/`claer` → `clear`, and `ls` → `eza --icons` when eza is installed. The file is sourced only by interactive shells, so scripts keep the real `ls`.
|
||||
|
||||
The full alias table, including the differences from fish, is on the [Aliases](aliases.md) page.
|
||||
|
||||
## Per-shell functions
|
||||
|
||||
Each directory holds one function per file. bash and zsh source every file at startup; the bash and zsh versions have identical bodies.
|
||||
|
||||
| Function | Behavior |
|
||||
| --- | --- |
|
||||
| `c [dir]` | `clear` with no argument, `cd "$1"` with one |
|
||||
| `cd [dir]` | No argument: `$HOME`. `-`: previous dir. Otherwise `builtin cd`, falling back to `zoxide query -- "$1"`. Records the result with `zoxide add "$PWD"` and preserves cd's exit status |
|
||||
| `clip-last` | Re-runs the previous history entry (`fc -ln -1 -1`, skipping itself if the line editor already recorded `clip-last`), pipes the output to `wl-copy` or `pbcopy`, and sends a `notify-send -a shell` notification if available |
|
||||
| `ghg <repo>` | `ghg-clone "$@"`, cd into the printed path, `clear && onefetch` |
|
||||
| `ghn <name>` | `command ghn "$@"`, cd into the printed path |
|
||||
| `gho` | `dir=$(tv ghq-repos --inline)`, return if empty, cd into it, `clear`, and `onefetch` if it is a git repo. No cursor handling; bash <kbd>ctrl-o</kbd> does not call it |
|
||||
| `yy [args]` | `yazi --cwd-file=<tmp>`, then cd to the directory written there if it changed |
|
||||
|
||||
The `ghg` helper script is named `ghg-clone` because an unrelated cargo binary already uses the name `ghg`. The [Scripts](scripts.md#why-some-helpers-are-shell-functions) page explains why these helpers are shell functions and not scripts.
|
||||
@@ -0,0 +1,312 @@
|
||||
# fish
|
||||
|
||||
The primary interactive shell — conf.d layout, environment, vi-mode key bindings, the cyberdream theme, completions, and every autoloaded function.
|
||||
|
||||
fish is the primary interactive shell. The config is split into autoloaded files: `conf.d/` for startup snippets, `functions/` for one function per file, `completions/` for completion scripts, and `themes/` for the color theme. `config.fish` runs last and holds the prompt and atuin setup.
|
||||
|
||||
| Source (repo) | Target |
|
||||
| --- | --- |
|
||||
| `dot_config/fish/config.fish` | `~/.config/fish/config.fish` |
|
||||
| `dot_config/fish/conf.d/*.fish` | `~/.config/fish/conf.d/` |
|
||||
| `dot_config/fish/functions/*.fish` | `~/.config/fish/functions/` |
|
||||
| `dot_config/fish/completions/*.fish` | `~/.config/fish/completions/` |
|
||||
| `dot_config/fish/themes/cyberdream.theme` | `~/.config/fish/themes/cyberdream.theme` |
|
||||
| `dot_config/fish/fish_plugins` | `~/.config/fish/fish_plugins` |
|
||||
|
||||
`dot_config/fish` is a git submodule ([prdlk/fish](https://github.com/prdlk/fish)). Edit inside the submodule, commit there, then commit the updated pointer in the chezmoi repo. None of these files are templates. chezmoi runs in symlink mode, so each target is a symlink back into the source tree and edits to `~/.config/fish/...` land in the submodule directly. `~/.config/fish/fish_variables` (universal variables, including the selected theme) is listed in `.chezmoiignore.tmpl` and stays local to each machine. `~/.config/fish/conf.d/secrets.fish` is local-only: it is listed in `.chezmoiignore.tmpl` and in the fish repo's `.gitignore`, and never committed.
|
||||
|
||||
## Installation
|
||||
|
||||
`fish` is in `.chezmoidata/packages.yaml` under `packages.arch.pacman`; `.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl` installs it with pacman. The tools that fish initializes (starship, zoxide, atuin, fzf, eza, gum, yazi, television, mise) come from the same manifest; Bun is a global mise tool (`packages.shared.mise`) and rustup comes from [15-tools](../chezmoi/scripts.md#15-tools). hishtory, envman, and the Go, Android, and Foundry toolchains are not in the manifest; fish initializes each one only if it is present.
|
||||
|
||||
### Plugins
|
||||
|
||||
`fish_plugins` is a [fisher](https://github.com/jorgebucaran/fisher) manifest with one entry:
|
||||
|
||||
**~/.config/fish/fish_plugins**
|
||||
|
||||
```text
|
||||
jorgebucaran/nvm.fish
|
||||
```
|
||||
|
||||
The plugin's files are committed to the repo (`conf.d/nvm.fish`, `functions/nvm.fish`, `functions/_nvm_*.fish`, `completions/nvm.fish`), so fish has `nvm` without fisher. The plugin stores Node builds in `$XDG_DATA_HOME/nvm` (default `~/.local/share/nvm`) and downloads from `https://nodejs.org/dist`. If `nvm_default_version` is set, it runs `nvm use --silent $nvm_default_version` in each interactive shell.
|
||||
|
||||
## Startup order
|
||||
|
||||
fish sources `conf.d/*.fish` in name order and then `config.fish`. The numbered files load first:
|
||||
|
||||
| File | Purpose |
|
||||
| --- | --- |
|
||||
| `00-path.fish` | `PATH` entries and `PNPM_HOME` |
|
||||
| `10-env.fish` | Non-secret environment, greeting, fzf colors |
|
||||
| `20-aliases.fish` | Aliases, clipboard aliases, `q`, typo guards |
|
||||
| `30-ssh-agent.fish` | One ssh-agent shared across shells |
|
||||
| `40-tools.fish` | mise, television, starship, zoxide, entire, hishtory, unsloth |
|
||||
| `50-terminal-title.fish` | tmux/screen window name from `$PWD` |
|
||||
| `inir-env.fish` | `INIR_VENV` and `ILLOGICAL_IMPULSE_VIRTUAL_ENV` → `~/.local/state/quickshell/.venv` |
|
||||
| `inir-path.fish` | Prepends `~/.local/bin` to `PATH` if missing |
|
||||
| `nvm.fish` | nvm.fish plugin events and default-version activation |
|
||||
| `opencode-background-subagents.fish` | `OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=true`, `OPENCODE_ENABLE_EXA=1` |
|
||||
| `pnpm-filter.fish` | `pnpmf*` workspace helpers |
|
||||
| `rustup.fish` | Sources `~/.cargo/env.fish` |
|
||||
| `secrets.fish` | API credentials (names below) |
|
||||
| `uv.env.fish` | Sources `~/.local/bin/env.fish` (written by the uv installer) |
|
||||
|
||||
### 00-path.fish
|
||||
|
||||
Runs for every shell, including non-interactive ones, so scripts get the same `PATH`.
|
||||
|
||||
| Entry | Position |
|
||||
| --- | --- |
|
||||
| `~/.bun/bin`, `~/.local/share/go/bin`, `~/.maestro/bin`, `~/.grok/bin`, `~/.opencode/bin` | prepended |
|
||||
| `~/.foundry/bin` | appended |
|
||||
| `~/.local/share/android/platform-tools`, `cmdline-tools/latest/bin`, `emulator` | appended |
|
||||
| `~/local/share/pnpm` | appended (note the missing dot; this path does not match `PNPM_HOME`) |
|
||||
| `$PNPM_HOME/bin` | prepended; `PNPM_HOME=~/.local/share/pnpm` |
|
||||
|
||||
`~/.local/bin` comes from `inir-path.fish` and `~/.cargo/bin` from `rustup.fish`.
|
||||
|
||||
### 10-env.fish
|
||||
|
||||
| Variable | Value |
|
||||
| --- | --- |
|
||||
| `fish_greeting` | empty (no greeting) |
|
||||
| `FISH_BOTTOM_PROMPT` | `0` unless inherited. `1` pins the prompt to the bottom row |
|
||||
| `HSA_OVERRIDE_GFX_VERSION` | `11.5.0` (ROCm) |
|
||||
| `ROCR_VISIBLE_DEVICES`, `HIP_VISIBLE_DEVICES` | `0` |
|
||||
| `__EGL_VENDOR_LIBRARY_FILENAMES`, `VK_DRIVER_FILES` | Mesa's `50_mesa.json` and RADV's `radeon_icd.json`, only when `/dev/dri/by-path/pci-0000:c4:00.0-render` (the Strix Halo iGPU) exists. Keeps the session off the compute-only eGPU |
|
||||
| `EGET_BIN` | `~/.local/bin` |
|
||||
| `GHQ_ROOT`, `CODE_ROOT` | `~/Code` |
|
||||
| `ANDROID_HOME`, `ANDROID_SDK_ROOT` | `~/.local/share/android` |
|
||||
| `GITEA_LOGIN` | `prad.codes` |
|
||||
| `GITLAB_HOST` | `git.sonr.org` |
|
||||
| `GITHUB_TOKEN` | `gh auth token`, unless already set and only if `gh` is logged in |
|
||||
| `EDITOR`, `VISUAL` | `nvim` |
|
||||
| `BROWSER` | `/usr/bin/brave-origin` if that binary exists |
|
||||
| `CHROME_EXECUTABLE` | `/usr/bin/chromium` if it exists |
|
||||
| `PUPPETEER_EXECUTABLE_PATH` | `~/.local/bin/chrome-headless-shell` |
|
||||
| `ZEAL_DOCSETS` | the Zeal flatpak docset directory |
|
||||
| `SHARP_IGNORE_GLOBAL_LIBVIPS` | `1` |
|
||||
| `FZF_DEFAULT_OPTS` | cyberdream fzf theme (below) |
|
||||
|
||||
`GOPATH`/`GOBIN` are not set here. The comment explains why: mise's fish hook re-applies its `[env]` on every prompt, so Go paths are pinned in `~/.config/mise/config.toml`, and mise provides `GOROOT`. `~/.config/go/env` holds the same values for any `go` run outside a shell.
|
||||
|
||||
**~/.config/fish/conf.d/10-env.fish**
|
||||
|
||||
```fish
|
||||
set -gx FZF_DEFAULT_OPTS "
|
||||
--height=~40%
|
||||
--layout=default
|
||||
--info=inline-right
|
||||
--border=rounded
|
||||
--prompt=' '
|
||||
--pointer='▶'
|
||||
--marker='✓'
|
||||
--color=fg:#ffffff,fg+:#ffffff,bg:-1,bg+:#3c4048
|
||||
--color=hl:#5ef1ff,hl+:#5ef1ff
|
||||
--color=info:#7b8496,header:#7b8496,border:#7b8496
|
||||
--color=prompt:#5ef1ff,pointer:#ffaecf,marker:#5eff6c,spinner:#f1ff5e
|
||||
--color=gutter:-1,query:#ffffff
|
||||
"
|
||||
```
|
||||
|
||||
### 20-aliases.fish
|
||||
|
||||
Editor, Bun, directory-jump, and tool aliases, followed by:
|
||||
|
||||
- `cpy`/`pst`: `wl-copy`/`wl-paste` when `wl-copy` exists.
|
||||
- `q`: exits the shell. If `$YAZI_ID` is set and `ya` exists, it first runs `ya emit quit` so the yazi that spawned the shell quits too.
|
||||
- Interactive only: `celar` and `claer` → `clear`, and `ls` → `eza --icons` when eza is installed. `clear` itself is not aliased, because an alias would shadow `functions/clear.fish`.
|
||||
|
||||
The full list is on the [Aliases](aliases.md) page. This file is plain fish, not rendered from `.chezmoidata/aliases.yaml`, so its alias set differs from bash/zsh in a few places.
|
||||
|
||||
### 30-ssh-agent.fish
|
||||
|
||||
Interactive shells without `SSH_AUTH_SOCK` source `~/.ssh/agent.env.fish` and probe with `ssh-add -l`. Exit code 2 means no agent is reachable. In that case it starts `ssh-agent -c`, rewrites its csh `setenv` lines into `set -gx`, saves them to `~/.ssh/agent.env.fish`, and sources the file. An `SSH_AUTH_SOCK` provided from outside (systemd unit, forwarding, keyring) is left alone.
|
||||
|
||||
### 40-tools.fish
|
||||
|
||||
- `mise activate fish` runs for every shell, so scripts see mise shims too.
|
||||
- Interactive only, in order:
|
||||
1. Print `~/.local/state/quickshell/user/generated/terminal/sequences.txt` if present. These are escape sequences that apply wallpaper-generated Material You terminal colors from quickshell.
|
||||
2. `tv init fish` (television), if installed.
|
||||
3. `starship init fish`, `zoxide init fish`, and `entire completion fish`, each only if installed.
|
||||
4. `tv init fish` a second time. The comment says it runs before hishtory so hishtory keeps <kbd>ctrl-r</kbd>.
|
||||
5. Source `~/.hishtory/config.fish` if present.
|
||||
6. Activate the unsloth studio venv (`~/.unsloth/studio/unsloth_studio/bin/activate.fish`) if present.
|
||||
|
||||
atuin is initialized later, in `config.fish`, and binds <kbd>ctrl-r</kbd> itself.
|
||||
|
||||
### 50-terminal-title.fish
|
||||
|
||||
Defines `terminal_title`, which runs on every `PWD` change and prints `ESC k <prompt_pwd> ESC \`. That sequence sets the tmux or screen window name. `functions/fish_title.fish` sets the regular terminal title.
|
||||
|
||||
### pnpm-filter.fish
|
||||
|
||||
pnpm workspace helpers. `__pnpm_pick_pkg` lists workspace packages with `pnpm m ls --depth -1 --json | jq`, and you pick one with `gum filter`.
|
||||
|
||||
| Function | Does |
|
||||
| --- | --- |
|
||||
| `pnpmf <deps…>` | Pick a package, then `pnpm --filter <pkg> add <deps>` inside a `gum spin` |
|
||||
| `pnpmfd <deps…>` | Same with `add -D` |
|
||||
| `pnpmfr <deps…>` | `pnpm --filter <pkg> remove <deps>` |
|
||||
| `pnpmfw` | Pick a target package and a sibling, then `pnpm --filter <pkg> add <sibling> --workspace` |
|
||||
| `pnpmfx` | Pick a package, then pick one of its `package.json` scripts with `gum filter` and run it |
|
||||
|
||||
### secrets.fish
|
||||
|
||||
Exports credentials as global variables. The values are machine-specific and are not documented here. Variable names:
|
||||
|
||||
`PGDATABASE` (local Postgres connection string), `GITLAB_TOKEN`, `OPPER_API_KEY`, `OPENAI_API_KEY`, `GROQ_API_KEY`, `WEBAWESOME_NPM_TOKEN`, `TAVILY_API_KEY`, `FINANCIAL_DATASETS_API_KEY`, `PIMLICO_API_KEY`, `WAKATIME_API_KEY`, `LINEAR_CLI_PROFILE`, `LINEAR_API_KEY`, `LINEAR_TEAM_ID`.
|
||||
|
||||
> [!WARNING]
|
||||
> Put your own values in `~/.config/fish/conf.d/secrets.fish` on each machine. Do not reuse credentials from another clone.
|
||||
|
||||
## config.fish
|
||||
|
||||
The header comment says the file should stay empty, but it holds the following:
|
||||
|
||||
1. **Starship with transient prompt.** `starship_transient_prompt_func` renders `starship module character` and `starship_transient_rprompt_func` renders `starship module time`. Then `starship init fish | source` and `enable_transience` run, so past prompts collapse to `❯` with the time on the right. See [Starship](starship.md).
|
||||
2. **Bottom-pinned prompt.** In interactive shells with `FISH_BOTTOM_PROMPT=1`, `tput cup $LINES 0` moves the cursor to the last row. The comment calls `1` the default, but `10-env.fish` sets `0`, so the prompt stays at the top unless you export `FISH_BOTTOM_PROMPT=1`.
|
||||
3. `fish_add_path ~/.grok/bin` (grok installer block).
|
||||
4. Sources `~/.config/envman/load.fish` if it is non-empty.
|
||||
5. **atuin.** Interactive shells run `atuin init fish | source`. See [atuin](atuin.md).
|
||||
6. `fish_add_path ~/.cmux/bin` and `~/.cache/.bun/bin`.
|
||||
7. Sources the first readable `~/.config/herdr/plugins/github/herdr-automatic-rename-*/shell/hook.fish`. This is herdr's automatic pane-rename hook ([herdr](../terminal/herdr.md)).
|
||||
8. A copy of the `_atuin_ai_question_mark` function that `atuin ai init fish` used to emit (atuin 18.21 removed that command), followed by `bind "?" _atuin_ai_question_mark`.
|
||||
|
||||
## Key bindings
|
||||
|
||||
`functions/fish_user_key_bindings.fish` turns on **vi mode** (`fish_vi_key_bindings`) first, then adds custom binds in both `insert` and `default` (normal) modes, so they work in either mode.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>ctrl-e</kbd> | `_tv_inline git-files`, then repaint: pick a file in the repo and open it in nvim ([television](../tools/television.md#git-files)) |
|
||||
| <kbd>ctrl-f</kbd> | `yy`: yazi, then cd to the directory yazi exited in |
|
||||
| <kbd>ctrl-b</kbd> | `purple`, then repaint (an external command; this repo does not provide it) |
|
||||
| <kbd>ctrl-y</kbd> | `clip-last`: re-run the last command and copy its output |
|
||||
| <kbd>ctrl-o</kbd> | `_gho_bind`: `gho` (pick a ghq repo or Obsidian vault from the `ghq-repos` cable and cd into it), then repaint |
|
||||
| <kbd>ctrl-p</kbd> | `_pj_bind`: `pj`, the task runner on the `pj` cable ([Scripts](scripts.md#pj)), then repaint |
|
||||
| <kbd>ctrl-a</kbd> | `omp-session`, then repaint: resume or start omp for the current repo by branch and session age, opening the `omp-sessions` cable only when nothing qualifies ([Scripts](scripts.md#omp-session)) |
|
||||
| <kbd>ctrl-n</kbd> | `omp`, then repaint: always a new omp session |
|
||||
| <kbd>ctrl-w</kbd> | `atuin ai inline`: natural-language command overlay |
|
||||
| <kbd>ctrl-z</kbd> | `_jobs_bind`: with one background job, `fg` it; with several, pick one from the `jobs` cable ([television](../tools/television.md#jobs)) and `fg` that; with none, nothing. While a job holds the terminal, ctrl-z is still the tty's suspend, so the key toggles suspend and resume |
|
||||
| <kbd>ctrl-g</kbd> | `lazygit` |
|
||||
| <kbd>down</kbd> | `_pj_bind_down`: opens the `pj` cable on an idle, empty prompt, otherwise fish's `down-or-search` |
|
||||
| <kbd>ctrl-c</kbd> | Clears the command line, runs `clear` (screen and kitty scrollback), repaints |
|
||||
| <kbd>ctrl-q</kbd> | `exit` |
|
||||
|
||||
Bindings added by tool init scripts:
|
||||
|
||||
| Key | Mode | Action | Source |
|
||||
| --- | --- | --- | --- |
|
||||
| <kbd>ctrl-r</kbd> | default and insert | `_atuin_search` | `atuin init fish` |
|
||||
| <kbd>up</kbd> | default and insert | `_atuin_bind_up` (atuin history, directory filter) | `atuin init fish` |
|
||||
| <kbd>?</kbd> | default (vi normal) | `_atuin_ai_question_mark`: on an empty buffer, opens `atuin ai inline` | `config.fish` |
|
||||
| <kbd>ctrl-t</kbd> | insert | `tv_smart_autocomplete` | `tv init fish` |
|
||||
|
||||
`_pj_bind_down` hands the key to `down-or-search` when the buffer is non-empty, the completion pager is open, or history search is active. Otherwise it runs `_pj_bind --quiet` (`PJ_QUIET=1`), so pressing down outside a project does nothing and prints no error.
|
||||
|
||||
The pickers run `tv --inline`, which opens on the line below the prompt and leaves the cursor there when it exits. The wrappers put the prompt back before `commandline -f repaint`, writing the cursor moves to `/dev/tty`:
|
||||
|
||||
| Wrapper | Runs | Then |
|
||||
| --- | --- | --- |
|
||||
| `_tv_inline ARGS` | `tv ARGS --inline` | `\033[A` (cursor up), returns tv's status |
|
||||
| `_gho_bind` | `gho` | `\033[A` if the cwd did not change; `\n` after a cd, so the prompt lands below onefetch |
|
||||
| `_pj_bind [--quiet]` | `pj` with `PJ_STATE` set to a temp file | `\033[A` for `open` (cancelled) or empty (no task sources); `\n` for `ran` (the task printed output) |
|
||||
| `_jobs_bind` | `fg` of the only job, or `jobs` with `TV_JOBS` set to a temp file holding the job table | `\033[A` (via `_tv_inline`) when the picker is cancelled |
|
||||
|
||||
`_jobs_bind` runs `fg` by replacing the command line with ` __jobs_bind_fg <id>` (leading space: kept out of history) and executing it, not from inside the binding. A binding runs while fish's reader still owns the terminal with extended keys on, so a job started with `&` that had never held the terminal got ctrl-z and ctrl-c as escape sequences instead of signals. `__jobs_bind_fg` erases the echoed prompt line (`\033[A\033[2K` on `/dev/tty`) and runs `fg` with its "Send job … to foreground" message sent to `/dev/null`, so resuming leaves nothing on screen. Text already typed is put back at the next prompt by a one-shot `fish_prompt` handler.
|
||||
|
||||
`omp-session` (<kbd>ctrl-a</kbd>) does its own `\033[A` when its `omp-sessions` picker is cancelled, so the binding only repaints.
|
||||
|
||||
zsh and bash bind <kbd>ctrl-o</kbd>, <kbd>ctrl-e</kbd>, <kbd>ctrl-p</kbd>, <kbd>down</kbd>, and <kbd>ctrl-t</kbd> the same way ([bash and zsh](bash-zsh.md)). Inside television, <kbd>ctrl-e</kbd> runs the channel's `edit` action and <kbd>ctrl-h</kbd> its `goto_parent_dir` action (`~/.config/television/config.toml`). The config and cables are on the [television](../tools/television.md) page.
|
||||
|
||||
> [!NOTE]
|
||||
> Under kitty, <kbd>ctrl-g</kbd> (lazygit overlay), <kbd>ctrl-y</kbd> (yazi split), and <kbd>ctrl-h/j/k/l</kbd> (split navigation) are mapped in `kitty.conf` and never reach fish. The fish binds for those keys only apply in other terminals. See [kitty](../terminal/kitty.md).
|
||||
|
||||
The prompt shows `❮` in green in vi normal mode (starship's `vimcmd_symbol`).
|
||||
|
||||
## Theme
|
||||
|
||||
`themes/cyberdream.theme` is a fish theme file with colors from [cyberdream.nvim](https://github.com/scottmckendry/cyberdream.nvim) and preferred background `#16181a`. The repo ships the file but does not select it. The active theme is stored in `fish_variables`, which chezmoi ignores, so pick it once per machine with `fish_config theme save cyberdream`.
|
||||
|
||||
| Variable | Color |
|
||||
| --- | --- |
|
||||
| `fish_color_normal` | `#ffffff` |
|
||||
| `fish_color_command` | `#5ef1ff` |
|
||||
| `fish_color_param`, `fish_color_escape` | `#ffaecf` |
|
||||
| `fish_color_keyword`, `fish_color_host` | `#5eff6c` |
|
||||
| `fish_color_quote`, `fish_color_option`, `fish_color_host_remote` | `#f1ff5e` |
|
||||
| `fish_color_redirection`, `fish_color_operator` | `#5ea1ff` |
|
||||
| `fish_color_end` | `#bd5eff` |
|
||||
| `fish_color_comment`, `fish_color_gray`, `fish_color_autosuggestion` | `#7b8496` |
|
||||
| `fish_color_error`, `fish_color_cancel`, `fish_color_status` | `#ff6e5e` |
|
||||
| `fish_color_selection`, `fish_color_search_match` | background `#3c4048` |
|
||||
| `fish_color_cwd` | `#ffbd5e` |
|
||||
| `fish_color_user` | `#5ef5d2` |
|
||||
| `fish_pager_color_progress`, `fish_pager_color_description` | `#7b8496` |
|
||||
| `fish_pager_color_prefix` | `#5ea1ff` |
|
||||
| `fish_pager_color_completion` | `#ffffff` |
|
||||
|
||||
`FZF_DEFAULT_OPTS` in `10-env.fish` uses the same palette.
|
||||
|
||||
## Completions
|
||||
|
||||
| File | Command | Mechanism |
|
||||
| --- | --- | --- |
|
||||
| `ccc.fish` | `ccc` | Typer-generated: calls `ccc` with `_CCC_COMPLETE=complete_fish` |
|
||||
| `grok.fish` | `grok` | Static clap-style completion script (global options, subcommands) |
|
||||
| `mise.fish` | `mise` | `mise completion fish \| source` (generated at load time) |
|
||||
| `nvm.fish` | `nvm` | From the nvm.fish plugin |
|
||||
| `omp.fish` | `omp` | `omp completions fish \| source` (generated at load time) |
|
||||
| `ostt.fish` | `ostt` | Static clap-style completion script |
|
||||
|
||||
## Functions
|
||||
|
||||
Every file in `functions/` is autoloaded by name. Several also exist as POSIX scripts in `~/.local/bin` for bash and zsh. In fish the function shadows the script. See [Scripts](scripts.md) for why the cd-style helpers must stay shell functions.
|
||||
|
||||
| Function | Purpose |
|
||||
| --- | --- |
|
||||
| `_nvm_index_update` | nvm.fish internal: downloads `index.tab` from `$nvm_mirror` into `$nvm_data/.index` |
|
||||
| `_nvm_list` | nvm.fish internal: lists installed Node versions plus `system` |
|
||||
| `_nvm_version_activate` | nvm.fish internal: sets `nvm_current_version` and prepends its `bin` to `PATH` |
|
||||
| `_nvm_version_deactivate` | nvm.fish internal: removes a version's `bin` from `PATH` |
|
||||
| `_gho_bind` | <kbd>ctrl-o</kbd> handler: `gho`, then cursor fix and repaint (see [Key bindings](#key-bindings)) |
|
||||
| `_pj_bind` | <kbd>ctrl-p</kbd> handler: `pj` with `PJ_STATE`, then cursor fix and repaint. `--quiet` sets `PJ_QUIET=1` |
|
||||
| `_jobs_bind` | <kbd>ctrl-z</kbd> handler: `fg` the only job or pick one from the `jobs` cable (see [Key bindings](#key-bindings)) |
|
||||
| `_pj_bind_down` | Down-arrow handler: `_pj_bind --quiet` on an empty idle prompt, else `down-or-search` |
|
||||
| `_tv_inline` | `tv $argv --inline`, then moves the cursor up one line on `/dev/tty` |
|
||||
| `ai` | `gum choose` among `claude`, `opencode`, `codex`, `hermes`, `fractal`. `claude` runs with `--dangerously-skip-permissions` |
|
||||
| `c` | `clear` with no argument, `cd <dir>` with one |
|
||||
| `c2p` | fzf-pick a `.hbs` template under `~/.config/code2prompt` and run `code2prompt --template` |
|
||||
| `cd` | `builtin cd`. If that fails, `zoxide query` the argument. Every successful cd is recorded with `zoxide add` |
|
||||
| `clear` | Prints `ESC[2J ESC[3J ESC[1;1H` to clear the screen and kitty scrollback, then re-pins the prompt if `FISH_BOTTOM_PROMPT=1`. Falls back to `command clear` when not interactive |
|
||||
| `clip-last` | Re-runs `$history[1]`, pipes the output to `cpy`, and sends a `notify-send` notification |
|
||||
| `cp-appid` | fzf-pick a `.desktop` app ID and copy it with `wl-copy` (desktop helper in `~/.local/bin`) |
|
||||
| `czs` | chezmoi sync: `chezmoi status`, `chezmoi re-add` of drifted files, commit the source repo, then `git pull --rebase --autostash` and `git push` if ahead. Optional targets scope it (for example `czs ~/.config/fish`). Messages print with a `chs:` prefix |
|
||||
| `extract_agents <dir>` | Copies every `AGENTS.md` under the current tree into `<dir>`, preserving paths |
|
||||
| `fab` | fzf-pick a Fabric pattern from `~/.config/fabric/pattern_explainations.json` (description in the preview, <kbd>ctrl-/</kbd> toggles it) and run it, feeding piped stdin if any |
|
||||
| `fish_title` | Terminal title: `prompt_pwd`, or `<host (10 chars)>:<pwd>` over SSH |
|
||||
| `fish_user_key_bindings` | Vi mode plus the custom binds above |
|
||||
| `gdc` | `gum confirm`, then `git reset --hard HEAD` and `git clean -fd` |
|
||||
| `gh-sonr-org-migrate` | Script body (see the warning below) that moves every repo from `*sonr*` GitHub orgs into `sonr-io` and deletes the emptied orgs |
|
||||
| `ghg <repo>` | `ghg-clone <repo>` (ghq get), cd into the clone, `clear`, `onefetch` |
|
||||
| `ghn <name>` | Runs `~/.local/bin/ghn` to create and clone a private repo, then cds into it |
|
||||
| `gho` | `tv ghq-repos --inline` (repo/vault picker); returns if nothing was picked, else cds into the result, `clear`, and `onefetch` inside git repos |
|
||||
| `git-summary [flags]` | `code2prompt` over the repo root, including only `AGENTS.md` files, using `~/.config/code2prompt/agents-md.hbs`. Extra flags pass through |
|
||||
| `gtm [repo]` | Migrates GitHub repos to a prad.codes (Gitea) org with `tea repos migrate`. With no argument, fzf multi-selects from `gh repo list`. You pick the target org and migration options (wiki, issues, labels, pull-requests, releases, milestones, lfs, mirror) with gum, private repos stay private, and it offers to clone the results with `ghg-clone`. Fish only |
|
||||
| `launch_omp_livediff_overlay` | Uses `kitty @` to overlay `omp` on the current window with a `livediff` vsplit beside it. Needs `KITTY_LISTEN_ON` |
|
||||
| `lc-elir [root]` | fzf multi-select numbered LeetCode solution files (`1234.slug.js`/`.ts`) and run `omp -p "/leetcode-eli5 <file>"` on each |
|
||||
| `mdcp <url>` | `curl.md <url>`, copy the result with `cpy`, and preview it with `mdfried` |
|
||||
| `mdp` | fzf-pick a Markdown file up to 3 levels deep (mdfried preview) and open it in `mdfried` |
|
||||
| `nvm` | nvm.fish: `install`, `use`, `list`, `list-remote`, `current`, `uninstall`. Reads `.nvmrc`/`.node-version` |
|
||||
| `y` | yazi with `--cwd-file`, then cd to the directory yazi exited in |
|
||||
| `yy` | Same as `y`. Used by the <kbd>ctrl-f</kbd> bind |
|
||||
|
||||
Functions defined inside `conf.d/` and `config.fish` rather than `functions/`: `q` (20-aliases), `terminal_title` (50-terminal-title), the `pnpmf*` helpers and `__pnpm_pick_pkg` (pnpm-filter), the `_nvm_install`/`_nvm_update`/`_nvm_uninstall` event handlers (nvm), and `starship_transient_prompt_func`, `starship_transient_rprompt_func`, and `_atuin_ai_question_mark` (config.fish).
|
||||
|
||||
> [!WARNING]
|
||||
> **gh-sonr-org-migrate**
|
||||
>
|
||||
> `functions/gh-sonr-org-migrate.fish` is a script, not a function definition. Running `gh-sonr-org-migrate` in fish autoloads the file, which runs the whole fish migration flow. Because the file defines no function of that name, fish then falls through to the bash port at `~/.local/bin/gh-sonr-org-migrate` and starts a second run. Cancel the second run at its first `gum` prompt, or call the bash script by its full path.
|
||||
@@ -0,0 +1,477 @@
|
||||
# Scripts
|
||||
|
||||
The shell-agnostic executables in ~/.local/bin — usage, behavior, and dependencies for each.
|
||||
|
||||
`dot_local/bin/` holds standalone `sh`, `bash`, and `python3` executables. The `executable_` prefix is a chezmoi attribute that sets the executable bit and is dropped from the target name, so `dot_local/bin/executable_pj` becomes `~/.local/bin/pj`. bash, zsh, and fish all put `~/.local/bin` on `PATH`, so every shell runs the same implementation.
|
||||
|
||||
This page covers the general-purpose scripts. The desktop scripts in the same directory are documented with their compositor:
|
||||
|
||||
- `cp-appid`: fzf-pick a `.desktop` app ID and copy it with `wl-copy`. Desktop roles only.
|
||||
- `omarchy-*`: [Hyprland](../desktop/hyprland.md)
|
||||
|
||||
## Why some helpers are shell functions
|
||||
|
||||
A script runs as a child process, and a child cannot change its parent shell's working directory or read the parent's in-memory history. Helpers that need to do either are therefore defined as shell functions, ported three times: `fish/functions/*.fish`, `bash/functions/*.bash`, and `zsh/functions/*.zsh`.
|
||||
|
||||
| Helper | Why it must be a function |
|
||||
| --- | --- |
|
||||
| `yy` (and fish's `y`) | cds into the directory yazi exited in |
|
||||
| `c` | cds when given an argument |
|
||||
| `cd` | Replaces the `cd` builtin with a zoxide fallback |
|
||||
| `ghg`, `ghn`, `gho` | cd into a repo that was picked or cloned |
|
||||
| `clip-last` | Reads the shell's own history (`$history[1]` in fish, `fc` in bash/zsh) |
|
||||
|
||||
For `ghg` and `ghn`, the work lives in a script that prints a directory on stdout (and everything else on stderr). The shell function captures that path and cds into it. `ghg`'s script is named `ghg-clone` because an unrelated cargo binary already uses the name `ghg`. `gho` has no script: the function reads the path from `tv ghq-repos` ([television](../tools/television.md#ghq-repos)).
|
||||
|
||||
Several scripts below also exist as fish functions of the same name (`ai`, `c2p`, `extract_agents`, `fab`, `gdc`, `git-summary`, `lc-elir`, `mdcp`, `mdp`, `launch_omp_livediff_overlay`, `gh-sonr-org-migrate`). In fish the function runs instead of the script. Both versions behave the same. See [fish functions](fish.md#functions).
|
||||
|
||||
## Overview
|
||||
|
||||
| Script | Language | One line |
|
||||
| --- | --- | --- |
|
||||
| [`ai`](#ai) | sh | Pick an AI CLI with gum and launch it |
|
||||
| [`atuin-pick`](#atuin-pick) | python3 | atuin history picker for a kitty or tmux split |
|
||||
| [`brave-new-tab`](#brave-new-tab) | sh | Open a URL in a new Brave Origin tab |
|
||||
| [`c2p`](#c2p) | sh | code2prompt with an fzf-picked template |
|
||||
| [`extract_agents`](#extract_agents) | sh | Copy all `AGENTS.md` files into a directory tree |
|
||||
| [`fab`](#fab) | sh | fzf picker for Fabric patterns |
|
||||
| [`gdc`](#gdc) | sh | Discard all git changes after confirmation |
|
||||
| [`gh-sonr-org-migrate`](#gh-sonr-org-migrate) | bash | Consolidate `*sonr*` GitHub orgs into `sonr-io` |
|
||||
| [`ghg-clone`](#ghg-clone) | sh | `ghq get` and print the clone path |
|
||||
| [`ghn`](#ghn) | sh | Create a private repo, clone it, print the path |
|
||||
| [`git-summary`](#git-summary) | sh | Aggregate a repo's `AGENTS.md` files with code2prompt |
|
||||
| [`gop`](#gop) | sh | Open the current repo's web page |
|
||||
| [`kitty-day-save`](#kitty-day-save) | bash | Save kitty's daily session right before shutdown/reboot |
|
||||
| [`launch_omp_livediff_overlay`](#launch_omp_livediff_overlay) | sh | omp overlay plus a livediff split in kitty |
|
||||
| [`lc-elir`](#lc-elir) | sh | Run `/leetcode-eli5` via omp on picked solutions |
|
||||
| [`mandible-pick`](#mandible-pick) | bash | fzf-pick a command, then open it in mandible |
|
||||
| [`mdcp`](#mdcp) | sh | Fetch a URL as Markdown, copy it, preview it |
|
||||
| [`mdp`](#mdp) | sh | fzf Markdown picker with mdfried preview |
|
||||
| [`mtime-sort`](#mtime-sort) | sh + perl | Sort path lines newest-first by mtime |
|
||||
| [`omp-session`](#omp-session) | python3 | Resume or start omp for the current repo; backend of the `omp-sessions` cable |
|
||||
| [`pj`](#pj) | bash | Task runner across every project task source, on a tv cable |
|
||||
| [`projects-sync`](#projects-sync) | bash | Symlink every `~/Code` repo into `~/Projects` |
|
||||
| [`pj-palette`](#pj-palette) | bash | pj's tasks plus quick actions as a tmux-palette source |
|
||||
| [`tmux-sessions`](#tmux-sessions) | bash | Session/window/zoxide switcher as a tmux-palette source |
|
||||
| [`yazi-nvim-open`](#yazi-nvim-open) | sh | yazi opener that targets the host Neovim |
|
||||
|
||||
## ai
|
||||
|
||||
```sh
|
||||
ai
|
||||
```
|
||||
|
||||
Shows `gum choose --header 'AI CLI'` with `claude`, `opencode`, `codex`, `hermes`, and `fractal`, then `exec`s the choice. `claude` runs as `claude --dangerously-skip-permissions`; the others run as the bare binary name. Esc or Ctrl-C exits 0.
|
||||
|
||||
**Needs:** `gum` and the chosen CLI.
|
||||
|
||||
## atuin-pick
|
||||
|
||||
```sh
|
||||
atuin-pick
|
||||
```
|
||||
|
||||
Opens atuin's interactive search (`atuin search -i --filter-mode directory`), limited to history from the current directory. It then `exec`s an interactive `fish`. If you picked a command, the new fish runs `echo '❯ <cmd>'; <cmd>` via `-C` (`--init-command`), so aliases resolve, a `cd` persists, and the prompt appears below the output. Esc starts a plain fish.
|
||||
|
||||
It is written for launch contexts where atuin's shell init never ran. It runs `atuin` from `PATH` and seeds `ATUIN_SESSION` from `atuin uuid` if unset.
|
||||
|
||||
**Launched by:** <kbd>ctrl+shift+p</kbd> in kitty. `kitty.conf` opens it in a horizontal split (`launch_hs atuin-pick`). Under the kitty-tmux profile, `tmux.conf` runs it with `tmux split-window -v -l 25%` in the current pane's directory. See [kitty](../terminal/kitty.md) and [atuin](atuin.md).
|
||||
|
||||
**Needs:** `python3`, `atuin`, `fish`.
|
||||
|
||||
## brave-new-tab
|
||||
|
||||
```sh
|
||||
brave-new-tab <url>
|
||||
```
|
||||
|
||||
Runs `brave-origin --new-tab <url>` detached with `setsid -f`. With Brave Origin running, the URL opens as a tab in its last active window; otherwise Brave Origin starts with it. Exits 2 unless given exactly one argument.
|
||||
|
||||
A URL without a scheme gets one from its host (port and path ignored): `localhost`, `*.localhost`, `*.local`, and `127.*` get `http://`, everything else `https://`. URLs containing `://`, and `about:` URLs, pass through unchanged.
|
||||
|
||||
| Argument | Opens |
|
||||
| --- | --- |
|
||||
| `example.com/path` | `https://example.com/path` |
|
||||
| `localhost:3000` | `http://localhost:3000` |
|
||||
| `printer.local` | `http://printer.local` |
|
||||
| `http://example.com` | `http://example.com` |
|
||||
|
||||
**Needs:** `brave-origin` (`brave-origin-bin`), `setsid` (util-linux).
|
||||
|
||||
## c2p
|
||||
|
||||
```sh
|
||||
c2p
|
||||
```
|
||||
|
||||
Lists `*.hbs` files under `~/.config/code2prompt` with `fd`, lets you pick one with fzf, and `exec`s `code2prompt --template <file>`.
|
||||
|
||||
**Needs:** `fd`, `fzf`, `code2prompt`.
|
||||
|
||||
## extract_agents
|
||||
|
||||
```sh
|
||||
extract_agents <output-dir>
|
||||
```
|
||||
|
||||
Creates `<output-dir>` and copies every `AGENTS.md` below the current directory into it with `cp --parents`, keeping the relative paths.
|
||||
|
||||
**Needs:** `fd`, GNU `cp` (`--parents`).
|
||||
|
||||
## fab
|
||||
|
||||
```sh
|
||||
fab
|
||||
some-command | fab
|
||||
```
|
||||
|
||||
Reads `~/.config/fabric/pattern_explainations.json`. fzf lists pattern names, the preview pane (right, 60%, wrapped) shows each description, and <kbd>ctrl-/</kbd> toggles the preview. The picked pattern runs as `fabric-ai --pattern <name>`, falling back to `fabric` if `fabric-ai` is not installed. Piped stdin is buffered to a temp file and fed to the pattern; the temp file is removed on exit.
|
||||
|
||||
**Needs:** `jq`, `fzf`, `fabric-ai` or `fabric`, and the pattern JSON.
|
||||
|
||||
## gdc
|
||||
|
||||
```sh
|
||||
gdc
|
||||
```
|
||||
|
||||
Asks `gum confirm "Discard all uncommitted changes? This is irreversible."`. On yes, runs `git reset --hard HEAD` and `git clean -fd`.
|
||||
|
||||
**Needs:** `gum`, `git`.
|
||||
|
||||
## gh-sonr-org-migrate
|
||||
|
||||
```sh
|
||||
gh-sonr-org-migrate
|
||||
```
|
||||
|
||||
A bash port of `fish/functions/gh-sonr-org-migrate.fish`, with the same flow:
|
||||
|
||||
1. **Preflight**
|
||||
|
||||
Checks that `gh`, `gum`, and `jq` exist and that `gh auth status` succeeds.
|
||||
|
||||
2. **Discover**
|
||||
|
||||
Lists your GitHub orgs whose login contains `sonr`, excluding the target `sonr-io`. You pick which to migrate with `gum choose --no-limit`.
|
||||
|
||||
3. **Transfer**
|
||||
|
||||
For each repo in each org, runs `gh api -X POST repos/<org>/<repo>/transfer -f new_owner=sonr-io`. If the name already exists in `sonr-io`, `gum input` asks for a new name (default `<org>-<repo>`). An empty name skips the repo.
|
||||
|
||||
4. **Settle**
|
||||
|
||||
Waits 30 seconds (`gum spin`), because GitHub transfers are asynchronous.
|
||||
|
||||
5. **Delete**
|
||||
|
||||
For every selected org that had no failed transfers and now has zero repos, asks `gum confirm` and then `gh api -X DELETE orgs/<org>`.
|
||||
|
||||
**Needs:** `gh` authenticated as owner of every org involved, `gum`, `jq`.
|
||||
|
||||
> [!WARNING]
|
||||
> In fish, run this script by its full path (`~/.local/bin/gh-sonr-org-migrate`). The fish file of the same name is a script body with no function in it, so typing just the name runs the fish flow and then this script. See [fish](fish.md#functions).
|
||||
|
||||
## ghg-clone
|
||||
|
||||
```sh
|
||||
ghg-clone <repo>
|
||||
```
|
||||
|
||||
Runs `ghq get <repo>`, with its output sent to stderr. It then works out the on-disk path: it strips the scheme, any `user@`, the scp-style colon, and a trailing `.git`, and prefixes `github.com/` when the input has no host. It checks that `$(ghq root)/<host>/<user>/<repo>` exists, runs `zoxide add` on it if zoxide is installed, and prints the path.
|
||||
|
||||
Accepts `https://…`, `ssh://…`, `git@host:user/repo`, `host/user/repo`, or `user/repo`.
|
||||
|
||||
**Mirrors.** After the clone, it sets up a [prad.codes](../tools/git.md) mirror when the repo has none. All of it talks on stderr and never fails the clone:
|
||||
|
||||
| Cloned from | Mirror | Skipped when |
|
||||
| --- | --- | --- |
|
||||
| `github.com/<owner>/<name>` | Pull mirror into a prad.codes org, every 8h (`tea repos migrate --mirror --mirror-interval 8h`, authenticated with `gh auth token`, private if the GitHub repo is). `gum choose` picks the org, preselected from GitHub's primary language: Go → `go`, Python → `py`, Rust → `rs`, Dart → `dart`, TeX → `tex`, JS/TS/Astro/Svelte/Vue/HTML/CSS → `js`, Markdown/MDX → `md`, anything else → `env`. Esc skips | You are not an admin of the GitHub repo, or a prad.codes repo already pulls from it (`original_url`) |
|
||||
| `prad.codes/<org>/<name>` | Push mirror to `github.com/<you>/<name>` on every push and every 8h, with a first sync right away. After a `gum confirm`, it creates the GitHub repo (same visibility) if missing; an existing one is overwritten by the mirror pushes, which the prompt says | The repo is itself a pull mirror, or already has a push mirror |
|
||||
|
||||
Both mirrors store your `gh` OAuth token in prad.codes as the remote credential. Without a terminal (no `gum` prompt), nothing is mirrored.
|
||||
|
||||
**Used by:** the `ghg` shell function, which cds into the path, clears the screen, and runs `onefetch`. The fish function `gtm` also uses it to clone migrated repos.
|
||||
|
||||
**Needs:** `ghq` (`GHQ_ROOT=~/Code`, exported by fish, zsh, and bash), optional `zoxide`. Mirrors need `gh`, `tea` (logged in to prad.codes), `jq`, and `gum`; without any of them the step is skipped.
|
||||
|
||||
## ghn
|
||||
|
||||
```sh
|
||||
ghn <repo-name>
|
||||
```
|
||||
|
||||
Creates a new **private** repo and clones it:
|
||||
|
||||
- **prad.codes** (Gitea): pick an org from `tea organizations list`, then `tea repos create --private` and `ghq get https://prad.codes/<org>/<name>`.
|
||||
- **github.com**: pick the owner `prdlk` or `wltbs`, then `gh repo create <owner>/<name> --private` and `ghq get`.
|
||||
|
||||
You pick the host with `gum choose`. The script prints the clone directory, and the `ghn` shell function cds into it.
|
||||
|
||||
**Needs:** `gum`, `ghq`, and `tea` or `gh`.
|
||||
|
||||
## git-summary
|
||||
|
||||
```sh
|
||||
git-summary [code2prompt flags…]
|
||||
```
|
||||
|
||||
From anywhere inside a git repo, runs `code2prompt <repo-root> --include AGENTS.md --include "**/AGENTS.md" --template ~/.config/code2prompt/agents-md.hbs`. Extra flags such as `--output-file` or `--tokens` are passed through.
|
||||
|
||||
**Needs:** `git`, `code2prompt`, and the `agents-md.hbs` template.
|
||||
|
||||
## gop
|
||||
|
||||
```sh
|
||||
gop # origin, else upstream, else first remote
|
||||
gop upstream # a named remote
|
||||
gop owner/repo # github.com/owner/repo
|
||||
gop <url> # any https/ssh/scp remote URL
|
||||
```
|
||||
|
||||
Opens a repo's web page for any forge whose URL layout is `https://<host>/<owner>/<repo>`, such as github.com and prad.codes. It reduces any remote form to `<host>/<owner>/<repo>`: it drops credentials, drops the port on `ssh://` and `git://` remotes, keeps the port and plain `http` on `http://` remotes, and strips `.git`. It then runs `$BROWSER` (default `xdg-open`) on the result.
|
||||
|
||||
**Needs:** `git`, a browser or `xdg-open`.
|
||||
|
||||
## kitty-day-save
|
||||
|
||||
```sh
|
||||
kitty-day-save # hold a logind delay lock, flush on shutdown, exit
|
||||
kitty-day-save --now # flush every running kitty immediately
|
||||
```
|
||||
|
||||
Run by `kitty-day-save.service` (`dot_config/systemd/user/`, `WantedBy=graphical-session.target`, `Restart=always` after 10 s). It wraps itself in `systemd-inhibit --what=shutdown --mode=delay` and waits on `gdbus monitor` for login1's `PrepareForShutdown (true,)`. logind sends that before anything is killed and waits for the lock (`InhibitDelayMaxSec`, 5 s by default), so every kitty still has all its windows. It then sends `kitten day_session.py flush` over remote control to each `@kitty-<pid>` socket in `/proc/net/unix` (3 s timeout each) and exits, which releases the lock. The kitty that owns today's session saves it and holds further saves for 60 s; other kitties ignore the flush. See [kitty daily sessions](../terminal/kitty.md#daily-sessions).
|
||||
|
||||
**Needs:** `systemd-inhibit`, `gdbus`, `kitten`. Linux desktop/laptop roles only (`.chezmoiignore.tmpl`).
|
||||
|
||||
## launch_omp_livediff_overlay
|
||||
|
||||
```sh
|
||||
launch_omp_livediff_overlay
|
||||
```
|
||||
|
||||
Inside kitty with remote control enabled, runs `kitty @ launch --type=overlay-main --cwd=current omp`, then opens `livediff` in a `vsplit` next to that window with `--keep-focus`. It relies on `$KITTY_LISTEN_ON` rather than a hard-coded socket, because kitty appends `-PID` to `listen_on` socket names. It exits with an error if the variable is unset.
|
||||
|
||||
**Needs:** kitty with `allow_remote_control`/`listen_on` ([kitty](../terminal/kitty.md)), `omp` ([AI agents](../ai/README.md)), `livediff`.
|
||||
|
||||
## lc-elir
|
||||
|
||||
```sh
|
||||
lc-elir [root]
|
||||
```
|
||||
|
||||
Finds numbered LeetCode solution files (`^\d+\..+\.(js|ts)$`, for example `1365.some-slug.js`) under `root` (default `.`). fzf multi-selects them, showing the last three path segments with a `bat` preview of the first 40 lines. Each pick runs `omp -p "/leetcode-eli5 <file>"`.
|
||||
|
||||
**Needs:** `fd`, `fzf`, `bat`, `omp`, and the `/leetcode-eli5` omp command.
|
||||
|
||||
## mandible-pick
|
||||
|
||||
```sh
|
||||
mandible-pick
|
||||
```
|
||||
|
||||
`mandible` (installed with cargo, `~/.cargo/bin`) needs a tool to open, so this asks for one first. fzf lists the executables installed in the `PATH` directories, without shell builtins, keywords, or aliases. <kbd>enter</kbd> opens the highlighted command. If the query contains a space (`git remote add`) or matches nothing, <kbd>enter</kbd> uses it exactly as typed, so mandible opens at that subcommand path. Then it `exec`s `mandible <tool> [subcommand…]`. <kbd>esc</kbd> exits quietly. The command list is built with a bash loop rather than GNU `find -printf`.
|
||||
|
||||
**Used by:** the tmux-palette **mandible** item (alias `man`), which runs it in a popup. See [tmux](../terminal/tmux.md#command-palette).
|
||||
|
||||
**Needs:** `mandible`, `fzf` 0.51+ (`--with-shell`, `transform`, `accept-or-print-query`).
|
||||
|
||||
## mdcp
|
||||
|
||||
```sh
|
||||
mdcp <url>
|
||||
```
|
||||
|
||||
Fetches the URL as Markdown with `curl.md`, copies it with `wl-copy`, then pastes it back into `mdfried` for a rendered preview.
|
||||
|
||||
**Needs:** `curl.md`, `mdfried`, and `wl-clipboard`.
|
||||
|
||||
## mdp
|
||||
|
||||
```sh
|
||||
mdp
|
||||
```
|
||||
|
||||
Lists `*.md` files up to 3 directories deep with `fd`. fzf shows an `mdfried` preview (right, 60%, wrapped), and the pick opens in `mdfried`.
|
||||
|
||||
**Needs:** `fd`, `fzf`, `mdfried`.
|
||||
|
||||
## projects-sync
|
||||
|
||||
```sh
|
||||
projects-sync
|
||||
```
|
||||
|
||||
Mirrors every repo under the ghq root (`$GHQ_ROOT`, default `~/Code`, laid out `<host>/<owner>/<repo>`) as `~/Projects/<repo>` → the repo. Repos with the same name under different owners become `<owner>-<repo>`. Links pointing into `~/Code` whose repo is gone are removed; real files, real directories, and links pointing elsewhere in `~/Projects` are never touched.
|
||||
|
||||
Run by `projects-sync.timer` (`dot_config/systemd/user/`, 30 s after login and every 5 minutes), which [`30-user-services`](../chezmoi/scripts.md#30-user-services) enables. ghq clones land two levels below `~/Code`, out of reach of a non-recursive `.path` unit, hence the poll.
|
||||
|
||||
**Needs:** GNU `find`. Linux desktop/laptop roles only (`.chezmoiignore.tmpl`).
|
||||
|
||||
## mtime-sort
|
||||
|
||||
```sh
|
||||
… | mtime-sort [--repo]
|
||||
```
|
||||
|
||||
Reads lines on stdin and prints them newest-first by the mtime of each line's last tab-separated field (the whole line when it has no tab). With `--repo`, it stats `<path>/.git/index` first, so a repo sorts by its last git activity. Lines whose path does not exist are dropped. Ties keep input order.
|
||||
|
||||
**Used by:** every custom [television](../tools/television.md) cable except `agents` and `omp-sessions`, and `pj --list`. tv layers match quality and frecency on top of this order.
|
||||
|
||||
**Needs:** `perl`.
|
||||
|
||||
## omp-session
|
||||
|
||||
```sh
|
||||
omp-session
|
||||
```
|
||||
|
||||
Starts or resumes omp for the current git repo by fixed rules, so <kbd>ctrl-a</kbd> never asks when the answer is obvious.
|
||||
|
||||
| HEAD | Does |
|
||||
| --- | --- |
|
||||
| Default branch | Resumes the newest session on it when that session was written less than 3 hours ago. Otherwise opens the `omp-sessions` [television](../tools/television.md#omp-sessions) cable over all of the repo's sessions; <kbd>enter</kbd> resumes the pick, <kbd>esc</kbd> returns to the prompt. With no sessions at all it starts a new one |
|
||||
| Any other branch | Resumes the newest session on that branch, or starts a new one |
|
||||
| Detached | Opens the `omp-sessions` cable (a new session when there are none) |
|
||||
| Outside a git repo | Plain `omp` |
|
||||
|
||||
Resuming runs `omp --resume <session file>`; omp switches to the session's own cwd. `omp-session --new` runs plain `omp`; it is the cable's <kbd>ctrl-n</kbd> action and marks `OMP_SESSION_STATE` like a resume does, so the prompt is not moved after a new session.
|
||||
|
||||
**Sessions.** Every `*/*.jsonl` under `$PI_CODING_AGENT_DIR/sessions` (default `~/.omp/agent/sessions`) whose `session` header `cwd` is the worktree root or below it, excluding worktrees nested inside it. Session age is the file's mtime (the last write).
|
||||
|
||||
**Branches.** omp does not record the git branch. A session's branch is the one HEAD was on when the file was last written, replayed from the worktree's `git reflog` (`checkout: moving from A to B`, `Branch: renamed`, `rebase (finish): returning to`). Sessions older than the oldest reflog move belong to the branch that move left; with no moves they all belong to the current branch. The default branch is `origin/HEAD`, else `init.defaultBranch`, `main`, or `master`, whichever exists.
|
||||
|
||||
**Entry points.** The cable calls back into the script:
|
||||
|
||||
| Command | Does |
|
||||
| --- | --- |
|
||||
| `omp-session --list` | Prints `<age> <branch> <title>[ · <subdir>]<TAB><session file>` per session, newest first. The title is omp's session title, else the first user message |
|
||||
| `omp-session --preview FILE` | Title, last-write time, cwd, then the text of every user and assistant message (thinking, tool calls, and tool results skipped) |
|
||||
| `omp-session --resume FILE` | Writes `ran` to `$OMP_SESSION_STATE` when set, then `exec omp --resume FILE` (enter) |
|
||||
|
||||
**Prompt redraw.** The launcher runs `tv omp-sessions --inline` with `OMP_SESSION_STATE` set to a temp file. When the picker is cancelled (no `ran`), it prints `\033[A` to `/dev/tty` so the shell redraws the prompt in place; the key bindings just repaint.
|
||||
|
||||
**Launched by:** <kbd>ctrl-a</kbd> in fish and zsh. <kbd>ctrl-n</kbd> at the prompt runs `omp` directly, not this script.
|
||||
|
||||
**Needs:** `python3`, `git`, `omp`, `tv`.
|
||||
|
||||
## pj
|
||||
|
||||
```sh
|
||||
pj [extra args…]
|
||||
```
|
||||
|
||||
A task runner that searches every task source in the project and lets you pick one in the `pj` [television](../tools/television.md#pj) cable.
|
||||
|
||||
**Sources.** Each is listed only when its runner is installed:
|
||||
|
||||
| Source | Found in | Runner |
|
||||
| --- | --- | --- |
|
||||
| npm scripts | `package.json` | package manager from `packageManager`, else from the lockfile (`bun.lock[b]`, `pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`, searched upward), else `npm`, then `<pm> run` |
|
||||
| Make | `GNUmakefile`, `makefile`, `Makefile` | `make`. Targets come from a text parse of rules and `.PHONY`; `make -p` is avoided because it would run `$(shell …)` |
|
||||
| just | `justfile`, `.justfile`, `Justfile`, `JUSTFILE` | `just` |
|
||||
| mise | `mise.toml`, `.mise.toml`, `mise/config.toml`, `.mise/config.toml`, `.config/mise/config.toml`, or a `mise-tasks`/`.mise/tasks`/`mise/tasks` dir | `mise run`. Hidden tasks are skipped, and tasks inherited from parent directories are filtered out |
|
||||
| devbox | `devbox.json` `shell.scripts` | `devbox run` |
|
||||
| poe | `pyproject.toml` `[tool.poe.tasks]` | `poe`, else `uv run poe` |
|
||||
| pdm | `[tool.pdm.scripts]` (skips `_*` and `post_*`) | `pdm run` |
|
||||
| rye | `[tool.rye.scripts]` | `rye run` |
|
||||
| taskipy | `[tool.taskipy.tasks]` | `task`, else `uv run task` |
|
||||
| hatch | `[tool.hatch.envs.<env>.scripts]` as `env:name` | `hatch run` |
|
||||
| console scripts | `[tool.poetry.scripts]`, `[project.scripts]` | `poetry run` for Poetry projects, else `uv run` |
|
||||
|
||||
**Scanning.** Walks from `$PWD` up to the git toplevel, inclusive. Outside a repo it stops at the first directory that produced tasks.
|
||||
|
||||
**Picker.** `pj` writes the records to a temp file and runs `tv pj --inline --source-command "cat <tmp>" --input-header <project root>`. Rows are tagged with the tool (`npm`, `pnpm`, `bun`, `make`, `just`, `mise`, `poe`, `py`, …), so typing a tool name filters to it. A directory column appears when more than one project contributed tasks. Tasks are sorted by their manifest's mtime, newest first, through `mtime-sort`. The preview shows the task body: the npm script string, the Make recipe, `just --show`, `mise tasks info`, the devbox script, or the pyproject entry.
|
||||
|
||||
**Entry points.** The cable calls back into the script:
|
||||
|
||||
| Command | Does |
|
||||
| --- | --- |
|
||||
| `pj --list` | Prints tab-separated records: display, kind, target, root, runner, manifest |
|
||||
| `pj --preview KIND TARGET ROOT FILE` | Prints the task body for the preview pane |
|
||||
| `pj --run KIND TARGET ROOT RUNNER` | Runs the task (enter) |
|
||||
|
||||
**Run.** cds into the task's directory and `exec`s the runner. Extra arguments given to `pj` travel to the task through `$PJ_EXTRA` (shell-quoted), with `--` inserted for `npm run`, `mise`, and `devbox`. Tasks named `dev`, `start`, `serve`, `watch`, or namespaced variants like `dev:web` are wrapped in `openlogs` (found on `PATH`, via `mise which`, or in mise's node installs) for a live log tail. Without openlogs they run unwrapped, with a note.
|
||||
|
||||
**Env.** `PJ_QUIET=1` suppresses the "no task sources found" error (exit status stays 1). The <kbd>down</kbd> bindings use it. `PJ_STATE=FILE` makes `pj` write `open` to `FILE` before launching the picker, and `pj --run` writes `ran`; the file stays empty when there are no task sources. The key bindings read it to tell no tasks, a cancelled picker, and a task that printed output apart and redraw the prompt to match. `pj` itself does no cursor handling, so typing `pj` behaves like any command.
|
||||
|
||||
**Launched by:** <kbd>ctrl-p</kbd>, and <kbd>down</kbd> on an empty prompt, in fish, zsh, and bash.
|
||||
|
||||
**Needs:** `bash`, `tv`, `mtime-sort`, `jq`, `python3` 3.11+ (for `tomllib`), plus whichever runners the project uses.
|
||||
|
||||
## pj-palette
|
||||
|
||||
```sh
|
||||
pj-palette
|
||||
pj-palette --run KIND TARGET ROOT RUNNER
|
||||
pj-palette --cmd ROOT CMD…
|
||||
pj-palette --bg NAME [ROOT CMD…]
|
||||
pj-palette --omp
|
||||
```
|
||||
|
||||
The source of the **Project Tasks** [tmux command palette](../terminal/tmux.md#command-palette) (`palettes/tasks.json`). Open it with tmux `prefix t`, Ghostty <kbd>ctrl+shift+p</kbd> or <kbd>ctrl+shift+space</kbd>, or the "Project Tasks" item in the main palette.
|
||||
|
||||
With no arguments it reads the active pane's directory (`tmux display -p '#{pane_current_path}'`) and prints palette items as JSON, grouped by category:
|
||||
|
||||
| Group | Items | Shown when |
|
||||
| --- | --- | --- |
|
||||
| Running | Every background task session still alive (any project), by session name | A long-running item was started and not stopped |
|
||||
| Quick | `<pm> install` (alias `install`, `i`), `<pm> run dev` (`dev`) | `package.json` at the project root. The package manager comes from `packageManager`, then the lockfile, as in `pj` |
|
||||
| Quick | `uv sync` (`sync`), `uv run python` (`py`, `repl`) | `pyproject.toml` and `uv` installed |
|
||||
| Quick | `make` (default target; `m`, `build`) | A Makefile and `make` |
|
||||
| Quick | `go run .`, `cargo run` | `go.mod` / `Cargo.toml` and the toolchain |
|
||||
| Quick | `docker compose up` (`up`, `compose`) | `compose.y(a)ml` or `docker-compose.y(a)ml` at the project root and `docker` |
|
||||
| Tasks: `<tool>` | Every record from `pj --list`: npm/bun/pnpm/yarn scripts, Make, just, mise, devbox, pyproject task tables and console scripts | Whatever `pj` finds walking up to the git root |
|
||||
|
||||
The project root is the git toplevel, else the pane's directory.
|
||||
|
||||
**Run.** One-off items open a full-width split along the bottom of the window (`split-window -v -f -l 25%`), 25% of its height, in the task's directory. The command is passed to `split-window` as separate arguments, so no shell reparses it. `--run` calls `pj --run`, which keeps pj's `openlogs` wrapping of `dev`/`start`/`serve`/`watch` tasks, and `--cmd` runs a quick action. While the command runs, <kbd>ctrl-c</kbd> stops only the command (the script traps `SIGINT`), so the output stays. Once the command exits, the script prints `[exit N] enter or ctrl-c to close`, and <kbd>enter</kbd> or <kbd>ctrl-c</kbd> closes the pane; other keys are ignored.
|
||||
|
||||
**Background.** Long-running items, marked `· background`, are `<pm> run dev`, `docker compose up`, and pj tasks named `dev`/`start`/`serve`/`watch`/`preview` or with one of those as a `:` segment (`dev:web`, `api:dev`). They run through `--bg` in a detached session named `<session>:<tool-and-command>` (`leetcode:bun-run-dev`, `leetcode:docker-compose-up`), shown in a rounded 90%×80% popup attached to it. <kbd>q</kbd> detaches the popup and leaves the task running: the session's `key-table` is `pj-task`, which binds only `q` and <kbd>ctrl-c</kbd>, so other keys reach the task instead of root-table bindings (prefix bindings still work). <kbd>ctrl-c</kbd> runs `confirm-before` (`Stop <session>? (y/n)`); <kbd>y</kbd> sends ctrl-c to the task, which stops it and ends the session, closing the popup, and any other key cancels. If the task exits on its own, the `[exit N]` prompt keeps its output until <kbd>enter</kbd>. Picking the item again, or its **Running** entry, reopens the popup instead of starting a second copy. The session has `status off`, `detach-on-destroy on`, and `@pj_task` set to the task's root, which is how the Running group finds it. Session names contain `:`, so the script targets them by id (`$N`).
|
||||
|
||||
**omp.** tmux `prefix a` (Ghostty <kbd>ctrl+shift+a</kbd>) runs `pj-palette --bg <session>:omp <pane cwd> omp`, so omp gets the same kind of background session and Running entry. Its popup docks in the bottom-right corner of the client, 35% wide and 60% tall. omp runs directly (no `[exit N]` prompt) and needs <kbd>q</kbd>, so its session uses the `pj-app` key table instead: <kbd>ctrl-c</kbd> hides the popup, <kbd>ctrl-q</kbd> kills the session (quits omp). `prefix a` inside any session with `@pj_task` also hides, which makes <kbd>ctrl+shift+a</kbd> a toggle. The popup border shows only the session name.
|
||||
|
||||
**omp palette.** `--omp` feeds `palettes/omp.json`, opened by the main palette's **omp** item. It lists every running `<session>:omp` across tmux sessions, with a green icon and `open`/`hidden` state: **This session** first (or a grey `not running · start in <cwd>` item that starts it), then **Running** for the other tmux sessions' agents, then a **Quit** item per session (`kill-session`).
|
||||
|
||||
**Needs:** `pj` and its dependencies, `jq`, tmux.
|
||||
|
||||
## tmux-sessions
|
||||
|
||||
```sh
|
||||
tmux-sessions
|
||||
tmux-sessions --new QUERY
|
||||
tmux-sessions --dir DIR
|
||||
```
|
||||
|
||||
The source of the **Sessions** [tmux command palette](../terminal/tmux.md#command-palette) (`palettes/sessions.json`), which replaced tmux-sessionx. Open it with tmux `prefix o`, Ghostty <kbd>ctrl+shift+o</kbd> or <kbd>super+enter</kbd>, or the "Sessions" item in the main palette.
|
||||
|
||||
With no arguments it prints palette items as JSON, grouped by category:
|
||||
|
||||
| Group | Items | Action |
|
||||
| --- | --- | --- |
|
||||
| Sessions | Every session but the current one, the client's last session first. Attached ones have a green icon | `switch-client` |
|
||||
| Windows | Every window of every session, as `<session>:<index> · <cwd>` | `switch-client` to that window |
|
||||
| Zoxide | `zoxide query -l` | `--dir` |
|
||||
| Config | Directories in `~/.config` that zoxide does not list | `--dir` |
|
||||
| Rename | One per session | `command-prompt` prefilled with the name |
|
||||
| Kill | One per session except the current one | `kill-session` |
|
||||
|
||||
pj-palette's background task sessions (`@pj_task`) are left out. Sessions are targeted by id, since names may contain `:`.
|
||||
|
||||
**`--new QUERY`** is the palette's `query` item, the typed text listed after the matches. It switches to the session named QUERY if there is one. Otherwise it starts a session named QUERY in QUERY itself if that is a directory (via `--dir`), else in `zoxide query QUERY`'s match (QUERY's words are separate keywords), else in tmux's default directory. Typed text that matches nothing therefore lands on the `query` item, the same as sessionx's zoxide mode.
|
||||
|
||||
**`--dir DIR`** switches to, or starts in DIR, the session named after DIR's basename with dots removed (sessionx's rule).
|
||||
|
||||
**Needs:** tmux, `jq`, `zoxide`.
|
||||
|
||||
## yazi-nvim-open
|
||||
|
||||
```sh
|
||||
yazi-nvim-open [vsplit|split|tabedit] <file>…
|
||||
```
|
||||
|
||||
yazi's `edit` opener. When run inside a Neovim terminal (`$NVIM` set), each file's absolute path goes to the **host** Neovim through `nvim --server "$NVIM" --remote-expr 'v:lua.EditFromYazi(mode, path)'` (defined in the nvim config's `yazi_session.lua`). Outside Neovim it `exec`s a normal `nvim`, and the split modes do nothing. Set `YAZI_OPEN_TRACE=<file>` to log each call.
|
||||
|
||||
**Used by:** `yazi.toml` (the `edit` opener) and `keymap.toml` (<kbd>ctrl-v</kbd> vsplit, <kbd>ctrl-x</kbd> split). See [yazi](../tools/yazi.md).
|
||||
|
||||
**Needs:** `nvim`, `realpath`.
|
||||
@@ -0,0 +1,91 @@
|
||||
# Starship
|
||||
|
||||
The cross-shell prompt — a minimal left prompt, a clock on the right, and a cyberdream palette.
|
||||
|
||||
[Starship](https://starship.rs) renders the prompt in fish, bash, and zsh from one config file.
|
||||
|
||||
| Source (repo) | Target |
|
||||
| --- | --- |
|
||||
| `dot_config/starship.toml` | `~/.config/starship.toml` |
|
||||
|
||||
The file is not a template and applies on every role. `starship` is in `.chezmoidata/packages.yaml` for pacman and is installed by `.chezmoiscripts/run_onchange_before_10-packages.sh.tmpl`.
|
||||
|
||||
## Shell integration
|
||||
|
||||
| Shell | Init |
|
||||
| --- | --- |
|
||||
| fish | `conf.d/40-tools.fish` runs `starship init fish`, then `config.fish` runs it again and calls `enable_transience` |
|
||||
| bash | `eval "$(starship init bash)"` in `~/.bashrc` |
|
||||
| zsh | `eval "$(starship init zsh)"` in `~/.zshrc`, plus a transient-prompt hook |
|
||||
|
||||
With transience in fish, past prompts in the scrollback collapse to the output of `starship_transient_prompt_func` (`starship module character`, the `❯` alone) and `starship_transient_rprompt_func` (`starship module time`). See [fish](fish.md#configfish).
|
||||
|
||||
zsh has no built-in transience, so `~/.zshrc` collapses past prompts itself, rendering the `transient` (`$character`) and `transient_right` (`$time`) entries under `[profiles]` with `starship prompt --profile`. It uses profiles rather than `starship module` because only `starship prompt` wraps color escapes in zsh's `%{…%}`; without them zsh miscounts the right prompt's width. zsh also gets starship's default `∙` continuation prompt (`PROMPT2`). See [bash and zsh](bash-zsh.md#zshrc).
|
||||
|
||||
## Layout
|
||||
|
||||
**~/.config/starship.toml**
|
||||
|
||||
```toml
|
||||
"$schema" = 'https://starship.rs/config-schema.json'
|
||||
palette = "cyberdream"
|
||||
|
||||
format = """
|
||||
$username\
|
||||
$hostname\
|
||||
$directory\
|
||||
$git_branch\
|
||||
$git_state\
|
||||
$git_status\
|
||||
$cmd_duration\
|
||||
$python\
|
||||
$character"""
|
||||
|
||||
right_format = """$time"""
|
||||
```
|
||||
|
||||
The left prompt is a single line with no line break before `$character`. Only the nine listed modules can appear; every other starship module is left out of `format`. `$username` and `$hostname` keep their defaults, so they appear only over SSH or as root.
|
||||
|
||||
## Modules
|
||||
|
||||
| Module | Format | Style | Notes |
|
||||
| --- | --- | --- | --- |
|
||||
| `directory` | default | `blue` | |
|
||||
| `git_branch` | `[$branch]($style)` | `bright-black` | Branch name only, no symbol or "on" |
|
||||
| `git_state` | `\([$state( $progress_current/$progress_total)]($style)\) ` | `bright-black` | For example `(REBASING 2/5)` |
|
||||
| `git_status` | `[[(*$conflicted$untracked$modified$staged$renamed$deleted)](218) ($ahead_behind$stashed)]($style)` | `cyan` | See below |
|
||||
| `cmd_duration` | `[$duration]($style) ` | `yellow` | Default threshold |
|
||||
| `python` | `[$virtualenv]($style) ` | `bright-black` | `detect_extensions = []`, `detect_files = []` |
|
||||
| `time` | `[$time]($style)` | `bright-black` | `disabled = false`, `time_format = '%-I:%M %p'` (for example `3:07 PM`) |
|
||||
| `character` | default | | Symbols below |
|
||||
|
||||
**git_status.** The `conflicted`, `untracked`, `modified`, `staged`, `renamed`, and `deleted` symbols are all set to a zero-width space. Any dirty state therefore shows a single `*` in 256-color `218` (pink) instead of per-state counts. `stashed` is `≡`. `ahead_behind` keeps starship's default arrows and is drawn in `cyan`.
|
||||
|
||||
**python.** With both detect lists empty, the module does not trigger on `.py` files or `pyproject.toml`. It shows only the name of an active virtualenv.
|
||||
|
||||
### Prompt character
|
||||
|
||||
| State | Symbol |
|
||||
| --- | --- |
|
||||
| Last command succeeded | `❯` in `purple` |
|
||||
| Last command failed | `❯` in `red` |
|
||||
| Vi normal mode (fish) | `❮` in `green` |
|
||||
|
||||
fish runs in vi mode ([key bindings](fish.md#key-bindings)), so `vimcmd_symbol` appears there. zsh uses the emacs keymap and never shows it.
|
||||
|
||||
## Palette
|
||||
|
||||
`palette = "cyberdream"` selects the `[palettes.cyberdream]` table, colors from [cyberdream.nvim](https://github.com/scottmckendry/cyberdream.nvim). Every named color in the module styles resolves through this table.
|
||||
|
||||
| Name | Normal | `bright-*` | `dim-*` |
|
||||
| --- | --- | --- | --- |
|
||||
| black | `#1e2124` | `#4a4d4f` | `#1c1f22` |
|
||||
| red | `#ff6e5e` | `#ff8b7e` | `#d05c50` |
|
||||
| green | `#5eff6c` | `#7eff89` | `#4fd05b` |
|
||||
| yellow | `#f1ff5e` | `#f3ff7e` | `#c5d050` |
|
||||
| blue | `#5ea1ff` | `#7eb3ff` | `#4f85d1` |
|
||||
| purple | `#bd5eff` | `#ff7ef3` | `#d050c6` |
|
||||
| cyan | `#5ef1ff` | `#7ef3ff` | `#4fc5d1` |
|
||||
| white | `#ffffff` | `#ffffff` | `#d0d0d1` |
|
||||
|
||||
`bright-black` (`#4a4d4f`) is the muted gray used for the branch, git state, virtualenv, and clock. The `dim-*` entries are defined but no module uses them.
|
||||
@@ -0,0 +1,19 @@
|
||||
# Terminal
|
||||
|
||||
Terminal emulators and multiplexers configured by the dotfiles.
|
||||
|
||||
kitty is the primary terminal. It runs in three modes: plain kitty (kitty owns splits and tabs), a tmux host, and a herdr host. Ghostty is a tmux-only terminal: every window attaches to tmux, and its `ctrl+shift` chords drive tmux.
|
||||
|
||||
| Page | Source | What it covers |
|
||||
| --- | --- | --- |
|
||||
| [kitty](kitty.md) | external repo via `.chezmoiexternals/kitty.toml` | Main config, host configs (tmux, herdr, goliath), kittens, custom tab bar |
|
||||
| [Ghostty](ghostty.md) | external repo via `.chezmoiexternals/ghostty.toml` | tmux-only terminal: ctrl+shift chords → tmux, themes |
|
||||
| [tmux](tmux.md) | external repo via `.chezmoiexternals/tmux.toml` | Prefix, bindings, kitty-style tabs with Nerd Font icons, resurrect/continuum persistence |
|
||||
| [herdr](herdr.md) | external repo via `.chezmoiexternals/herdr.toml`, plus `dot_config/herdr-nvim/` | Agent-aware multiplexer: keys, theme, plugins, Claude hook |
|
||||
|
||||
## Shared conventions
|
||||
|
||||
- Font: VictorMono Nerd Font everywhere.
|
||||
- Background opacity `0.9`, no window decorations; the compositor provides blur.
|
||||
- Prefix `ctrl+b` in tmux and herdr. kitty and Ghostty translate chords into the prefix byte `\x02` plus a key, so the same physical shortcut works across hosts.
|
||||
- `ctrl+h/j/k/l` moves between panes across nvim, kitty, tmux, and herdr (vim-aware handoff at every layer).
|
||||
@@ -0,0 +1,97 @@
|
||||
# Ghostty
|
||||
|
||||
Ghostty as a tmux-only terminal — every window attaches to tmux, and ctrl+shift chords drive tmux.
|
||||
|
||||
Ghostty is the default terminal and only a [tmux](tmux.md) client. tmux owns tabs (windows), splits (panes), sessions, and persistence. Ghostty draws the text and handles the clipboard and font size.
|
||||
|
||||
It is the default everywhere a desktop picks a terminal: the first entry of `~/.config/xdg-terminals.list` (`dot_config/xdg-terminals.list`, desktop roles only) is what `xdg-terminal-exec` and `omarchy-launch-terminal` launch.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | [prdlk/ghostty](https://github.com/prdlk/ghostty) via `.chezmoiexternals/ghostty.toml`: `config`, `themes/` |
|
||||
| Target | `~/.config/ghostty/` |
|
||||
| Install | `ghostty` in `packages.arch.pacman` |
|
||||
|
||||
`~/.config/ghostty` is a `git-repo` external checkout, not chezmoi-managed contents; edit it in place and commit and push from there.
|
||||
|
||||
`config` holds every setting, ending in `theme = noctalia`. That theme file is generated, not shipped (the ghostty repo's `.gitignore` excludes it), so without its generator ghostty finds no such theme; select `theme = cherry-blossom` instead on this setup.
|
||||
|
||||
## Options
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `font-family` / `font-size` | `IoskeleyMonoTerm Nerd Font Mono` / `11` |
|
||||
| `adjust-cell-height` | `20%` (line height) |
|
||||
| `background-opacity` / `background-blur` | `0.9` / `true` |
|
||||
| `window-decoration` | `false`; `gtk-titlebar = false` |
|
||||
| `window-padding-x/y` | `0` |
|
||||
| `cursor-style` | `underline`, blinking |
|
||||
| `scrollback-limit` | `3023` (tmux keeps the real scrollback: `history-limit 50000`) |
|
||||
| `mouse-hide-while-typing` | `true` |
|
||||
| `copy-on-select` | `false` |
|
||||
| `confirm-close-surface` | `false` |
|
||||
| `link-url` / `link-previews` | `true` / `true`. Under tmux (`mouse on`) tmux receives the click, so open links with `ctrl+shift+click`; tmux opens OSC 8 links on a plain `ctrl+click` |
|
||||
| `app-notifications` | `no-clipboard-copy,no-config-reload` |
|
||||
| `quit-after-last-window-closed` | `false`, delay `5m` |
|
||||
| `command` | `shell:$HOME/.local/bin/ghostty-tmux` (see [Sessions](#sessions)) |
|
||||
| `shell-integration` | `detect`, features `cursor,sudo,title,no-cursor` |
|
||||
| `gtk-single-instance` | `true` |
|
||||
|
||||
## Sessions
|
||||
|
||||
Every Ghostty window gets its own tmux session; no two windows mirror the same one. `~/.local/bin/ghostty-tmux` (source `dot_local/bin/executable_ghostty-tmux`) runs for each new window:
|
||||
|
||||
1. If a detached session exists (left by a closed window, or restored by continuum after a reboot), it attaches to the oldest one, by session id. Background task sessions from `pj-palette` (`@pj_task` set, named `<session>:<task>`) are never reclaimed.
|
||||
2. Otherwise it starts a new session.
|
||||
|
||||
Before starting tmux, the script puts mise's shims on `PATH`. A server started from a desktop-launched Ghostty therefore finds the tools tmux plugins shell out to: bun for the palette, fzf, and zoxide.
|
||||
|
||||
The window title is the tmux session name (`set-titles-string '#S'`), so the compositor's window groups list one entry per session. tmux's tab bar keeps its own fixed cyberdream colors, so it does not match Ghostty's background exactly.
|
||||
|
||||
Closing a window only detaches its session; the shells keep running in the tmux server. In tmux, `detach-on-destroy no-detached` means killing a session moves the window to a *detached* session, or closes the window if there is none, so it never lands on another window's session. Across reboots, tmux-continuum saves every 10 minutes. The first Ghostty window starts the server, and that triggers continuum's restore. See [tmux](tmux.md#persistence).
|
||||
|
||||
## Keybindings
|
||||
|
||||
`keybind = clear` comes first and drops every Ghostty default: tabs, splits, `alt+N` goto_tab, and `ctrl+alt+arrow` goto_split. Those chords then reach tmux, which binds `alt+1…9` and `ctrl+alt+arrows` itself. `ctrl+h/j/k/l` also pass straight through to tmux's vim-aware pane navigation, which hands off to and from nvim's splits (see [tmux](tmux.md#keybindings)). Each `ctrl+shift` chord sends tmux's prefix, `ctrl+b` (`\x02`), followed by a key.
|
||||
|
||||
| Key | Ghostty action |
|
||||
| --- | --- |
|
||||
| `ctrl+shift+c` / `ctrl+shift+v` | Copy / paste |
|
||||
| `ctrl+plus` / `ctrl+minus` / `ctrl+zero` | Font size +1 / -1 / reset |
|
||||
| `ctrl+shift+.` | Reload Ghostty config |
|
||||
| `shift+enter` | Sends `ESC[13;2u` (CSI-u Shift+Enter), which tmux passes through to the pane, so coding agents such as omp and Claude Code insert a newline instead of submitting. Not `\n`: that is `ctrl+j`, tmux's pane-down key |
|
||||
| `ctrl+space`, `ctrl+backspace` | Sends NUL (tmux `C-Space`): opens the [tmux command palette](tmux.md#command-palette) |
|
||||
|
||||
| Key | Sends | tmux action |
|
||||
| --- | --- | --- |
|
||||
| `ctrl+shift+t` | `prefix c` | New window (tab) in pane cwd |
|
||||
| `ctrl+shift+p` / `ctrl+shift+space` | `prefix t` | Project Tasks palette (pj: install, dev, sync, make, every project task) |
|
||||
| `ctrl+shift+f` | `prefix y` | Yazi in a new window, pane cwd |
|
||||
| `ctrl+shift+e` | `prefix e` | Neovim in a new window, pane cwd |
|
||||
| `ctrl+shift+g` | `prefix g` | Lazygit in a 90% popup, pane cwd |
|
||||
| `ctrl+shift+a` | `prefix a` | Toggle omp in a background-session popup (`<session>:omp`), pane cwd |
|
||||
| `ctrl+shift+w` | `prefix k` | Kill window (close tab) |
|
||||
| `ctrl+shift+r` | `prefix r` | Rename window |
|
||||
| `ctrl+tab` / `ctrl+page_down` / `ctrl+shift+right` / `ctrl+shift+k` | `prefix n` | Next window |
|
||||
| `ctrl+shift+tab` / `ctrl+page_up` / `ctrl+shift+left` / `ctrl+shift+h` | `prefix p` | Previous window |
|
||||
| `ctrl+shift+l` | `prefix v` | Split right |
|
||||
| `ctrl+shift+j` | `prefix h` | Split below |
|
||||
| `ctrl+shift+o` / `super+enter` | `prefix o` | Sessions palette: switch session or window, or create one through zoxide |
|
||||
| `ctrl+shift+x` | `prefix x` | Kill pane |
|
||||
| `ctrl+shift+enter` / `ctrl+shift+z` | `prefix z` | Zoom pane |
|
||||
| `ctrl+shift+page_up` | `prefix [` | Copy mode |
|
||||
| `ctrl+shift+/` | `prefix ?` | Keybinding help popup |
|
||||
| `ctrl+shift+alt+,` | `prefix q` | Reload tmux config |
|
||||
| `ctrl+shift+n` | `prefix C` | New session |
|
||||
| `ctrl+shift+s` | `prefix s` | Session/window tree |
|
||||
| `ctrl+shift+q` | `prefix d` | Detach (closes the Ghostty window; the session lives on) |
|
||||
|
||||
## Themes
|
||||
|
||||
| Theme | Notes |
|
||||
| --- | --- |
|
||||
| `noctalia` | Generated, not shipped: the file is written from the active palette (currently the custom `CherryBlossom` palette: background `#222120`, foreground `#dcc1b7`, salmon cursor `#cf716f`) and excluded by the ghostty repo's `.gitignore`. It exists only on machines that generate it. |
|
||||
| `cherry-blossom` | Static copy of the `CherryBlossom` palette (same colors as the generated `noctalia` theme). Always present; set `theme = cherry-blossom` to use it. |
|
||||
| `cyberdream` | Upstream `extras/ghostty/cyberdream` from [cyberdream.nvim](https://github.com/scottmckendry/cyberdream.nvim), the palette shared with tmux, nvim, yazi, and television. |
|
||||
| `ii-auto` | Auto-generated by the ii wallpaper theming system; not meant to be edited. |
|
||||
| `koda-dark` / `koda-light` | Koda palettes with `bold-is-bright = true`. |
|
||||
@@ -0,0 +1,91 @@
|
||||
# herdr
|
||||
|
||||
herdr, an agent-aware terminal multiplexer, with its keys, theme, plugins and Claude Code hook.
|
||||
|
||||
herdr is a terminal multiplexer with workspaces, tabs and panes, a sidebar, a prefix key (`ctrl+b`), and a plugin system. It tracks coding agents running in its panes: agent-state colors, next/previous agent keys, and an integration that reports Claude Code sessions to it.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | [prdlk/herdr](https://github.com/prdlk/herdr) via `.chezmoiexternals/herdr.toml` (`~/.config/herdr/`); `dot_config/herdr-nvim/config.toml` |
|
||||
| Target | `~/.config/herdr/`, `~/.config/herdr-nvim/config.toml` |
|
||||
| Install | Not in `packages.yaml`; updated by topgrade (`herdr update`) |
|
||||
| Launch | kitty `super+a` (see [kitty](kitty.md)) |
|
||||
|
||||
## config.toml
|
||||
|
||||
`onboarding = false`.
|
||||
|
||||
### UI and theme
|
||||
|
||||
| Setting | Value |
|
||||
| --- | --- |
|
||||
| `ui.pane_borders`, `ui.pane_outer_borders` | `false` (panes separated by gaps only) |
|
||||
| `ui.prompt_new_tab_name` | `false` |
|
||||
| `ui.accent` | `#5ea1ff` |
|
||||
| `ui.status_indicators` | `symbols` |
|
||||
| `ui.toast.delivery` | `system` |
|
||||
| `theme.name` | `terminal`, `auto_switch = false` |
|
||||
| `theme.custom.panel_bg` | `reset` (keeps kitty's translucency and compositor blur) |
|
||||
| `sidebar_bg` / `active_row_bg` / `selection_bg` | `#16181a` / `#1e2124` / `#3c4048` |
|
||||
| `accent` / `surface_dim` | `#243348` / `#5ea1ff` (active tab plate matches kitty's tab bar) |
|
||||
| Agent-state colors | green `#5eff6c`, yellow `#f1ff5e`, red `#ff6e5e`, peach `#ffbd5e`, mauve `#bd5eff` |
|
||||
| `experimental.kitty_graphics` | `true`; `pane_history = false` |
|
||||
| `switch_ascii_input_source_in_prefix` | `true` |
|
||||
|
||||
These are cyberdream colors.
|
||||
|
||||
### Keys
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| `prefix %` | Split vertical |
|
||||
| `prefix "` | Split horizontal |
|
||||
| `prefix d` | Detach |
|
||||
| `prefix s` | Workspace picker |
|
||||
| `prefix shift+s` | Settings |
|
||||
| `k` / `j` | Move up / down in the workspace picker (pane up/down in navigate mode unbound) |
|
||||
| `prefix .` / `prefix ,` | Next / previous agent |
|
||||
| `prefix j` / `prefix k` | Next / previous workspace |
|
||||
| `prefix up/down/left/right` | Focus pane |
|
||||
| `ctrl+h/j/k/l` | `vim-herdr-navigation` left/down/up/right |
|
||||
| `prefix e` | `chmarax.herdr-nvim.toggle` (nvim sidebar) |
|
||||
| `prefix o` | `chmarax.herdr-nvim.pick-file` (open file from agent output) |
|
||||
| `prefix t` | `switchboard.menu` |
|
||||
| `prefix shift+p` | `switchboard.commands` |
|
||||
| `prefix shift+l` | `switchboard.git` |
|
||||
| `prefix shift+k` | `switchboard.projects` |
|
||||
| `prefix y` | Open `official.browser` plugin in a right split |
|
||||
| `prefix shift+o` | Open `official.browser` as an overlay |
|
||||
|
||||
## Plugins
|
||||
|
||||
`plugins.json` is herdr's plugin registry. `.plugins.lock` is committed empty. `plugins/config/official.browser/` and `plugins/config/vim-herdr-navigation/` hold placeholder `.keep` files for per-plugin config. `plugins/github/`, where herdr installs plugin checkouts, is gitignored in the repo.
|
||||
|
||||
| Plugin | Description (from its manifest) |
|
||||
| --- | --- |
|
||||
| `chmarax.herdr-nvim` | Full-height nvim sidebar with agent annotations |
|
||||
| `herdr-automatic-rename` | Names tabs after the foreground program, adds 1–9 jump numbers |
|
||||
| `io.github.salemsayed.omaherd` | Tells the Omarchy bar when an agent changes state |
|
||||
| `official.browser` | Open and inspect real browser pages from herdr |
|
||||
| `oh-my-opencode-slim` | OpenCode agent orchestration with a herdr adapter |
|
||||
| `persiyanov.reviewr` | Review agent-written diffs beside the chat |
|
||||
| `rjyo.window-title-sync` | Syncs the outer terminal title to the focused workspace, tab and agent |
|
||||
| `switchboard` | Command palette: projects, commands, ports, git, clone, settings |
|
||||
| `vim-herdr-navigation` | Vim-aware `ctrl+h/j/k/l` pane movement |
|
||||
|
||||
[fish](../shell/fish.md) sources `herdr-automatic-rename`'s `shell/hook.fish` if present.
|
||||
|
||||
## herdr-nvim
|
||||
|
||||
**~/.config/herdr-nvim/config.toml**
|
||||
|
||||
```toml
|
||||
[sidebar]
|
||||
position = "left"
|
||||
```
|
||||
|
||||
The nvim sidebar opens to the left of existing panes (default is right).
|
||||
|
||||
## herdr/kitty.conf
|
||||
|
||||
A legacy kitty config kept in the herdr folder. It runs `tmux new-session -A -s main`, listens on `unix:@mykitty`, includes `current-theme.conf`, maps `super`/`alt` keys to tmux prefix bytes, and has a copy of an older `tmux.conf` appended. The active herdr host is `~/.config/kitty/herdr.conf`.
|
||||
@@ -0,0 +1,221 @@
|
||||
# kitty
|
||||
|
||||
kitty configuration, host variants, custom kittens and the Python tab bar.
|
||||
|
||||
GPU terminal emulator and the primary terminal on every role.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | [prdlk/kitty](https://github.com/prdlk/kitty) via `.chezmoiexternals/kitty.toml` |
|
||||
| Target | `~/.config/kitty/` |
|
||||
| Install | `kitty` in `.chezmoidata/packages.yaml` (pacman), plus `ttf-victor-mono-nerd` for the font |
|
||||
|
||||
```text
|
||||
~/.config/kitty/
|
||||
kitty.conf
|
||||
tmux.conf
|
||||
herdr.conf
|
||||
goliath.conf
|
||||
ssh.conf
|
||||
current-theme.conf
|
||||
tab_bar.py
|
||||
pass_keys.py
|
||||
day_session.py
|
||||
navigate_kitty.py
|
||||
select_tab.py
|
||||
switchtab.py
|
||||
window_titler.py
|
||||
themes/
|
||||
cyberdream.conf
|
||||
koda-dark.conf
|
||||
koda-light.conf
|
||||
```
|
||||
|
||||
`~/.config/kitty` is a `git-repo` external checkout, not chezmoi-managed contents; edit it in place and commit and push from there. The repo's `.gitignore` excludes `__pycache__/` next to `tab_bar.py`.
|
||||
|
||||
## Theme and colors
|
||||
|
||||
Every config ends with:
|
||||
|
||||
**~/.config/kitty/kitty.conf**
|
||||
|
||||
```conf
|
||||
include ~/.local/state/omarchy/current/theme/kitty.conf
|
||||
```
|
||||
|
||||
Colors come from the active Omarchy theme; it is included last so it wins. `current-theme.conf` is a symlink committed in the repo, pointing at `themes/cyberdream.conf`. Only the legacy `~/.config/herdr/kitty.conf` ([prdlk/herdr](https://github.com/prdlk/herdr)) includes `current-theme.conf`; the main config does not. `themes/` holds `cyberdream`, `koda-dark`, and `koda-light` color files.
|
||||
|
||||
## kitty.conf
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `font_family` | `VictorMono Nerd Font`, then overridden in the `BEGIN_KITTY_FONTS` block to `family="VictorMono Nerd Font Mono"`; bold/italic `auto` |
|
||||
| `window_padding_width` | `8` |
|
||||
| `hide_window_decorations` | `yes` |
|
||||
| `background_opacity` | `0.9` |
|
||||
| `cursor_trail` | `10`, `cursor_trail_start_threshold 0`, `cursor_trail_decay 0.01 0.05` |
|
||||
| `cursor_blink_interval` | `0` (set to 1, then overridden) |
|
||||
| `copy_on_select` | `auto` |
|
||||
| `strip_trailing_spaces` | `smart` |
|
||||
| `confirm_os_window_close` | `0` |
|
||||
| `allow_remote_control` | `socket-only` |
|
||||
| `listen_on` | `unix:@kitty-{kitty_pid}` |
|
||||
| `enabled_layouts` | `splits:split_axis=vertical,stack` |
|
||||
| Tab bar | `powerline`, `slanted`, centered, top edge, always shown (`tab_bar_min_tabs 1`, so the stack-layout indicator is visible with one tab), `tab_title_template "{custom}"` |
|
||||
|
||||
> [!NOTE]
|
||||
> Transparency uses kitty's own alpha, so text stays opaque. This alpha is also what lets the compositor blur the window: Hyprland enables blur globally and opts out every window except terminal classes.
|
||||
|
||||
The socket also exports `KITTY_LISTEN_ON` into each pane. nvim reads it to know kitty owns the panes and hands `ctrl+h/j/k/l` back to kitty at an edge.
|
||||
|
||||
### Launch aliases
|
||||
|
||||
| Alias | Expands to |
|
||||
| --- | --- |
|
||||
| `launch_mn` | `launch --cwd=current --type=overlay-main` |
|
||||
| `launch_os` | `launch --cwd=current --type=os-window` |
|
||||
| `launch_ov` | `launch --cwd=current --type=overlay` |
|
||||
| `launch_tb` | `launch --cwd=current --type=tab` |
|
||||
| `launch_hs` | `launch --cwd=current --location=hsplit --bias=30` |
|
||||
| `launch_vs` | `launch --cwd=current --location=vsplit --bias=40` |
|
||||
| `launch_vs50` | `launch --cwd=current --location=vsplit --bias=50` |
|
||||
|
||||
### Keybindings
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| `super+n` | Vertical split 50/50 (`launch_vs50`) |
|
||||
| `super+z` | Toggle `stack` layout (zoom); the tab title gains a layers icon and pane count (`nf-md-layers 3`) while other panes are hidden |
|
||||
| `ctrl+shift+t`, `super+enter` | New tab in current cwd |
|
||||
| `ctrl+space`, `ctrl+shift+j` | Horizontal split, 30% (`launch_hs`) |
|
||||
| `ctrl+enter`, `ctrl+shift+l` | Vertical split, 40% (`launch_vs`) |
|
||||
| `ctrl+shift+space` | New OS window |
|
||||
| `ctrl+shift+h` / `ctrl+shift+k` | Previous / next tab |
|
||||
| `ctrl+shift+g` | `lazygit` in an overlay |
|
||||
| `ctrl+shift+f` | `yazi` in a new tab |
|
||||
| `ctrl+shift+e` | `nvim` in a 50/50 vertical split |
|
||||
| `ctrl+shift+p` | `atuin-pick` in a horizontal split |
|
||||
| `super+t` | Spawn a separate kitty (`--class=kitty-tmux`, `--config ~/.config/kitty/tmux.conf`) |
|
||||
| `super+a` | Spawn a separate kitty (`--class=kitty-herdr`, `--config ~/.config/kitty/herdr.conf`) |
|
||||
| `ctrl+shift+c` / `ctrl+shift+v` | Copy / paste clipboard |
|
||||
| `alt+q w e r t y u i o` | Go to tab 1–9 |
|
||||
| `ctrl+h/j/k/l` | `pass_keys.py`: move to neighbor window left/bottom/top/right, or pass the key through |
|
||||
| `super+left` / `super+right` | Resize window narrower / wider |
|
||||
| `super+up` / `super+down` | Resize window taller / shorter (by 3) |
|
||||
|
||||
The tmux and herdr hosts are separate kitty processes because `launch` cannot take `--config`.
|
||||
|
||||
### Daily sessions
|
||||
|
||||
`day_session.py` keeps one kitty session file per day, grouped by week:
|
||||
|
||||
```text
|
||||
~/.local/share/kitty-sessions/<monday YYYY-MM-DD>/<day YYYY-MM-DD>.kitty-session
|
||||
~/.local/share/kitty-sessions/<monday YYYY-MM-DD>/<day YYYY-MM-DD>.scrollback/<window key>.ansi
|
||||
```
|
||||
|
||||
| Directive | Role |
|
||||
| --- | --- |
|
||||
| `geninclude day_session.py` | Creates today's (empty) session file and emits `startup_session <path>` whenever no running kitty owns today's session. Ownership is an `flock` on `$XDG_RUNTIME_DIR/kitty-day-<day>.kitty-session.lock`, held until that kitty exits, so closing kitty and launching it again always reopens the day, even if other kitties (or yesterday's) are still running. A second concurrent instance starts plain instead of duplicating today's tabs. A kitty started with `--session` for another day never takes the lock. |
|
||||
| `watcher day_session.py` | About 1 s after a window opens, closes, resizes or splits, changes focus or finishes a command (catches `cd`), and every 30 s for output from long-running programs, rewrites the session this instance started with. Title changes are ignored so spinners don't trigger saves. Skips the save once the session has no windows, so closing kitty keeps the last good state. |
|
||||
|
||||
Earlier days open with the [`kitty-days`](../tools/television.md#kitty-days) tv cable (`tv kitty-days`), each in its own kitty (`kitty --session <file>`). A past day is a read-only snapshot: nothing in that kitty saves it back. Today's file opened that way, while no kitty owns it, becomes the live day again.
|
||||
|
||||
Before shutdown or reboot, the `kitty-day-save.service` user unit runs [`kitty-day-save`](../shell/scripts.md#kitty-day-save) under a logind delay inhibitor. On `PrepareForShutdown(true)` it sends `kitten day_session.py flush` to every `@kitty-<pid>` socket: the owning kitty saves at once (all windows are still alive), then skips saves for 60 s so windows dying during the shutdown can't shrink the file. [`30-user-services`](../chezmoi/scripts.md#30-user-services) enables the unit.
|
||||
|
||||
What a restored window gets back:
|
||||
|
||||
- **Scrollback**: each window carries a `day_scrollback=<key>` user var (kept by kitty's `launch --var`); its history is dumped as ANSI to `<key>.ansi`, minus the idle prompt, and dumps of closed windows are pruned. On restore, the shell runs `cat <key>.ansi` through kitty's shell-integration startup command, so it needs shell integration (fish here). A dump is only written after the shell has drawn a prompt, so a restored window can't overwrite its history before replaying it.
|
||||
- **Running program**: saved with `--use-foreground-process` and re-run after the `cat`, so the shell is still there when it exits (`nvim`, `sleep 700`, dev servers). Commands still at shell init when saved (mise/direnv hooks) are ignored. A command is never replayed if any of its words is `rm`, `rmdir`, `mv`, `dd`, `shred`, `truncate`, `mkfs*`, `wipefs`, `fdisk`, `parted`, `sudo`, `doas`, `su`, `run0`, `pkexec`, `kill`, `pkill`, `killall`, `reboot`, `shutdown` or `poweroff` (`NO_REPLAY`).
|
||||
- Programs launched as the window's own command (`ctrl+shift+e` nvim, `ctrl+shift+g` lazygit) were already restored by kitty; they have no shell, so no scrollback.
|
||||
|
||||
Only windows that belong to the session are saved: `new_tab_with_cwd` and the `--cwd=current` launch aliases join it; `new_os_window` (`ctrl+shift+space`) does not.
|
||||
|
||||
## Host configs
|
||||
|
||||
### tmux.conf — kitty as a tmux host
|
||||
|
||||
Launched by `super+t`. kitty stays a dumb terminal; tmux owns panes, windows and sessions. `listen_on unix:@kitty-tmux`, `tab_bar_style hidden`, `shell kitty-tmux` (a launcher script), and `clear_all_shortcuts yes`, so only the bindings below exist. Prefix byte `\x02` is `ctrl+b`; see [tmux](tmux.md) for what each prefix key does.
|
||||
|
||||
| Key | Sends / does |
|
||||
| --- | --- |
|
||||
| `ctrl+shift+c` / `ctrl+shift+v` | Copy / paste |
|
||||
| `ctrl+plus` / `ctrl+minus` / `ctrl+0` | Font size +1 / -1 / reset |
|
||||
| `ctrl+shift+alt+,` | Reload kitty config |
|
||||
| `ctrl+shift+a` | Spawn a kitty herdr host |
|
||||
| `super+t`, `super+enter`, `ctrl+shift+t` | `prefix t` (new window) |
|
||||
| `ctrl+shift+h` / `ctrl+shift+k` | `prefix H` / `prefix L` (previous / next window) |
|
||||
| `alt+q w e r t y u i o` | `prefix 1`–`9` |
|
||||
| `ctrl+shift+j` | `prefix "` (split below) |
|
||||
| `ctrl+shift+l`, `ctrl+enter` | `prefix %` (split right) |
|
||||
| `ctrl+shift+f` | `prefix z` (zoom) |
|
||||
| `ctrl+shift+w`, `super+w` | `prefix x` (kill pane) |
|
||||
| `super+left/right/up/down` | `prefix` + `ctrl+arrow` (resize) |
|
||||
| `ctrl+shift+g` | `tmux display-popup` 90%×90% running `lazygit` in pane cwd |
|
||||
| `ctrl+shift+e` | `tmux new-window` running `nvim` in pane cwd |
|
||||
| `ctrl+shift+p` | `tmux split-window -v -l 25%` running `atuin-pick` |
|
||||
| `super+n`, `ctrl+shift+space` | New OS window |
|
||||
| `super+d` | `prefix d` (detach) |
|
||||
|
||||
### herdr.conf — kitty as a herdr host
|
||||
|
||||
Launched by `super+a`. Class `kitty-herdr`, `tab_bar_style hidden` (herdr draws its own sidebar and tab strip), `shell herdr` (launches or attaches the persistent session; closing the window detaches). Base appearance matches `kitty.conf`, without a `listen_on`. An uppercase letter after `\x02` is the shift variant. See [herdr](herdr.md).
|
||||
|
||||
| Key | Sends / does |
|
||||
| --- | --- |
|
||||
| `super+c` / `super+v` | Copy / paste |
|
||||
| `ctrl+plus` / `ctrl+minus` / `ctrl+0` | Font size +1 / -1 / reset |
|
||||
| `ctrl+shift+alt+,` | Reload kitty config |
|
||||
| `ctrl+shift+n` | `prefix N` |
|
||||
| `super+n` | `prefix G` |
|
||||
| `super+t`, `ctrl+shift+t` | `prefix c` |
|
||||
| `ctrl+space` | `prefix t` (Switchboard menu) |
|
||||
| `super+z` | `prefix z` |
|
||||
| `ctrl+tab` / `ctrl+shift+tab` | `prefix .` / `prefix ,` (next / previous agent) |
|
||||
| `ctrl+shift+f` | `prefix K` (Switchboard projects) |
|
||||
| `ctrl+shift+g` | `prefix L` (Switchboard git) |
|
||||
| `ctrl+shift+e` | `prefix e` (herdr-nvim sidebar toggle) |
|
||||
| `ctrl+shift+o` | `prefix o` (herdr-nvim pick file) |
|
||||
| `ctrl+shift+h` / `ctrl+shift+l` | `prefix p` / `prefix n` |
|
||||
| `ctrl+shift+j` / `ctrl+shift+k` | `prefix j` / `prefix k` (next / previous workspace) |
|
||||
| `ctrl+shift+w` | `prefix W` |
|
||||
| `ctrl+shift+r` | `prefix T` |
|
||||
| `ctrl+shift+,` | `prefix S` (herdr settings) |
|
||||
| `ctrl+shift+q` | `prefix x` |
|
||||
| `ctrl+shift+p` | `prefix P` (Switchboard commands) |
|
||||
|
||||
### goliath.conf — remote tmux over mosh
|
||||
|
||||
Opens straight into the tmux session `main` on host `goliath` via `mosh goliath -- tmux new-session -A -s main`. `font_size 9.0`, `listen_on unix:@kitty-goliath`, `env MOSH_TITLE_NOPREFIX=1` (drops mosh's `[mosh] ` title prefix), `tab_bar_style hidden`.
|
||||
|
||||
> [!WARNING]
|
||||
> mosh bootstraps ssh with `-S none`, so non-interactive key auth to goliath must work. It needs mosh on both ends and UDP 60000–61000 open. mosh sets `TERM=xterm-256color`, so kitty-only capabilities such as undercurl are unavailable inside.
|
||||
|
||||
| Key | Sends |
|
||||
| --- | --- |
|
||||
| `super+w` | `prefix x` |
|
||||
| `super+t` | `prefix %` |
|
||||
| `super+n` | `prefix "` |
|
||||
| `super+enter`, `alt+n` | `prefix t` |
|
||||
| `alt+h` / `alt+l` | `prefix H` / `prefix L` |
|
||||
| `alt+q w e r t y u i o` | `prefix 1`–`9` (`alt+t` is bound twice; the later `prefix 5` wins) |
|
||||
| `super+left/right/up/down` | `prefix` + `ctrl+arrow` |
|
||||
| `super+d` | `prefix d` |
|
||||
|
||||
### ssh.conf
|
||||
|
||||
Kitten `ssh` config: for `hostname goliath`, `share_connections yes`.
|
||||
|
||||
## Kittens and Python
|
||||
|
||||
| File | Purpose |
|
||||
| --- | --- |
|
||||
| `tab_bar.py` | Provides `draw_title` for `{custom}` in the tab template. Title is `<index> <icon> <label>`: the label is the git repo root name of the tab's cwd (walks up for `.git`), or the file nvim is editing (parsed from nvim's title). Icon comes from the foreground process cmdline (editors, AI agents like claude/omp/opencode/codex, git tools, docker, herdr, tmux, yazi, btop, atuin, ssh, chezmoi, …) with a folder fallback. Labels are elided at 28 chars. In the `stack` layout with more than one pane, ` <nf-md-layers> <panes>` is appended; kitty repaints the tab bar on every layout change. No subprocesses or timers. |
|
||||
| `pass_keys.py` | Bound to `ctrl+h/j/k/l`. If the window's foreground process matches `vim`, `nvim`, `fzf`, `tv`, `tmux` or `herdr`, the key is forwarded; otherwise kitty moves to the neighboring window. |
|
||||
| `navigate_kitty.py` | No-UI kitten that calls `neighboring_window` with a direction argument; the counterpart nvim can invoke. Not mapped in `kitty.conf`. |
|
||||
| `select_tab.py` | Full-screen fuzzy tab picker using `kitty @ ls` data; shows cwds zsh-style. Keys: Up/Down/PgUp/PgDn scroll, Enter selects, typing filters, `ctrl+c`/Esc quits. Not mapped in `kitty.conf`. |
|
||||
| `switchtab.py` | Focuses the tab whose `vt` user var matches the argument, or launches one with that var and reorders tabs by `vt`. Not mapped. |
|
||||
| `window_titler.py` | Watcher that appends `[<vt> <pty>]` to window titles. Not referenced in `kitty.conf`. |
|
||||
| `day_session.py` | Daily sessions: `geninclude` script, global watcher and the `flush` no-UI kitten in one file. See [Daily sessions](#daily-sessions). |
|
||||
|
||||
Related: the [tmux](tmux.md) `is_vim` check and herdr's `vim-herdr-navigation` plugin complete the `ctrl+h/j/k/l` chain. Hyprland window rules can match the `kitty`, `kitty-tmux` and `kitty-herdr` app-ids ([Hyprland](../desktop/hyprland.md)).
|
||||
@@ -0,0 +1,115 @@
|
||||
# tmux
|
||||
|
||||
tmux prefix, bindings, kitty-style window tabs with Nerd Font icons, and resurrect/continuum persistence.
|
||||
|
||||
Terminal multiplexer. [Ghostty](ghostty.md) runs nothing but tmux, and Ghostty's `ctrl+shift` chords are tmux bindings. tmux is also used through the kitty tmux host and remotely on goliath.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | [prdlk/tmux](https://github.com/prdlk/tmux) via `.chezmoiexternals/tmux.toml`: `tmux.conf`, `tmux-nerd-font-window-name.yml`, `tab-label.sh` |
|
||||
| Target | `~/.config/tmux/` |
|
||||
| Install | `tmux` in `.chezmoidata/packages.yaml` (pacman) |
|
||||
|
||||
`~/.config/tmux` is a `git-repo` external checkout, not chezmoi-managed contents; edit it in place and commit and push from there. tpm is a separate `git-repo` external in `.chezmoiexternal.toml`, cloned to `~/.config/tmux/plugins/tpm` inside that checkout when missing. `tmux.conf` ends with `run '~/.config/tmux/plugins/tpm/tpm'`. Plugins installed by tpm (`prefix I`) land next to it; the tmux repo's `.gitignore` excludes `plugins/` and chezmoi ignores them. [prdlk/tmux-palette](https://github.com/prdlk/tmux-palette) (`.chezmoiexternals/tmux-palette.toml`, → `~/.config/tmux-palette/`) holds the [palette](#command-palette) config.
|
||||
|
||||
## Options
|
||||
|
||||
The prefix is `ctrl+b` (the byte Ghostty's `ctrl+shift` chords send). `ctrl+space` is not a prefix: it opens the [command palette](#command-palette).
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `default-terminal` | `tmux-256color`; `RGB` override for every terminal; `clipboard` and `hyperlinks` (OSC 8) features; `extkeys` for xterm-kitty. Features apply after `tmux kill-server` |
|
||||
| `extended-keys` | `on`, format `csi-u` |
|
||||
| `base-index` / `pane-base-index` | `1` / `1`; `renumber-windows on` |
|
||||
| `status-position` | `top`, `status-interval 5` |
|
||||
| `allow-passthrough` / `set-clipboard` / `mouse` / `focus-events` | `on` |
|
||||
| `update-environment` | `TERM` and `TERM_PROGRAM` appended, so programs see the outer terminal (Ghostty/kitty) |
|
||||
| `mode-keys` | `vi` |
|
||||
| `set-titles` | `on`, `#S`: the terminal window title is the session name, so compositor window groups list sessions (one per Ghostty window) instead of `host:window` |
|
||||
| `automatic-rename-format` | `#{window_icon} <label>`: Nerd Font icon, then the dynamic label described under [Window tabs](#window-tabs) |
|
||||
| `history-limit` | `50000` |
|
||||
| `detach-on-destroy` | `no-detached` (killing a session switches only to a detached session, else detaches, so a Ghostty window never lands on another window's session) |
|
||||
|
||||
These settings are what [yazi](../tools/yazi.md) needs inside tmux. `allow-passthrough` carries image previews through to the terminal, `set-clipboard` copies paths via OSC 52, and the two environment variables let yazi detect the outer terminal's graphics support. Nothing binds `M-[`: tmux would read the `ESC [` that starts yazi's terminal-query replies as that key and break yazi's capability detection.
|
||||
|
||||
## Keybindings
|
||||
|
||||
`prefix ?` opens all of them in a popup: `omarchy-menu-tmux-keybindings` on Omarchy machines, `tmux list-keys -N` everywhere else.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| `prefix q` | Reload config |
|
||||
| `prefix /` | Copy mode, then search upward |
|
||||
| `prefix o` | Sessions palette ([`tmux-sessions`](../shell/scripts.md#tmux-sessions)): fuzzy-find the other sessions, every window of every session, zoxide's and `~/.config`'s directories, and Rename/Kill items per session. Typed text that is not a session starts one by that name in its zoxide match |
|
||||
| `prefix t` | Project Tasks palette ([`pj-palette`](../shell/scripts.md#pj-palette)): install/dev/sync/make/compose quick actions plus every `pj` task. One-off tasks run in a full-width bottom split (25% of the window); dev servers and `docker compose up` run in a background `<session>:<tool-and-command>` session shown in a popup (`q` hides, `ctrl-c` asks `y/n` then stops), listed under Running to reopen |
|
||||
| `prefix y` / `prefix e` | Yazi / Neovim in a new window in the pane cwd (Ghostty `ctrl+shift+f` / `ctrl+shift+e`) |
|
||||
| `prefix g` | Lazygit in a 90% popup in the pane cwd (Ghostty `ctrl+shift+g`) |
|
||||
| `prefix a` | omp in a background session `<session>:omp` (pane cwd), shown in a popup docked bottom-right (35% × 60%) and listed in the [omp palette](../shell/scripts.md#pj-palette) and under Running in the tasks palette. In the popup, `ctrl-c` hides it and `ctrl-q` quits omp. Inside any background-task popup, `prefix a` hides it too, so Ghostty `ctrl+shift+a` toggles omp |
|
||||
| `prefix h` / `prefix v` | Split below / right, pane cwd |
|
||||
| `prefix x` | Kill pane |
|
||||
| `S-Enter` (no prefix) | Sends `ESC[13;2u` to the pane unchanged. With `extended-keys on`, tmux would otherwise turn Shift+Enter into plain Enter for apps that never requested extended keys, and coding agents (omp, Claude Code) would submit instead of inserting a newline |
|
||||
| `C-MouseDown1Pane` (ctrl+click) | Opens the OSC 8 hyperlink under the mouse (`#{mouse_hyperlink}`) with `xdg-open`; without one, the click goes to the pane. Plain-text URLs: `ctrl+shift+click`, handled by Ghostty |
|
||||
| `M-Enter` / `M-S-Enter` / `M-Escape` (no prefix) | Split below / split right / kill pane |
|
||||
| `C-h` / `C-j` / `C-k` / `C-l` (no prefix) | Vim-aware pane focus. In an nvim/vim/fzf pane (`@pane-is-vim`, set by smart-splits, or the pane's command), the key goes to nvim. nvim's `config.pane_nav` moves between its own splits and, at its outer edge, runs `tmux select-pane -t $TMUX_PANE`. Elsewhere tmux moves directly. Also bound in copy mode |
|
||||
| `prefix C-l` | Send `C-l` (clear screen) |
|
||||
| `C-M-arrows` / `C-M-S-arrows` (no prefix) | Focus pane / resize pane by 5 |
|
||||
| `prefix c` / `prefix k` / `prefix r` | New window in pane cwd / kill window / rename window |
|
||||
| `M-1` … `M-9` (no prefix) | Select window 1–9 |
|
||||
| `M-Left` / `M-Right` (no prefix) | Previous / next window |
|
||||
| `M-S-Left` / `M-S-Right` (no prefix) | Move window left / right |
|
||||
| `prefix C` / `prefix K` / `prefix R` | New / kill / rename session |
|
||||
| `prefix P` / `prefix N`, `M-Up` / `M-Down` | Previous / next session |
|
||||
| Copy mode `v` / `y` | Begin selection / copy and exit |
|
||||
|
||||
## Window tabs
|
||||
|
||||
The status line copies kitty's tab bar (`tab_bar_style powerline`, `tab_powerline_style angled`). The current window is an accent-tinted plate with accent text. The other windows use `bg=default` and muted text, so the terminal's transparency shows through them, as with kitty's `tab_bar_background none`. That only works while every `window-status-*-style` stays `default`: inside a tab format, `bg=default` means that style's background, not the terminal's. `tmux.conf` therefore sets all of them explicitly, because a reload never clears a value a removed plugin left behind. As in kitty, a solid arrow leads into the current window and a thin one sits between two inactive windows. The arrow into the current window is a plain `U+E0B0` in `@tab-bg`, the window background. Ghostty draws that glyph as a built-in sprite that fills the whole cell even with `adjust-cell-height`. The session name is an accent pill on the far left (`status-justify left`); its arrow points straight into the first tab, so the pill and tabs read as one chain of arrows. The right side shows `COPY`/`PREFIX`/`ZOOM` flags and the hostname.
|
||||
|
||||
Colors are the user options `@tab-bg` (window background: the notch arrow and the session pill's text), `@tab-fg`, `@tab-active-bg`, and `@tab-active-fg`. They are a fixed CherryBlossom palette (the same one Ghostty's `cherry-blossom` theme uses), so the bar looks identical on every machine and does not depend on Omarchy. Active background = accent mixed 20% into background, the same derivation as the kitty tab bar: `#453130` from accent `#cf716f` over `#222120`.
|
||||
|
||||
Popups (`prefix g`, `prefix t`, `prefix ?`, tmux-palette) set `popup-style` to `bg=@tab-bg` and `popup-border-style` to `@tab-active-fg` on that background with rounded lines. The explicit background matters under Ghostty: `background-opacity` only applies to cells with the default background, so a default-bg popup shows the pane behind it through the blur.
|
||||
|
||||
### Tab labels
|
||||
|
||||
Each window reads `<index> <icon> <label>`, updating as you work, the same rule as kitty's `tab_bar.py`:
|
||||
|
||||
| Pane runs | Label | Source |
|
||||
| --- | --- | --- |
|
||||
| `nvim`/`vim`/`hx`/`helix`, editing a file | The file name | The title nvim sets (`<file> \| <org/repo>`, astrocore `custom_title`), read from `#{pane_title}` by the format itself, so a buffer switch relabels the tab immediately |
|
||||
| Anything else, or an editor with no file | Repo the cwd belongs to (walks up for `.git`); the directory name outside a repo; `~` at home | `tab-label.sh`, run as an async `#()` job. When its output differs from the current name, it re-arms `automatic-rename` so tmux relabels right after a `cd` instead of on the next keystroke |
|
||||
|
||||
Labels longer than 27 characters end in `…`. The icon comes from tmux-nerd-font-window-name.
|
||||
|
||||
## Plugins
|
||||
|
||||
| Plugin | Settings |
|
||||
| --- | --- |
|
||||
| `tmux-plugins/tpm` | Plugin manager |
|
||||
| `tmux-plugins/tmux-sensible` | Defaults |
|
||||
| `joshmedeski/tmux-nerd-font-window-name` | Fills `#{window_icon}` from `tmux-nerd-font-window-name.yml` |
|
||||
| `tmux-plugins/tmux-resurrect` | `@resurrect-capture-pane-contents on` |
|
||||
| `tmux-plugins/tmux-continuum` | `@continuum-save-interval 10`, `@continuum-restore on` |
|
||||
| `prdlk/tmux-palette-plugin` | Fork of [eduwass/tmux-palette](https://github.com/eduwass/tmux-palette) that adds a custom palette `query` item (an item for the typed text, listed after the matches). `@palette-key C-Space` (root table, no prefix). Needs [Bun](https://bun.sh); tpm runs `bun install` on first load |
|
||||
|
||||
### Command palette
|
||||
|
||||
`ctrl+space` opens tmux-palette, a fuzzy command list in a popup. Its user config lives in `~/.config/tmux-palette/` (the [prdlk/tmux-palette](https://github.com/prdlk/tmux-palette) external):
|
||||
|
||||
| File | Contents |
|
||||
| --- | --- |
|
||||
| `commands.json` | The kitty launchers ported as palette items: **Lazygit** (90% popup in the pane's cwd; kitty `ctrl+shift+g`), **Yazi** (new window; kitty `ctrl+shift+f`), **Neovim Split** (nvim in a split to the left, 60% of the pane; alias `nv`; kitty `ctrl+shift+e`), **Shell History (atuin)** (`atuin-pick` in a 25% split below; kitty `ctrl+shift+p`). Also **btop** (80% popup; aliases `top`, `htop`), **Lazydocker** (90% popup in the pane's cwd; alias `dd`), **mandible** (80% popup running [`mandible-pick`](../shell/scripts.md#mandible-pick); alias `man`), **television** (`tv channels`, the [channel picker](../tools/television.md), in a new window in the pane's cwd; alias `tv`), **gitframe** (git diff viewer in a new window in the pane's cwd; alias `gf`), **omp** (opens the omp palette; aliases `agent`, `ai`), **Project Tasks** (opens the tasks palette), **Sessions** (opens the sessions palette; aliases `sx`, `ss`), **Save Sessions**, and **Restore Sessions** (resurrect). Programs are started with `exec`, so the tab icon is the program's, not the shell's |
|
||||
| `palettes/tasks.json` | The **Project Tasks** palette (`prefix t`, Ghostty `ctrl+shift+p` / `ctrl+shift+space`), fed by [`pj-palette`](../shell/scripts.md#pj-palette): running background tasks under Running, then `bun install`, `bun run dev`, `uv sync`, `uv run python`, `make`, `go run .`, `cargo run`, `docker compose up` as Quick items when the project has them, then every task `pj` finds, grouped by tool. One-off tasks run in a full-width split along the bottom (25% of the window) in their directory; `ctrl-c` stops a running task, and once it has exited, `enter` or `ctrl-c` closes the pane. Dev servers (`dev`/`start`/`serve`/`watch`/`preview` tasks) and `docker compose up` run in a background session `<session>:<tool-and-command>` shown in a popup: `q` hides it with the task still running, `ctrl-c` asks `Stop <session>? (y/n)` and on `y` stops the task and closes it |
|
||||
| `palettes/omp.json` | The **omp** palette, fed by [`pj-palette --omp`](../shell/scripts.md#pj-palette): this tmux session's `<session>:omp` (open it, or start it when not running), every other tmux session's running omp, and a Quit item per session. Running agents have a green icon and show `open` or `hidden` |
|
||||
| `palettes/sessions.json` | The **Sessions** palette (`prefix o`, Ghostty `ctrl+shift+o`), fed by [`tmux-sessions`](../shell/scripts.md#tmux-sessions): Sessions (the last one first, attached ones green), Windows, Zoxide, Config, Rename, Kill. Its `query` item lists the typed text last; `enter` on it runs `tmux-sessions --new <text>` |
|
||||
| `hidden.json` | Hides the built-in **Switch Theme...** item, and with it the Appearance section: the palette stays on the fixed CherryBlossom `theme.json` |
|
||||
| `shortcuts.json` | Ghostty `ctrl+shift` chords shown next to the built-in items they trigger (New Window → `Ctrl+Shift+T`, …) |
|
||||
| `theme.json` | CherryBlossom: bg `#222120`, panel `#2e2c2b`, selected `#453130` (the active-tab plate), muted `#a6958f`, accent `#cf716f` |
|
||||
|
||||
### Persistence
|
||||
|
||||
resurrect saves sessions, windows, panes, cwds, pane contents, and a default set of programs (nvim, less, man, …). Keys: `prefix C-s` saves, `prefix C-r` restores. continuum saves automatically every 10 minutes. When a tmux server starts and no other tmux server is running, continuum restores the last save. In practice that means the first Ghostty window after login or a reboot.
|
||||
|
||||
## tmux-nerd-font-window-name.yml
|
||||
|
||||
`show-name: false`, because `automatic-rename-format` supplies the label. The icon sits on the left, with a fallback icon and a blank multi-pane icon. Icons are defined for `mprocs`, `mm`, `macmon`, `make`, `zsh`, `nvim`, `devbox`, `psql`, `yazi`, `lazygit`, `gh`, `tv`, `docker`, `bun`, `node`, `npm`, `pnpm`, `go`, `bunx`, `claude`, `omp`, and `gitframe`. The plugin parses the YAML with awk and does not interpret `\U` escapes, so the glyphs are literal characters.
|
||||
|
||||
@@ -0,0 +1,58 @@
|
||||
# Tools
|
||||
|
||||
CLI and TUI tools the repo installs and configures, with the settings applied to each.
|
||||
|
||||
This section covers the command-line and terminal-UI tools outside the shell, terminal, and desktop layers. Every tool here is universal: none of it is gated by machine role, so `desktop`, `laptop`, and `server` machines all get it (see [Installation](../installation.md)).
|
||||
|
||||
Packages come from `.chezmoidata/packages.yaml` and are installed by `run_onchange_before_10-packages.sh.tmpl` (pacman plus yay for the AUR). See [chezmoi scripts](../chezmoi/scripts.md).
|
||||
|
||||
## Configured tools
|
||||
|
||||
| Page | Tool | Source in repo | Theme |
|
||||
| --- | --- | --- | --- |
|
||||
| [Git](git.md) | git, delta, diffnav, git-split-diffs | `dot_gitconfig.tmpl` | delta colors hand-tuned (dark) |
|
||||
| [GitHub CLI](github-cli.md) | gh, gh extensions, gh-dash | `dot_config/gh/`, `dot_config/gh-dash/` | gh-dash defaults |
|
||||
| [Neovim](neovim.md) | nvim (AstroNvim) | external repo via `.chezmoiexternal.toml` | managed in the nvim repo |
|
||||
| [Yazi](yazi.md) | yazi file manager | external repo via `.chezmoiexternals/yazi.toml` | cyberdream flavor (ii-auto flavor shipped) |
|
||||
| [Lazygit](lazygit.md) | lazygit | `dot_config/lazygit/` | cyberdream colors (ii theme file shipped) |
|
||||
| [Lazydocker](lazydocker.md) | lazydocker | `dot_config/lazydocker/config.yml` | cyberdream colors |
|
||||
| [bat](bat.md) | bat | `dot_config/bat/` | cyberdream tmTheme |
|
||||
| [Topgrade](topgrade.md) | topgrade | `dot_config/topgrade.toml` | n/a |
|
||||
| [Hunk](hunk.md) | hunk diff viewer | `dot_config/hunk/config.toml` | `auto` |
|
||||
| [drydock](drydock.md) | drydock repo fleet view | `dot_config/drydock/config.toml` | n/a |
|
||||
| [television](television.md) | tv fuzzy picker, custom cables | external repo via `.chezmoiexternals/television.toml` | `cyberdream-transparent` |
|
||||
| [LeetCode](leetcode.md) | leetcode CLI, `lc-elir` | `dot_leetcode/` | n/a |
|
||||
|
||||
- [Git](git.md): Identity from chezmoi data, diff pagers, gh credential helper.
|
||||
- [Yazi](yazi.md): Keymap, plugins, bookmarks, and the Neovim bridge.
|
||||
- [Lazygit](lazygit.md): GUI options, delta renderer, custom gh commands.
|
||||
- [GitHub CLI](github-cli.md): Aliases, extensions, and the gh-dash dashboard.
|
||||
|
||||
## Other packaged CLI tools
|
||||
|
||||
These packages are declared in `.chezmoidata/packages.yaml` but have no config file in the repo. The "Wired in" column lists where the repo actually uses them.
|
||||
|
||||
| Tool | Role | Wired in |
|
||||
| --- | --- | --- |
|
||||
| `fzf` | Fuzzy finder | `FZF_DEFAULT_OPTS` in `dot_config/fish/conf.d/10-env.fish` (rounded border, cyberdream colors: highlight `#5ef1ff`, pointer `#ffaecf`, marker `#5eff6c`). Used by fish functions `c2p`, `cp-appid`, `fab`, `gtm`, `mdp`, `lc-elir`, by `~/.local/bin` scripts (`lc-elir`), and as `fuzzy_cmd` of the yazi bunny plugin. The shell pickers (`gho`, `pj`, <kbd>ctrl-e</kbd>) use [television](television.md). |
|
||||
| `fd` | File finder | `c2p`, `cp-appid`, `extract_agents`, `mdp`, `lc-elir`, `conf.d/pnpm-filter.fish`. |
|
||||
| `ripgrep` | Content search | `cp-appid`, `gtm`, `gh-sonr-org-migrate` fish functions. |
|
||||
| `zoxide` | Frecency `cd` | `zoxide init fish` in `conf.d/40-tools.fish`; the `cd` function in fish/bash/zsh falls back to `zoxide query` when the argument is not a directory, and `ghg-clone` registers new clones. |
|
||||
| `eza` | `ls` replacement | Interactive shells alias `ls` to `eza --icons` (fish `conf.d/20-aliases.fish`, `~/.config/shell/aliases.sh`). |
|
||||
| `jq` | JSON processor | `fab`, `gtm`, `gh-sonr-org-migrate`, `pnpm-filter`. |
|
||||
| `duf` | Disk usage overview | Not referenced by any config. |
|
||||
| `btop` | Resource monitor | Waybar modules launch it on click (`omarchy-launch-or-focus-tui btop`); kitty tab bar shows an icon for it. |
|
||||
| `fastfetch` | System info | Not referenced by any config. |
|
||||
| `gum` | Shell prompts and pickers | `gdc` (confirm before `git reset --hard`), `ghn` (host and org pickers), `gtm`, `ai`, `pnpm-filter`, nvm activation messages. |
|
||||
| `glow` | Markdown renderer | Kitty tab-bar icon only. |
|
||||
| `micro` | Terminal editor | Alias `sm` = `sudo micro`. |
|
||||
| `ffmpeg`, `ffmpegthumbnailer`, `poppler`, `resvg`, `imagemagick`, `7zip`, `unzip` | Media, PDF, SVG, image, and archive backends | Grouped in the manifest as yazi preview dependencies. See [Yazi](yazi.md). |
|
||||
| `wget` | HTTP downloads | Not referenced by any config. |
|
||||
| `zsh-syntax-highlighting` | zsh highlighting | Sourced by the zsh setup. See [Shell](../shell/README.md). |
|
||||
| `ttf-victor-mono-nerd` / `font-victor-mono-nerd-font` | Nerd Font | Terminal font. See [Terminal](../terminal/README.md). |
|
||||
| `suvadu`, `mandible`, `worktrunk` | Declared under `packages.shared.cargo` | Installed by [`15-tools`](../chezmoi/scripts.md#15-tools), which installs rustup first when `cargo` is missing. `mandible` backs the tmux-palette "mandible" item via `~/.local/bin/mandible-pick`. `worktrunk` is the `wt` git-worktree CLI for parallel agent workflows. |
|
||||
|
||||
Tools with their own pages in other sections: [fish](../shell/fish.md), [starship](../shell/starship.md), and [atuin](../shell/atuin.md) under Shell; [kitty](../terminal/kitty.md) and [tmux](../terminal/tmux.md) under Terminal.
|
||||
|
||||
> [!NOTE]
|
||||
> `topgrade` comes from the AUR. See the individual pages for per-tool package details.
|
||||
@@ -0,0 +1,74 @@
|
||||
# bat
|
||||
|
||||
bat with the cyberdream tmTheme, an external PureScript syntax, and automatic cache rebuilds on apply.
|
||||
|
||||
[bat](https://github.com/sharkdp/bat) is a `cat` replacement with syntax highlighting and git gutter marks. The repo sets its theme to cyberdream, adds a PureScript grammar, and rebuilds bat's cache whenever those inputs change.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Sources | `dot_config/bat/config`, `dot_config/bat/themes/cyberdream.tmTheme` |
|
||||
| External | `.config/bat/syntaxes/sublime-purescript-syntax` in `.chezmoiexternal.toml` |
|
||||
| Targets | `~/.config/bat/config`, `~/.config/bat/themes/cyberdream.tmTheme`, `~/.config/bat/syntaxes/sublime-purescript-syntax/` |
|
||||
| Packages | `bat` (pacman) |
|
||||
|
||||
## config
|
||||
|
||||
bat's config file holds default command-line flags. One is active:
|
||||
|
||||
**~/.config/bat/config**
|
||||
|
||||
```sh
|
||||
--theme="cyberdream"
|
||||
```
|
||||
|
||||
The file also carries bat's stock commented examples (`--italic-text=always`, `--paging=never`, a mouse-enabled `--pager`, `--map-syntax`); none are enabled.
|
||||
|
||||
## Theme
|
||||
|
||||
`cyberdream.tmTheme` is a TextMate theme named "Cyberdream". Base settings:
|
||||
|
||||
| Key | Color |
|
||||
| --- | --- |
|
||||
| `background` | `#16181a` |
|
||||
| `foreground`, `caret` | `#ffffff` |
|
||||
| `lineHighlight`, `selection` | `#3c4048` |
|
||||
| `findHighlight` | `#5ef1ff` |
|
||||
| `activeGuide` | `#ffbd5e` |
|
||||
| `bracketsForeground` | `#ff5ea0` (underlined) |
|
||||
| Comments | `#7b8496` |
|
||||
|
||||
The same file is also used outside bat:
|
||||
|
||||
- The [yazi](yazi.md) cyberdream flavor points `syntect_theme` at `~/.config/bat/themes/cyberdream.tmTheme`.
|
||||
- Yazi text previews run `bat -p --color=always` through the piper plugin, so they get this theme via the config file.
|
||||
|
||||
## PureScript syntax
|
||||
|
||||
**.chezmoiexternal.toml**
|
||||
|
||||
```toml
|
||||
[".config/bat/syntaxes/sublime-purescript-syntax"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/tellnobody1/sublime-purescript-syntax.git"
|
||||
[".config/bat/syntaxes/sublime-purescript-syntax".pull]
|
||||
args = ["--ff-only"]
|
||||
```
|
||||
|
||||
chezmoi clones the Sublime grammar when it is missing. With no `refreshPeriod`, it only pulls (`--ff-only`) on `chezmoi apply --refresh-externals`. See [externals and ignore rules](../chezmoi/externals-and-ignore.md).
|
||||
|
||||
## Cache rebuilds
|
||||
|
||||
bat only sees custom themes and syntaxes after `bat cache --build`. Two scripts run it:
|
||||
|
||||
| Script | When it runs |
|
||||
| --- | --- |
|
||||
| `run_onchange_after_build-bat-cache.sh.tmpl` | Embeds SHA-256 hashes of `cyberdream.tmTheme` and `config`, so it re-runs whenever either file changes. Exits quietly if `bat` is missing. |
|
||||
| `.chezmoiscripts/run_onchange_after_40-post.sh.tmpl` | Post-apply housekeeping (also runs `fc-cache` on Linux). Runs `bat cache --build` when its own rendered content changes, which includes the first apply. |
|
||||
|
||||
> [!NOTE]
|
||||
> Neither hash covers the PureScript external. If the grammar updates, run `bat cache --build` by hand.
|
||||
|
||||
## Other consumers
|
||||
|
||||
- `lc-elir` previews candidate files with `bat --color=always --line-range=:40` inside fzf. See [LeetCode](leetcode.md).
|
||||
- The kitty tab bar shows a book icon while `bat` runs.
|
||||
@@ -0,0 +1,23 @@
|
||||
# drydock
|
||||
|
||||
drydock fleet view of uncommitted, unpushed, and unreleased work, scanning the ghq root.
|
||||
|
||||
drydock lists what is uncommitted, unpushed, and unreleased across every repo under its roots.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `dot_config/drydock/config.toml` |
|
||||
| Target | `~/.config/drydock/config.toml` (holds live beside it in `holds.toml`, unmanaged) |
|
||||
| Packages | Not declared in `packages.yaml`; installed with cargo (`~/.cargo/bin/drydock`) |
|
||||
|
||||
## config.toml
|
||||
|
||||
**~/.config/drydock/config.toml**
|
||||
|
||||
```toml
|
||||
roots = ["~/Code"]
|
||||
```
|
||||
|
||||
Only `roots` is set; everything else stays at drydock's defaults (`drydock config show` prints the effective config). The root is the ghq root, where repos sit at `<host>/<owner>/<repo>`, within the default `max_depth = 4`. `~/Projects` would find nothing: it holds only symlinks (made by [`projects-sync`](../shell/scripts.md#projects-sync)), and drydock does not follow symlinks by default (`follow_symlinks = false`).
|
||||
|
||||
`drydock --root <path>` replaces the configured roots for one run.
|
||||
@@ -0,0 +1,114 @@
|
||||
# Git
|
||||
|
||||
Global git config with templated identity, three diff pagers, an nvim difftool, and gh/tea credential helpers.
|
||||
|
||||
Git's global config is a single chezmoi template. It sets the commit identity from chezmoi data, routes diffs through diffnav and git-split-diffs, styles delta for the tools that call it, and delegates HTTPS credentials to `gh` and `tea`.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `dot_gitconfig.tmpl` |
|
||||
| Target | `~/.gitconfig` |
|
||||
| Type | Template (rendered, so it is written as a regular file, not a symlink) |
|
||||
| Packages | `git`, `git-delta`, `diffnav` (pacman) |
|
||||
|
||||
> [!WARNING]
|
||||
> `git-split-diffs` (the `core.pager`) is not declared in `packages.yaml`; install it separately.
|
||||
|
||||
## Identity
|
||||
|
||||
**~/.gitconfig**
|
||||
|
||||
```ini
|
||||
[user]
|
||||
email = {{ .email }}
|
||||
name = {{ .name }}
|
||||
```
|
||||
|
||||
`.name` and `.email` are prompted once by `.chezmoi.toml.tmpl` on the first `chezmoi init` and stored in the local chezmoi config. No role or OS condition changes this file.
|
||||
|
||||
## Pagers
|
||||
|
||||
Three pagers are configured, each for a different path:
|
||||
|
||||
| Setting | Value | Applies to |
|
||||
| --- | --- | --- |
|
||||
| `pager.diff` | `diffnav` | `git diff`: file-tree diff viewer built on delta |
|
||||
| `core.pager` | `git-split-diffs --color`, piped into `less -+LFX` | Every other paged command (`git log -p`, `git show`, ...) |
|
||||
| `[split-diffs] min-line-width` | `40` | git-split-diffs side-by-side threshold |
|
||||
| `[split-diffs] theme-name` | `dark` | git-split-diffs theme |
|
||||
|
||||
`less -+LFX` resets the `-L`, `-F`, and `-X` flags, so less always takes over the screen and never exits early on short output.
|
||||
|
||||
### delta styling
|
||||
|
||||
The `[delta]` section is not a pager setting; delta reads it whenever it runs. Here that means diffnav and [lazygit](lazygit.md), which renders diffs with `delta --dark --paging=never`.
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `dark` | `true` |
|
||||
| `tabs` | `2` |
|
||||
| `file-style` / `file-decoration-style` | `omit` / `none` (no file header) |
|
||||
| `line-numbers-left-format` | `"{nm:>4} "` |
|
||||
| `line-numbers-right-format` | `"│ {np:>4} "` |
|
||||
| `line-numbers-left-style` | `white dim` |
|
||||
| `line-numbers-right-style` | `"#1f2335" dim` |
|
||||
| `line-numbers-zero-style`, `-plus-style`, `-minus-style` | `white dim` |
|
||||
| `wrap-left-symbol`, `wrap-right-symbol`, `wrap-right-prefix-symbol` | a single space each (wrap markers hidden) |
|
||||
| `plus-style` | `syntax "#0e250e"` |
|
||||
| `plus-emph-style` | `syntax "#103610"` |
|
||||
| `minus-style` | `syntax "#402a26"` |
|
||||
| `minus-emph-style` | `syntax "#45221c"` |
|
||||
| `hunk-label` | a Nerd Font glyph |
|
||||
| `hunk-header-line-number-style` | `"#10233A"` |
|
||||
| `hunk-header-style` | `"#868E99"` |
|
||||
| `hunk-header-file-style` | `"#868E99" dim` |
|
||||
| `hunk-header-decoration-style` | `"#163050" ol ul` |
|
||||
|
||||
Added and removed lines keep syntax highlighting (`syntax` foreground) on dark green and dark red backgrounds.
|
||||
|
||||
## Difftool
|
||||
|
||||
**~/.gitconfig**
|
||||
|
||||
```ini
|
||||
[diff]
|
||||
tool = codediff
|
||||
[difftool "codediff"]
|
||||
cmd = nvim \"$LOCAL\" \"$REMOTE\" +\"CodeDiff file $LOCAL $REMOTE\"
|
||||
```
|
||||
|
||||
`git difftool` opens both versions in [Neovim](neovim.md) and runs the `:CodeDiff` command, which comes from the external nvim config. Lazygit's `openDiffTool` binding (`<c-t>`) uses the same tool.
|
||||
|
||||
## Remotes and push
|
||||
|
||||
| Setting | Value | Effect |
|
||||
| --- | --- | --- |
|
||||
| `url "git@github.com:".pushInsteadOf` | `https://github.com/` | Remotes cloned over HTTPS push over SSH; fetches stay on HTTPS. |
|
||||
| `push.autoSetupRemote` | `true` | First `git push` on a new branch sets its upstream automatically. |
|
||||
| `advice.addIgnoredFile` | `false` | Silences the hint when `git add` touches an ignored path. |
|
||||
| `beads.role` | `maintainer` | Role read by the beads (`bd`) issue tracker. |
|
||||
|
||||
## Credential helpers
|
||||
|
||||
Each host block first sets an empty `helper =`, which clears any helper inherited from system config, then adds one helper:
|
||||
|
||||
| Host | Helper | Notes |
|
||||
| --- | --- | --- |
|
||||
| `https://github.com` | `!gh auth git-credential` | Uses the token from `gh auth login`. See [GitHub CLI](github-cli.md). |
|
||||
| `https://gist.github.com` | `!gh auth git-credential` | Same as above, for gists. |
|
||||
| `https://prad.codes` | `!tea login helper` | Self-hosted Gitea; uses the login stored by the `tea` CLI. |
|
||||
|
||||
No credentials are stored in the file itself.
|
||||
|
||||
## Related helpers
|
||||
|
||||
These git-adjacent commands live in `~/.local/bin` and the shell function directories. See [shell scripts](../shell/scripts.md) for the full set.
|
||||
|
||||
| Command | What it does |
|
||||
| --- | --- |
|
||||
| `gdc` | Asks for confirmation with `gum confirm`, then runs `git reset --hard HEAD` and `git clean -fd`. |
|
||||
| `gop` | Opens a repo's web page for any forge whose layout is `https://<host>/<owner>/<repo>`; defaults to `origin`, then `upstream`. Also the <kbd>ctrl-b</kbd> action of the `ghq-repos` [television](television.md#ghq-repos) cable. |
|
||||
| `git-summary` | Aggregates every `AGENTS.md` in the current repo through `code2prompt`. |
|
||||
| `ghg` / `ghg-clone` | `ghq get` a repo and `cd` into the clone; sets up a prad.codes pull mirror (your GitHub repos) or GitHub push mirror (prad.codes repos) when none exists. |
|
||||
| `ghn` | Creates a private repo on prad.codes (via `tea`) or github.com (via `gh`), clones it with ghq, and `cd`s into it. |
|
||||
| `gho` | Picks a ghq repo or Obsidian vault with the `ghq-repos` [television](television.md#ghq-repos) cable and `cd`s into it. |
|
||||
@@ -0,0 +1,159 @@
|
||||
# GitHub CLI
|
||||
|
||||
gh config and aliases, the four gh extensions installed on apply, and the gh-dash dashboard layout.
|
||||
|
||||
`gh` is GitHub's official CLI. The repo manages its global config, installs a fixed set of extensions, and configures [gh-dash](https://github.com/dlvhdr/gh-dash), a TUI dashboard for pull requests, issues, and notifications.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Sources | `dot_config/gh/private_config.yml`, `dot_config/gh-dash/config.yml` |
|
||||
| Targets | `~/.config/gh/config.yml` (mode `0600`, from the `private_` prefix), `~/.config/gh-dash/config.yml` |
|
||||
| Packages | `github-cli` (pacman) |
|
||||
| Extensions | `packages.shared.gh_extensions` in `.chezmoidata/packages.yaml` |
|
||||
|
||||
> [!NOTE]
|
||||
> Authentication is per machine: run `gh auth login` once. Tokens live in gh's `hosts.yml` or the system keyring, which the repo does not manage.
|
||||
|
||||
## gh config
|
||||
|
||||
| Key | Value | Effect |
|
||||
| --- | --- | --- |
|
||||
| `version` | `1` | Config schema version. |
|
||||
| `git_protocol` | `https` | gh clones and adds remotes over HTTPS. Pushes still go over SSH because of the `pushInsteadOf` rewrite in [Git](git.md). |
|
||||
| `editor` | empty | Falls back to the environment; fish exports `EDITOR=nvim`. |
|
||||
| `prompt` | `enabled` | Interactive prompts on. |
|
||||
| `prefer_editor_prompt` | `disabled` | Prompts inline instead of opening an editor. |
|
||||
| `pager` | empty | Falls back to the environment. |
|
||||
| `http_unix_socket` | empty | Default transport. |
|
||||
| `browser` | empty | Falls back to the environment. |
|
||||
| `color_labels` | `disabled` | Labels are not drawn in their RGB colors. |
|
||||
| `accessible_colors` | `disabled` | |
|
||||
| `accessible_prompter` | `disabled` | |
|
||||
| `spinner` | `enabled` | Animated progress spinner. |
|
||||
|
||||
### Aliases
|
||||
|
||||
| Alias | Expands to |
|
||||
| --- | --- |
|
||||
| `gh co` | `gh pr checkout` |
|
||||
|
||||
## Extensions
|
||||
|
||||
| Extension | Command | Purpose |
|
||||
| --- | --- | --- |
|
||||
| `davidraviv/gh-clean-branches` | `gh clean-branches` | Deletes local branches that no longer have a remote counterpart. |
|
||||
| `prdlk/gh-commit` | `gh commit` | The owner's commit helper; lazygit binds it as "Smart commit with AI". |
|
||||
| `dlvhdr/gh-dash` | `gh dash` | PR, issue, and notification dashboard (configured below). |
|
||||
| `meiji163/gh-notify` | `gh notify` | Notification viewer. |
|
||||
|
||||
`.chezmoiscripts/run_onchange_after_20-gh-extensions.sh.tmpl` installs them. It is a fish script, so fish's config is sourced first and `PATH` and `GITHUB_TOKEN` match a fish session:
|
||||
|
||||
1. **Re-run trigger**
|
||||
|
||||
The rendered script embeds a SHA-256 of the `gh_extensions` list, so chezmoi re-runs it whenever the list changes.
|
||||
|
||||
2. **Guards**
|
||||
|
||||
If `gh` is missing, or `gh auth status` fails, it prints a warning and exits 0. Run `gh auth login`, then `chezmoi apply` again.
|
||||
|
||||
3. **Install**
|
||||
|
||||
Reads `gh extension list` and runs `gh extension install` only for entries not already present.
|
||||
|
||||
See [chezmoi scripts](../chezmoi/scripts.md) for the full script order.
|
||||
|
||||
## gh-dash
|
||||
|
||||
Launched with `gh dash`, or <kbd>Ctrl</kbd>+<kbd>d</kbd> in lazygit's files panel.
|
||||
|
||||
### Sections
|
||||
|
||||
### Pull requests
|
||||
|
||||
| Title | Filter |
|
||||
| --- | --- |
|
||||
| My Pull Requests | `is:open author:@me` |
|
||||
| Needs My Review | `is:open review-requested:@me` |
|
||||
| Involved | `is:open involves:@me -author:@me` |
|
||||
|
||||
### Issues
|
||||
|
||||
| Title | Filter |
|
||||
| --- | --- |
|
||||
| My Issues | `is:open author:@me` |
|
||||
| Assigned | `is:open assignee:@me` |
|
||||
| Involved | `is:open involves:@me -author:@me` |
|
||||
|
||||
### Notifications
|
||||
|
||||
| Title | Filter |
|
||||
| --- | --- |
|
||||
| All | (none) |
|
||||
| Created | `reason:author` |
|
||||
| Participating | `reason:participating` |
|
||||
| Mentioned | `reason:mention` |
|
||||
| Review Requested | `reason:review-requested` |
|
||||
| Assigned | `reason:assign` |
|
||||
| Subscribed | `reason:subscribed` |
|
||||
| Team Mentioned | `reason:team-mention` |
|
||||
|
||||
### Defaults
|
||||
|
||||
| Key | Value |
|
||||
| --- | --- |
|
||||
| `defaults.view` | `prs` |
|
||||
| `defaults.preview.open` / `width` | `true` / `0.45` |
|
||||
| `defaults.prsLimit`, `issuesLimit`, `notificationsLimit` | `20` each |
|
||||
| `defaults.prApproveComment` | `LGTM` |
|
||||
| `defaults.refetchIntervalMinutes` | `30` |
|
||||
| `repo.branchesRefetchIntervalSeconds` | `30` |
|
||||
| `repo.prsRefetchIntervalSeconds` | `60` |
|
||||
| `repoPaths` | empty |
|
||||
| `confirmQuit` | `false` |
|
||||
| `showAuthorIcons` | `true` |
|
||||
| `smartFilteringAtLaunch` | `true` |
|
||||
| `includeReadNotifications` | `true` |
|
||||
| `theme.ui.sectionsShowCount` | `true` |
|
||||
| `theme.ui.table.showSeparator` / `compact` | `true` / `false` |
|
||||
|
||||
### Column layout
|
||||
|
||||
| View | Column | Width | Hidden |
|
||||
| --- | --- | --- | --- |
|
||||
| PRs | `updatedAt`, `createdAt` | 5 | no |
|
||||
| PRs | `repo` | 20 | no |
|
||||
| PRs | `author` | 15 | no |
|
||||
| PRs | `authorIcon` | | no |
|
||||
| PRs | `assignees` | 20 | yes |
|
||||
| PRs | `base` | 15 | yes |
|
||||
| PRs | `lines` | 15 | no |
|
||||
| Issues | `updatedAt`, `createdAt` | 5 | no |
|
||||
| Issues | `repo` | 15 | no |
|
||||
| Issues | `creator` | 10 | no |
|
||||
| Issues | `creatorIcon` | | no |
|
||||
| Issues | `assignees` | 20 | yes |
|
||||
|
||||
### Keybindings
|
||||
|
||||
| View | Key | Command |
|
||||
| --- | --- | --- |
|
||||
| PRs | <kbd>T</kbd> | `gh enhance -R {{.RepoName}} {{.PrNumber}}` |
|
||||
|
||||
`gh enhance` is a gh extension that is not in the managed extension list; install it separately for this binding to work.
|
||||
|
||||
### Pager
|
||||
|
||||
**~/.config/gh-dash/config.yml**
|
||||
|
||||
```yaml
|
||||
pager:
|
||||
diff: "hunk pager"
|
||||
```
|
||||
|
||||
PR diffs open in [Hunk](hunk.md).
|
||||
|
||||
## Other integrations
|
||||
|
||||
- [Lazygit](lazygit.md) custom commands call `gh repo sync && gh clean-branches --force`, `gh commit`, `gh pr create --fill -w`, `gh dash`, and `gh browse`.
|
||||
- `ghn` creates github.com repos with `gh`, and `gh-sonr-org-migrate` scripts gh for an org migration.
|
||||
- The tmux window-name map gives `gh` its own Nerd Font icon.
|
||||
@@ -0,0 +1,62 @@
|
||||
# Hunk
|
||||
|
||||
Hunk terminal diff viewer settings, used as the gh-dash diff pager.
|
||||
|
||||
[Hunk](https://github.com/modem-dev/hunk) is a review-first terminal diff viewer aimed at agent-authored changes. In this setup it is the diff pager for [gh-dash](github-cli.md#gh-dash).
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Sources | `dot_config/hunk/config.toml`, `dot_config/hunk/private_state.json` |
|
||||
| Targets | `~/.config/hunk/config.toml`, `~/.config/hunk/state.json` (mode `0600`) |
|
||||
| Packages | Not declared in `packages.yaml`; install hunk separately |
|
||||
|
||||
## config.toml
|
||||
|
||||
**~/.config/hunk/config.toml**
|
||||
|
||||
```toml
|
||||
theme = "auto"
|
||||
mode = "auto"
|
||||
vcs = "git"
|
||||
watch = false
|
||||
exclude_untracked = true
|
||||
line_numbers = true
|
||||
tab_width = 4
|
||||
wrap_lines = false
|
||||
menu_bar = true
|
||||
agent_notes = true
|
||||
prompt_save_view_preferences = false
|
||||
transparent_background = true
|
||||
```
|
||||
|
||||
| Key | Value | Effect |
|
||||
| --- | --- | --- |
|
||||
| `theme` | `auto` | Picks a built-in theme to match the terminal. |
|
||||
| `mode` | `auto` | Chooses split or stacked layout from the window width (alternatives: `split`, `stack`). |
|
||||
| `vcs` | `git` | Git backend (alternatives: `jj`, `sl`). |
|
||||
| `watch` | `false` | Does not reload on file changes. |
|
||||
| `exclude_untracked` | `true` | Untracked files are left out of working-tree diffs. |
|
||||
| `line_numbers` | `true` | Shows line numbers. |
|
||||
| `tab_width` | `4` | Tab stops every 4 columns. |
|
||||
| `wrap_lines` | `false` | Long lines are not wrapped. |
|
||||
| `menu_bar` | `true` | Shows the top menu bar. |
|
||||
| `agent_notes` | `true` | Shows agent notes when a review opens (off by default in hunk). |
|
||||
| `prompt_save_view_preferences` | `false` | Does not ask to persist view changes. |
|
||||
| `transparent_background` | `true` | Uses the terminal background instead of the theme's. |
|
||||
|
||||
No `[pager]` or per-command sections are set, so pager sessions use these top-level values.
|
||||
|
||||
## state.json
|
||||
|
||||
`private_state.json` is hunk's runtime state: the state-file `version` and `lastSeenCliVersion`, which hunk updates on its own. It holds no preferences. The `private_` prefix gives it mode `0600`.
|
||||
|
||||
## Integrations
|
||||
|
||||
**~/.config/gh-dash/config.yml**
|
||||
|
||||
```yaml
|
||||
pager:
|
||||
diff: "hunk pager"
|
||||
```
|
||||
|
||||
gh-dash pipes PR diffs into `hunk pager`. Plain `git diff` does not use hunk; it goes through diffnav (see [Git](git.md)).
|
||||
@@ -0,0 +1,47 @@
|
||||
# Lazydocker
|
||||
|
||||
Lazydocker with rounded borders and the CherryBlossom border and selection colors shared with lazygit.
|
||||
|
||||
[Lazydocker](https://github.com/jesseduffield/lazydocker) is a terminal UI for Docker containers, images, volumes, and compose projects. The config only restyles it to match [lazygit](lazygit.md).
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `dot_config/lazydocker/config.yml` |
|
||||
| Target | `~/.config/lazydocker/config.yml` |
|
||||
| Packages | `lazydocker` (pacman) |
|
||||
|
||||
## Settings
|
||||
|
||||
**~/.config/lazydocker/config.yml**
|
||||
|
||||
```yaml
|
||||
gui:
|
||||
border: rounded
|
||||
theme:
|
||||
activeBorderColor:
|
||||
- "#cf716f"
|
||||
inactiveBorderColor:
|
||||
- "#a6958f"
|
||||
selectedLineBgColor:
|
||||
- "#453130"
|
||||
optionsTextColor:
|
||||
- "#a6958f"
|
||||
```
|
||||
|
||||
| Key | Value | Palette |
|
||||
| --- | --- | --- |
|
||||
| `gui.border` | `rounded` | |
|
||||
| `activeBorderColor` | `#cf716f` | CherryBlossom primary |
|
||||
| `inactiveBorderColor` | `#a6958f` | CherryBlossom on-surface-variant |
|
||||
| `selectedLineBgColor` | `#453130` | CherryBlossom selection (primary 20% over surface) |
|
||||
| `optionsTextColor` | `#a6958f` | CherryBlossom on-surface-variant |
|
||||
|
||||
Everything else (keybindings, commands, log settings) is left at lazydocker's defaults.
|
||||
|
||||
## Launching
|
||||
|
||||
| Entry point | Behavior |
|
||||
| --- | --- |
|
||||
| `dd` | Alias for `lazydocker` in fish, bash, and zsh. It shadows the coreutils `dd` binary wherever the aliases are loaded; use `command dd` for the real one. |
|
||||
|
||||
tmux-resurrect lists `lazydocker` among the processes it restores, and the kitty tab bar shows a Docker icon while it runs.
|
||||
@@ -0,0 +1,282 @@
|
||||
# Lazygit
|
||||
|
||||
Lazygit with CherryBlossom colors, delta diffs, a full keybinding map, and custom commands wired to gh and helper scripts.
|
||||
|
||||
[Lazygit](https://github.com/jesseduffield/lazygit) is a terminal UI for git. The config sets CherryBlossom colors, renders diffs with delta, turns on background fetching and a whole-graph log, and adds custom commands that call `gh`.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `dot_config/lazygit/config.yml`, `dot_config/lazygit/ii-theme.yml` |
|
||||
| Target | `~/.config/lazygit/config.yml`, `~/.config/lazygit/ii-theme.yml` |
|
||||
| Packages | `lazygit` (pacman) |
|
||||
| Ignored | `.config/lazygit/.omc/**` (agent tooling state) |
|
||||
|
||||
## Launching
|
||||
|
||||
| Entry point | Behavior |
|
||||
| --- | --- |
|
||||
| `gg` | Alias for `lazygit` (all shells) |
|
||||
| <kbd>Ctrl</kbd>+<kbd>g</kbd> | fish and zsh keybinding |
|
||||
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>g</kbd> | [Kitty](../terminal/kitty.md): lazygit as an overlay on the current window. The tmux-host kitty config opens it in a 90% `tmux display-popup` instead. |
|
||||
|
||||
tmux-resurrect lists `lazygit` among the processes it restores.
|
||||
|
||||
## GUI
|
||||
|
||||
Colors come from the CherryBlossom palette, shared with Ghostty, tmux, and omp:
|
||||
|
||||
| Theme key | Color |
|
||||
| --- | --- |
|
||||
| `activeBorderColor` | `#cf716f` |
|
||||
| `inactiveBorderColor` | `#a6958f` |
|
||||
| `searchingActiveBorderColor` | `#c17e4a` |
|
||||
| `optionsTextColor` | `#a6958f` |
|
||||
| `selectedLineBgColor` | `#453130` |
|
||||
| `cherryPickedCommitBgColor` | `#453130` |
|
||||
| `cherryPickedCommitFgColor` | `#ad6756` |
|
||||
| `unstagedChangesColor` | `#ae825f` |
|
||||
| `defaultFgColor` | `#dcc1b7` |
|
||||
| `authorColors."*"` | `#dcc1b7` (every author the same color) |
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `border` | `rounded` |
|
||||
| `scrollHeight` / `scrollPastBottom` | `2` / `true` |
|
||||
| `scrollOffMargin` / `scrollOffBehavior` | `2` / `margin` |
|
||||
| `mouseEvents` | `true` |
|
||||
| `skipDiscardChangeWarning` | `true` |
|
||||
| `skipStashWarning` | `true` |
|
||||
| `skipNoStagedFilesWarning` | `false` |
|
||||
| `skipRewordInEditorWarning` | `false` |
|
||||
| `sidePanelWidth` | `0.4` |
|
||||
| `expandFocusedSidePanel` / `expandedSidePanelWeight` | `true` / `2` |
|
||||
| `mainPanelSplitMode` | `horizontal` |
|
||||
| `enlargedSideViewLocation` | `left` |
|
||||
| `language` | `auto` |
|
||||
| `timeFormat` / `shortTimeFormat` | `02 Jan 06` / `3:04PM` |
|
||||
| `commitLength.show` | `true` |
|
||||
| `showListFooter` | `true` |
|
||||
| `showFileTree` | `true` |
|
||||
| `showRandomTip` | `false` |
|
||||
| `showCommandLog` / `commandLogSize` | `true` / `4` |
|
||||
| `showBottomLine` | `false` (keybinding hint line hidden) |
|
||||
| `showPanelJumps` | `false` |
|
||||
| `showIcons`, `nerdFontsVersion`, `showFileIcons` | `true`, `"3"`, `true` |
|
||||
| `commitAuthorShortLength` / `commitAuthorLongLength` | `2` (initials) / `17` |
|
||||
| `commitHashLength` | `8` |
|
||||
| `showBranchCommitHash` | `true` |
|
||||
| `showDivergenceFromBaseBranch` | `arrowAndNumber` |
|
||||
| `splitDiff` | `auto` |
|
||||
| `screenMode` | `normal` |
|
||||
| `animateExplosion` | `true` |
|
||||
| `portraitMode` | `auto` |
|
||||
| `filterMode` | `fuzzy` |
|
||||
| `spinner.frames` / `spinner.rate` | ASCII bar (`\|`, `/`, `-`, `\`) / `50` ms |
|
||||
| `statusPanelView` | `allBranchesLog` |
|
||||
|
||||
## Git
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `diffRenderers` | `delta --dark --paging=never` with `colorArg: always`. delta also reads the `[delta]` section of `~/.gitconfig`; see [Git](git.md). |
|
||||
| `commit.signOff` | `false` |
|
||||
| `commit.autoWrapCommitMessage` / `autoWrapWidth` | `true` / `72` |
|
||||
| `merging.manualCommit` / `args` | `false` / empty |
|
||||
| `merging.squashMergeMessage` | `Squash merge {{selectedRef}} into {{currentBranch}}` |
|
||||
| `mainBranches` | `develop` |
|
||||
| `skipHookPrefix` | `WIP` (a message starting with `WIP` skips pre-commit hooks) |
|
||||
| `autoFetch` / `autoRefresh` / `fetchAll` | `true` / `true` / `true` |
|
||||
| `branchLogCmd` | `git log --graph --color=always --abbrev-commit --decorate --date=relative --pretty=medium {{branchName}} --` |
|
||||
| `allBranchesLogCmds` | `git log --graph --all --color=always --abbrev-commit --decorate --date=relative --pretty=medium` |
|
||||
| `overrideGpg` | `false` |
|
||||
| `disableForcePushing` | `false` |
|
||||
| `commitPrefix` / `branchPrefix` | empty |
|
||||
| `parseEmoji` | `true` |
|
||||
| `log.order` / `showGraph` / `showWholeGraph` | `topo-order` / `always` / `true` |
|
||||
| `truncateCopiedCommitHashesTo` | `8` |
|
||||
|
||||
## Refresh, updates, and OS
|
||||
|
||||
| Option | Value |
|
||||
| --- | --- |
|
||||
| `update.method` / `days` | `background` / `14` |
|
||||
| `refresher.refreshInterval` | `10` s |
|
||||
| `refresher.fetchInterval` | `60` s |
|
||||
| `confirmOnQuit` | `false` |
|
||||
| `quitOnTopLevelReturn` | `true` (<kbd>Esc</kbd> at top level quits) |
|
||||
| `disableStartupPopups` | `true` |
|
||||
| `notARepository` | `skip` (opens the most recent repo) |
|
||||
| `promptToReturnFromSubprocess` | `false` |
|
||||
| `os.edit`, `editAtLine`, `editAtLineAndWait`, `openDirInEditor`, `editPreset`, `open` | empty (lazygit defaults, which follow `$EDITOR` = nvim) |
|
||||
| `os.openLink` | `bash -C` running `~/.local/share/omarchy/bin/omarchy-launch-webapp {{link}}` (absolute path in the file) |
|
||||
| `os.copyToClipboardCmd` / `readFromClipboardCmd` | `wl-copy` / `wl-paste` |
|
||||
|
||||
> [!NOTE]
|
||||
> The link opener and the `wl-copy`/`wl-paste` clipboard commands are Wayland/Omarchy-specific. On a `server` role machine they are unavailable, so opening links and clipboard actions fail there.
|
||||
|
||||
## Custom commands
|
||||
|
||||
| Key | Context | Command | Output |
|
||||
| --- | --- | --- | --- |
|
||||
| <kbd>Ctrl</kbd>+<kbd>i</kbd> | global | `gitv {{.Repository.Owner}}/{{.Repository.Name}}` | terminal |
|
||||
| <kbd>Ctrl</kbd>+<kbd>w</kbd> | global | `gwm` | terminal |
|
||||
| <kbd>Ctrl</kbd>+<kbd>a</kbd> | global | `wrkflw` | terminal |
|
||||
| <kbd>Ctrl</kbd>+<kbd>p</kbd> | global | `github prs` | terminal |
|
||||
| <kbd>F</kbd> | files | `gh repo sync && gh clean-branches --force` ("Sync repo and clean branches, update DuckDB cache") | log |
|
||||
| <kbd>A</kbd> | files | `gh commit` ("Smart commit with AI") | terminal |
|
||||
| <kbd>C</kbd> | files | `gh commit` ("Smart commit with AI") | terminal |
|
||||
| <kbd>a</kbd> | files | `git add` the file if it has unstaged changes, else `git reset` it ("Toggle file staged") | |
|
||||
| <kbd>L</kbd> | files | `livediff` | terminal |
|
||||
| <kbd>Ctrl</kbd>+<kbd>d</kbd> | files | `gh dash` | terminal |
|
||||
| <kbd>Ctrl</kbd>+<kbd>o</kbd> | files | `gh browse` | |
|
||||
| <kbd>o</kbd> | localBranches | `gh pr create --fill -w` ("start ai pull request") | |
|
||||
| <kbd>C</kbd> | localBranches | `gh repo sync && gh clean-branches --force` | log |
|
||||
| <kbd>O</kbd> | commits | `hub browse -- "commit/{{.SelectedLocalCommit.Hash}}"` | |
|
||||
|
||||
`gh commit`, `gh clean-branches`, and `gh dash` are managed gh extensions (see [GitHub CLI](github-cli.md)). `gitv`, `gwm`, `wrkflw`, `github`, `livediff`, and `hub` are not installed by this repo.
|
||||
|
||||
> [!WARNING]
|
||||
> Several custom keys share a key with a built-in binding in the same context: <kbd>C</kbd> and <kbd>a</kbd> in files (`commitChangesWithEditor`, `toggleStagedAll`), <kbd>Ctrl</kbd>+<kbd>w</kbd>, <kbd>Ctrl</kbd>+<kbd>p</kbd>, <kbd>Ctrl</kbd>+<kbd>d</kbd>, <kbd>Ctrl</kbd>+<kbd>o</kbd> against universal bindings, and <kbd>O</kbd> in commits. <kbd>Ctrl</kbd>+<kbd>i</kbd> is the same keycode as <kbd>Tab</kbd> in most terminals.
|
||||
|
||||
## Keybindings
|
||||
|
||||
The file writes out the full keybinding map. Most values match lazygit's defaults; they are listed so the file is the single reference.
|
||||
|
||||
### Universal
|
||||
|
||||
| Action | Key |
|
||||
| --- | --- |
|
||||
| `quit` / `quit-alt1` | <kbd>q</kbd> / <kbd>Ctrl</kbd>+<kbd>q</kbd> |
|
||||
| `return` | <kbd>Esc</kbd> |
|
||||
| `quitWithoutChangingDirectory` | <kbd>Q</kbd> |
|
||||
| `togglePanel` | <kbd>Tab</kbd> |
|
||||
| `prevItem` / `nextItem` | <kbd>Up</kbd> / <kbd>Down</kbd> |
|
||||
| `prevItem-alt` / `nextItem-alt` | <kbd>k</kbd> / <kbd>j</kbd> |
|
||||
| `prevPage` / `nextPage` | <kbd>,</kbd> / <kbd>.</kbd> |
|
||||
| `scrollLeft` / `scrollRight` | <kbd>H</kbd> / <kbd>L</kbd> |
|
||||
| `gotoTop` / `gotoBottom` | `<` / `>` |
|
||||
| `toggleRangeSelect` | <kbd>v</kbd> |
|
||||
| `rangeSelectDown` / `rangeSelectUp` | <kbd>Shift</kbd>+<kbd>Down</kbd> / <kbd>Shift</kbd>+<kbd>Up</kbd> |
|
||||
| `prevBlock` / `nextBlock` | <kbd>Left</kbd> / <kbd>Right</kbd> |
|
||||
| `prevBlock-alt` / `nextBlock-alt` | <kbd>h</kbd> / <kbd>l</kbd> |
|
||||
| `nextBlock-alt2` / `prevBlock-alt2` | <kbd>Tab</kbd> / <kbd>Shift</kbd>+<kbd>Tab</kbd> |
|
||||
| `jumpToBlock` | <kbd>1</kbd>–<kbd>5</kbd> |
|
||||
| `nextMatch` / `prevMatch` | <kbd>n</kbd> / <kbd>N</kbd> |
|
||||
| `startSearch` | <kbd>/</kbd> |
|
||||
| `optionMenu` | <kbd>?</kbd> |
|
||||
| `select` | <kbd>Space</kbd> |
|
||||
| `goInto` / `confirm` | <kbd>Enter</kbd> |
|
||||
| `confirmInEditor` | <kbd>Alt</kbd>+<kbd>Enter</kbd> |
|
||||
| `remove` | <kbd>d</kbd> |
|
||||
| `new` | <kbd>n</kbd> |
|
||||
| `edit` | <kbd>e</kbd> |
|
||||
| `openFile` | <kbd>o</kbd> |
|
||||
| `scrollUpMain` / `scrollDownMain` | <kbd>PgUp</kbd> / <kbd>PgDn</kbd> |
|
||||
| `scrollUpMain-alt1` / `scrollDownMain-alt1` | <kbd>K</kbd> / <kbd>J</kbd> |
|
||||
| `scrollUpMain-alt2` / `scrollDownMain-alt2` | <kbd>Ctrl</kbd>+<kbd>u</kbd> / <kbd>Ctrl</kbd>+<kbd>d</kbd> |
|
||||
| `createRebaseOptionsMenu` | <kbd>m</kbd> |
|
||||
| `pushFiles` / `pullFiles` | <kbd>P</kbd> / <kbd>p</kbd> |
|
||||
| `refresh` | <kbd>R</kbd> |
|
||||
| `createPatchOptionsMenu` | <kbd>Ctrl</kbd>+<kbd>p</kbd> |
|
||||
| `nextTab` / `prevTab` | <kbd>]</kbd> / <kbd>[</kbd> |
|
||||
| `nextScreenMode` / `prevScreenMode` | <kbd>+</kbd> / <kbd>_</kbd> |
|
||||
| `undo` / `redo` | <kbd>z</kbd> / <kbd>Ctrl</kbd>+<kbd>z</kbd> |
|
||||
| `filteringMenu` | <kbd>Ctrl</kbd>+<kbd>s</kbd> |
|
||||
| `diffingMenu` / `diffingMenu-alt` | <kbd>W</kbd> / <kbd>Ctrl</kbd>+<kbd>e</kbd> |
|
||||
| `copyToClipboard` | <kbd>Ctrl</kbd>+<kbd>o</kbd> |
|
||||
| `openRecentRepos` | <kbd>Ctrl</kbd>+<kbd>r</kbd> |
|
||||
| `submitEditorText` | <kbd>Enter</kbd> |
|
||||
| `extrasMenu` | <kbd>@</kbd> |
|
||||
| `toggleWhitespaceInDiffView` | <kbd>Ctrl</kbd>+<kbd>w</kbd> |
|
||||
| `increaseContextInDiffView` / `decreaseContextInDiffView` | `}` / `{` |
|
||||
| `increaseRenameSimilarityThreshold` / `decrease...` | <kbd>)</kbd> / <kbd>(</kbd> |
|
||||
| `openDiffTool` | <kbd>Ctrl</kbd>+<kbd>t</kbd> (runs the nvim `codediff` difftool) |
|
||||
| `newWorktree` | <kbd>w</kbd> |
|
||||
|
||||
### Status
|
||||
|
||||
| Action | Key |
|
||||
| --- | --- |
|
||||
| `checkForUpdate` | <kbd>u</kbd> |
|
||||
| `recentRepos` | <kbd>Enter</kbd> |
|
||||
| `allBranchesLogGraph` | <kbd>a</kbd> |
|
||||
|
||||
### Files
|
||||
|
||||
| Action | Key |
|
||||
| --- | --- |
|
||||
| `commitChanges` | <kbd>c</kbd> |
|
||||
| `commitChangesWithoutHook` | <kbd>w</kbd> |
|
||||
| `amendLastCommit` | <kbd>E</kbd> |
|
||||
| `commitChangesWithEditor` | <kbd>C</kbd> |
|
||||
| `findBaseCommitForFixup` | <kbd>Ctrl</kbd>+<kbd>f</kbd> |
|
||||
| `confirmDiscard` | <kbd>x</kbd> |
|
||||
| `ignoreFile` | <kbd>i</kbd> |
|
||||
| `refreshFiles` | <kbd>r</kbd> |
|
||||
| `stashAllChanges` / `viewStashOptions` | <kbd>s</kbd> / <kbd>S</kbd> |
|
||||
| `toggleStagedAll` | <kbd>a</kbd> |
|
||||
| `viewResetOptions` | <kbd>D</kbd> |
|
||||
| `fetch` | <kbd>f</kbd> |
|
||||
| `toggleTreeView` | `` ` `` |
|
||||
| `openMergeOptions` | <kbd>M</kbd> |
|
||||
| `openStatusFilter` | <kbd>Ctrl</kbd>+<kbd>b</kbd> |
|
||||
| `copyFileInfoToClipboard` | <kbd>y</kbd> |
|
||||
|
||||
### Branches
|
||||
|
||||
| Action | Key |
|
||||
| --- | --- |
|
||||
| `createPullRequest` | <kbd>1</kbd> |
|
||||
| `viewPullRequestOptions` | <kbd>O</kbd> |
|
||||
| `copyPullRequestURL` | <kbd>Ctrl</kbd>+<kbd>y</kbd> |
|
||||
| `checkoutBranchByName` | <kbd>c</kbd> |
|
||||
| `forceCheckoutBranch` | <kbd>F</kbd> |
|
||||
| `rebaseBranch` | <kbd>r</kbd> |
|
||||
| `renameBranch` | <kbd>R</kbd> |
|
||||
| `mergeIntoCurrentBranch` | <kbd>M</kbd> |
|
||||
| `viewGitFlowOptions` | <kbd>i</kbd> |
|
||||
| `fastForward` / `fetchRemote` | <kbd>f</kbd> |
|
||||
| `createTag` / `pushTag` | <kbd>T</kbd> / <kbd>P</kbd> |
|
||||
| `setUpstream` | <kbd>u</kbd> |
|
||||
| `sortOrder` | <kbd>s</kbd> |
|
||||
|
||||
### Commits
|
||||
|
||||
| Action | Key |
|
||||
| --- | --- |
|
||||
| `squashDown` | <kbd>s</kbd> |
|
||||
| `renameCommit` / `renameCommitWithEditor` | <kbd>r</kbd> / <kbd>R</kbd> |
|
||||
| `viewResetOptions` | <kbd>g</kbd> |
|
||||
| `markCommitAsFixup` / `createFixupCommit` | <kbd>f</kbd> / <kbd>F</kbd> |
|
||||
| `squashAboveCommits` | <kbd>S</kbd> |
|
||||
| `moveDownCommit` / `moveUpCommit` | <kbd>Ctrl</kbd>+<kbd>j</kbd> / <kbd>Ctrl</kbd>+<kbd>k</kbd> |
|
||||
| `resetCommitAuthor` | <kbd>a</kbd> |
|
||||
| `pickCommit` | <kbd>p</kbd> |
|
||||
| `revertCommit` | <kbd>t</kbd> |
|
||||
| `cherryPickCopy` / `pasteCommits` | <kbd>C</kbd> / <kbd>V</kbd> |
|
||||
| `markCommitAsBaseForRebase` | <kbd>B</kbd> |
|
||||
| `tagCommit` | <kbd>T</kbd> |
|
||||
| `checkoutCommit` | <kbd>Space</kbd> |
|
||||
| `resetCherryPick` | <kbd>Ctrl</kbd>+<kbd>c</kbd> |
|
||||
| `copyCommitAttributeToClipboard` | <kbd>y</kbd> |
|
||||
| `openLogMenu` | <kbd>Ctrl</kbd>+<kbd>l</kbd> |
|
||||
| `openInBrowser` | <kbd>o</kbd> |
|
||||
| `viewBisectOptions` | <kbd>b</kbd> |
|
||||
| `startInteractiveRebase` | <kbd>i</kbd> |
|
||||
|
||||
### Other panels
|
||||
|
||||
| Panel | Action | Key |
|
||||
| --- | --- | --- |
|
||||
| amendAttribute | `resetAuthor` / `setAuthor` / `addCoAuthor` | <kbd>a</kbd> / <kbd>A</kbd> / <kbd>c</kbd> |
|
||||
| stash | `popStash` / `renameStash` | <kbd>g</kbd> / <kbd>r</kbd> |
|
||||
| commitFiles | `checkoutCommitFile` | <kbd>c</kbd> |
|
||||
| main | `toggleSelectHunk` / `pickBothHunks` / `editSelectHunk` | <kbd>a</kbd> / <kbd>b</kbd> / <kbd>E</kbd> |
|
||||
| submodules | `init` / `update` / `bulkMenu` | <kbd>i</kbd> / <kbd>u</kbd> / <kbd>b</kbd> |
|
||||
| commitMessage | `commitMenu` | <kbd>Ctrl</kbd>+<kbd>o</kbd> |
|
||||
|
||||
## ii-theme.yml
|
||||
|
||||
`ii-theme.yml` is generated by the ii wallpaper theming system and holds only a `gui.theme` block: white active border (bold), grey `#8F9192` inactive border, `#1F1F1F` selection and cherry-pick backgrounds, `#FFF17B` marked base commit, `#FF9BAD` unstaged changes, `#DFE3E3` default text.
|
||||
|
||||
Nothing in the repo loads it, so `config.yml`'s cyberdream colors are what lazygit uses. To apply it, pass both files: `LG_CONFIG_FILE="$HOME/.config/lazygit/config.yml,$HOME/.config/lazygit/ii-theme.yml" lazygit`.
|
||||
@@ -0,0 +1,89 @@
|
||||
# LeetCode
|
||||
|
||||
LeetCode CLI workspace config, its tracked state files, and the lc-elir helper that sends solutions to omp.
|
||||
|
||||
The repo tracks the state directory of a terminal LeetCode client, plus a helper that feeds solution files to omp prompt commands. The `~/.leetcode` layout (workspaces with `collab.json`, `timer.json`, and `snapshots/`) matches [night-slayer18/leetcode-cli](https://github.com/night-slayer18/leetcode-cli), which is invoked as `leetcode`.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `dot_leetcode/` |
|
||||
| Target | `~/.leetcode/` |
|
||||
| Packages | The CLI is not declared in `packages.yaml`; install it separately |
|
||||
| Alias | `lc` = `leetcode` (fish, bash, zsh) |
|
||||
|
||||
```text
|
||||
dot_leetcode/
|
||||
workspaces.json
|
||||
star-prompt.json
|
||||
version-cache.json
|
||||
workspaces/
|
||||
default/
|
||||
config.json
|
||||
collab.json
|
||||
timer.json
|
||||
snapshots/
|
||||
.keep
|
||||
```
|
||||
|
||||
## Workspaces
|
||||
|
||||
`workspaces.json` lists one workspace, `default`, and marks it active.
|
||||
|
||||
**~/.leetcode/workspaces/default/config.json**
|
||||
|
||||
```json
|
||||
{
|
||||
"workDir": "/home/prad/Code/github.com/prdlk/leetcode/work/1",
|
||||
"lang": "python3",
|
||||
"site": "leetcode.com",
|
||||
"editor": "nvim",
|
||||
"syncRepo": "https://github.com/prdlk/leetcode.git"
|
||||
}
|
||||
```
|
||||
|
||||
| Key | Value | Effect |
|
||||
| --- | --- | --- |
|
||||
| `workDir` | `~/Code/github.com/prdlk/leetcode/work/1` (absolute path in the file) | Where problem files are written. It sits inside the ghq checkout of the solutions repo, under `$GHQ_ROOT`. |
|
||||
| `lang` | `python3` | Default solution language. |
|
||||
| `site` | `leetcode.com` | Target site. |
|
||||
| `editor` | `nvim` | Opens problems in [Neovim](neovim.md). |
|
||||
| `syncRepo` | `https://github.com/prdlk/leetcode.git` | Repo that solutions sync to. |
|
||||
|
||||
The path is absolute, so on a machine with a different username or `$GHQ_ROOT`, edit `workDir`.
|
||||
|
||||
The other workspace files start empty: `collab.json` has `"session": null`, `timer.json` has no solve times and no active timer, and `snapshots/` holds only a `.keep` placeholder.
|
||||
|
||||
## Tracked state files
|
||||
|
||||
| File | Contents |
|
||||
| --- | --- |
|
||||
| `star-prompt.json` | Counter for the CLI's "star the repo" prompt: accepted-submission total, milestones already shown, submissions since the last prompt, timestamps, and a `dismissed` flag. |
|
||||
| `version-cache.json` | Last update check time, latest known version, and whether it has breaking changes. |
|
||||
|
||||
These are runtime files. In chezmoi's symlink mode, non-template, non-private files are symlinks into the source directory, so the CLI writes these straight into the repo working tree. Expect them to show up as diffs.
|
||||
|
||||
## lc-elir
|
||||
|
||||
`lc-elir [root]` picks LeetCode solution files with fzf and runs the omp `/leetcode-eli5` command on each one.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Sources | `dot_local/bin/executable_lc-elir` (POSIX sh), `dot_config/fish/functions/lc-elir.fish` (fish port) |
|
||||
| Targets | `~/.local/bin/lc-elir`, `~/.config/fish/functions/lc-elir.fish` |
|
||||
| Needs | `fd`, `fzf`, `bat`, `omp` |
|
||||
|
||||
1. **Find candidates**
|
||||
|
||||
`fd --type f '^\d+\..+\.(js|ts)$'` under `root` (default `.`) matches numbered problem files such as `1365.some-slug.js`.
|
||||
|
||||
2. **Pick**
|
||||
|
||||
`fzf --multi` with prompt `eli5> `, showing the last three path segments (`--delimiter=/ --with-nth=-3..`). The right-hand 60% preview shows the first 40 lines through `bat --color=always --line-range=:40`.
|
||||
|
||||
3. **Run**
|
||||
|
||||
For each selected file it prints a separator line, then runs `omp -p "/leetcode-eli5 <file>"`. It exits 1 if nothing was picked.
|
||||
|
||||
## omp commands
|
||||
|
||||
`lc-elir` runs the `/leetcode-eli5` omp command, which lives in `~/.omp/agent/commands/` and is not managed by this repo.
|
||||
@@ -0,0 +1,56 @@
|
||||
# Neovim
|
||||
|
||||
Neovim config pulled from its own repository as a chezmoi external, plus the editor hooks the dotfiles wire into it.
|
||||
|
||||
Neovim is the default editor everywhere in this setup. Its configuration (AstroNvim-based, per the repo README) lives in a separate repository, [prdlk/nvim](https://github.com/prdlk/nvim). This repo only clones it and wires other tools to it; the Lua config itself is not documented here.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `.chezmoiexternal.toml` entry `.config/nvim` |
|
||||
| Target | `~/.config/nvim` (a git checkout) |
|
||||
| Remote | `https://github.com/prdlk/nvim.git` |
|
||||
| Packages | `neovim` (pacman) |
|
||||
|
||||
## How the external works
|
||||
|
||||
**.chezmoiexternal.toml**
|
||||
|
||||
```toml
|
||||
[".config/nvim"]
|
||||
type = "git-repo"
|
||||
url = "https://github.com/prdlk/nvim.git"
|
||||
[".config/nvim".pull]
|
||||
args = ["--ff-only"]
|
||||
```
|
||||
|
||||
- `type = "git-repo"`: chezmoi runs `git clone` when `~/.config/nvim` does not exist, so a fresh machine gets the config on first apply.
|
||||
- No `refreshPeriod` is set, so a normal `chezmoi apply` never pulls. The local checkout always wins; commit and push nvim changes from `~/.config/nvim` directly.
|
||||
- A forced refresh (`chezmoi apply --refresh-externals`) runs `git pull --ff-only`, which refuses to merge if local history has diverged.
|
||||
|
||||
See [externals and ignore rules](../chezmoi/externals-and-ignore.md) for how chezmoi handles externals in general.
|
||||
|
||||
### Ignored runtime paths
|
||||
|
||||
`.chezmoiignore.tmpl` keeps chezmoi away from state that tools write inside the checkout:
|
||||
|
||||
| Path | Why |
|
||||
| --- | --- |
|
||||
| `.config/nvim/lazy-lock.json` | lazy.nvim lockfile, rewritten on plugin updates |
|
||||
| `.config/nvim/.git`, `.config/nvim/.git/**` | the checkout's own git metadata |
|
||||
| `.config/nvim/.omc/**` | agent tooling state |
|
||||
| `.config/nvim/.crush/**` | agent tooling state |
|
||||
| `.config/nvim/.understand-anything/**` | agent tooling state |
|
||||
|
||||
## Integrations in this repo
|
||||
|
||||
| Where | What |
|
||||
| --- | --- |
|
||||
| `dot_config/fish/conf.d/10-env.fish` | `EDITOR=nvim`. [gh](github-cli.md) falls back to it because its `editor` key is empty. |
|
||||
| [Aliases](../shell/aliases.md) | `e` = `nvim`; `e.v` opens `~/.config/nvim/lua` in yazi; `e.t` opens the tmux config in nvim. |
|
||||
| [Kitty](../terminal/kitty.md) | <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>e</kbd> opens nvim in the current directory in a 50/50 vertical split. Kitty's `listen_on` socket lets nvim hand <kbd>Ctrl</kbd>+<kbd>h/j/k/l</kbd> at a window edge back to kitty. |
|
||||
| [Yazi](yazi.md) | The `edit` opener and <kbd>Ctrl</kbd>+<kbd>v</kbd> / <kbd>Ctrl</kbd>+<kbd>x</kbd> call `~/.local/bin/yazi-nvim-open`. Inside an nvim terminal (`$NVIM` set) files open in the host instance through the nvim-side `EditFromYazi` Lua function; otherwise a blocking `nvim` starts. |
|
||||
| [Git](git.md) | `git difftool` runs `nvim "$LOCAL" "$REMOTE" +"CodeDiff file $LOCAL $REMOTE"`. |
|
||||
| [LeetCode](leetcode.md) | The default workspace sets `"editor": "nvim"`. |
|
||||
|
||||
> [!NOTE]
|
||||
> `yazi-nvim-open` depends on `_G.EditFromYazi`, which the nvim repo defines (its header points at `lua/config/yazi_session.lua`). If that function is missing, the remote call fails and nothing opens.
|
||||
@@ -0,0 +1,182 @@
|
||||
# television
|
||||
|
||||
tv config symlinked from the repo, a transparent cyberdream theme, and the custom cables behind gho, pj, and ctrl-e in fish, zsh, and bash.
|
||||
|
||||
[television](https://github.com/alexpasmantier/television) (`tv`) is a fuzzy picker built on "cables": TOML files that define a source command, a preview, and actions. Every shell picker in the repo runs on a tv cable, with the same keys in fish, zsh, and bash.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | [prdlk/television](https://github.com/prdlk/television) via `.chezmoiexternals/television.toml`: `config.toml`, `cable/*.toml`, `themes/cyberdream-transparent.toml` |
|
||||
| Target | `~/.config/television/` |
|
||||
| Install | Not listed in `.chezmoidata/packages.yaml`; install separately |
|
||||
|
||||
`~/.config/television` is a `git-repo` checkout (pulled `--ff-only` every 168h), so edits apply immediately; commit and push them from there. `cable/` holds tv's stock cables plus the repo's own and overridden ones.
|
||||
|
||||
## config.toml
|
||||
|
||||
The UI is minimal: no borders, a hidden status bar, and padding in place of frames.
|
||||
|
||||
| Key | Value |
|
||||
| --- | --- |
|
||||
| `default_channel` | `files` |
|
||||
| `ui.theme` | `cyberdream-transparent` |
|
||||
| `ui.input_bar` | position `top`, prompt `❯`, `border_type = "none"`, padding left 1, right 1, bottom 1 |
|
||||
| `ui.status_bar.hidden` | `true` (<kbd>f12</kbd> toggles it) |
|
||||
| `ui.results_panel` | `border_type = "none"`, padding left 1, right 1 |
|
||||
| `ui.preview_panel` | `size = 50`, `scrollbar = false`, `border_type = "none"`, padding left 2, right 1 |
|
||||
| `ui.help_panel.hidden` | `true` |
|
||||
|
||||
tv 0.15 has no config key for inline mode (`--inline` and `--height` are CLI-only), so every call site passes `--inline`: `gho` (`tv ghq-repos --inline`), `pj` (`tv pj --inline …`), <kbd>ctrl-e</kbd> (`tv git-files --inline`), and bash <kbd>ctrl-t</kbd> (`tv --autocomplete-prompt … --inline`). Actions that re-exec tv pass it too: `files` (`tv files .. --inline`), `dirs` (`tv dirs .. --inline`), and `channels` (`tv {} --inline`). `tv --inline` opens on the line below the prompt and leaves the cursor there on exit; the shell key bindings move the prompt back ([fish](../shell/fish.md#key-bindings), [bash and zsh](../shell/bash-zsh.md)).
|
||||
|
||||
A channel that sets its own `[ui.preview_panel]` replaces the whole table with tv's defaults (rounded border, scrollbar). The stock cables that override it (`alias`, `cargo-commands`, `crontab`, `env`, `fonts`, `gh-issues`, `journal`, `man-pages`, `npm-scripts`, `opencode-sessions`, `ports`, `tea-issues`, `tea-prs`, `text`, `todo-comments`) therefore repeat `border_type = "none"`, `scrollbar = false`, and padding left 2, right 1.
|
||||
|
||||
Global keys added on top of the defaults:
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>ctrl-e</kbd> | `actions:edit`: the channel's `edit` action |
|
||||
| <kbd>ctrl-h</kbd> | `actions:goto_parent_dir`; the help panel loses <kbd>ctrl-h</kbd> |
|
||||
| <kbd>end</kbd> | `go_to_input_end` (unchanged) |
|
||||
|
||||
## Theme
|
||||
|
||||
`themes/cyberdream-transparent.toml` is a separate file because tv 0.15's builtin `cyberdream` shadows a user theme of the same name and paints an opaque `#16181a` background. This theme omits `background`, so kitty's translucent background shows through (tv 0.15 rejects `background = 'none'`).
|
||||
|
||||
| Key | Color |
|
||||
| --- | --- |
|
||||
| `border_fg` | `#3c4048` |
|
||||
| `text_fg`, `input_text_fg`, `result_value_fg` | `#ffffff` |
|
||||
| `dimmed_text_fg` | `#7b8496` |
|
||||
| `result_name_fg` | `#5ea1ff` |
|
||||
| `result_line_number_fg` | `#f1ff5e` |
|
||||
| `match_fg` | `#5ef1ff` |
|
||||
| `selection_fg` / `selection_bg` | `#5eff6c` on `#3c4048` |
|
||||
| `preview_title_fg` | `#ffaecf` |
|
||||
| `result_count_fg` | `#ffbd5e` |
|
||||
| `channel_mode_bg` | `#5ef1ff` on `#16181a` |
|
||||
| `remote_control_mode_bg` | `#5eff6c` on `#16181a` |
|
||||
| `action_picker_mode_bg` | `#bd5eff` on `#16181a` |
|
||||
|
||||
## Sorting
|
||||
|
||||
Every custom cable except `agents` (a fixed list, see [agents](#agents)), `omp-sessions` (sorted by [`omp-session`](../shell/scripts.md#omp-session) itself), and `jobs` (fish's job order) pipes its source through [`mtime-sort`](../shell/scripts.md#mtime-sort), which orders lines newest-first by the mtime of the path in the line's last tab-separated field (`--repo` stats `<path>/.git/index` first). tv then ranks match quality and frecency on top of that order. All custom cables set `shell = "bash"`, because `$SHELL` is fish.
|
||||
|
||||
## Custom cables
|
||||
|
||||
| Cable | File | Opened by |
|
||||
| --- | --- | --- |
|
||||
| [`ghq-repos`](#ghq-repos) | `cable/ghq-repos.toml` | <kbd>ctrl-o</kbd> (`gho`) |
|
||||
| [`git-files`](#git-files) | `cable/git-files.toml` | <kbd>ctrl-e</kbd> |
|
||||
| [`pj`](#pj) | `cable/pj.toml` | <kbd>ctrl-p</kbd>, <kbd>down</kbd> on an empty prompt (`pj`) |
|
||||
| [`files`](#files) | `cable/files.toml` | `tv`, <kbd>ctrl-t</kbd> autocomplete |
|
||||
| [`obsidian`](#obsidian) | `cable/obsidian.toml` | `tv obsidian` |
|
||||
| [`agents`](#agents) | `cable/agents.toml` | `tv agents` |
|
||||
| [`omp-sessions`](#omp-sessions) | `cable/omp-sessions.toml` | `tv omp-sessions`, <kbd>ctrl-a</kbd> (`omp-session`) when it has nothing to resume |
|
||||
| [`jobs`](#jobs) | `cable/jobs.toml` | <kbd>ctrl-z</kbd> in fish (`_jobs_bind`) with two or more background jobs |
|
||||
| [`kitty-days`](#kitty-days) | `cable/kitty-days.toml` | `tv kitty-days` |
|
||||
|
||||
The keys are bound in fish (`fish_user_key_bindings.fish`), zsh (`keybinds.zsh`), and bash (`keybinds.bash`); bash has no <kbd>ctrl-a</kbd> binding, and <kbd>ctrl-z</kbd> is fish only. See [fish](../shell/fish.md#key-bindings) and [bash and zsh](../shell/bash-zsh.md).
|
||||
|
||||
### ghq-repos
|
||||
|
||||
Entries are `name<TAB>path`: tv shows and matches the name and prints the path. <kbd>ctrl-s</kbd> cycles between the two sources.
|
||||
|
||||
| Source | Entries | Sort |
|
||||
| --- | --- | --- |
|
||||
| Repos | `ghq list` under `ghq root`, plus two checkouts outside it: the chezmoi source (`~/.local/share/chezmoi`) and the nvim config (`~/.config/nvim`) as `github.com/prdlk/nvim`. Those two win over a ghq clone with the same name | `mtime-sort --repo` |
|
||||
| Vaults | Every directory under `~/Documents/Obsidian` (depth 3) that contains `.obsidian`, named relative to that directory | `mtime-sort` |
|
||||
|
||||
**Preview.** Two commands; <kbd>ctrl-f</kbd> cycles. The default is the commit graph for git directories: `git log --graph --all`, newest 300 commits, as short hash, relative date, subject and refs. The second is `onefetch --no-art`. Non-git directories show `eza --tree --level 2` (falling back to `ls -la`) in both.
|
||||
|
||||
[serie](https://github.com/lusingander/serie) cannot draw inside the preview pane: it is a fullscreen TUI that paints its graph with kitty images and has no print mode. <kbd>ctrl-g</kbd> opens it instead.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>enter</kbd> | Print the path. The `gho` function cds into it, clears, and runs `onefetch` in git repos |
|
||||
| <kbd>ctrl-e</kbd> | `edit`: `cd <path> && nvim .` on `/dev/tty` |
|
||||
| <kbd>ctrl-b</kbd> | `browse`: `cd <path> && gop` in fork mode, so tv stays open ([gop](../shell/scripts.md#gop)) |
|
||||
| <kbd>ctrl-g</kbd> | `history`: `serie` on `/dev/tty` in fork mode for git directories; <kbd>q</kbd> returns to the picker |
|
||||
|
||||
**Needs:** `ghq`, `fd`, `git`, `serie`, `onefetch`, `mtime-sort`.
|
||||
|
||||
### git-files
|
||||
|
||||
| Source | Entries |
|
||||
| --- | --- |
|
||||
| Tracked | `git ls-files` of the whole repo (from the toplevel), or `fd -t f` outside a repo |
|
||||
| All | `fd -t f -H -E .git` |
|
||||
|
||||
Both are sorted with `mtime-sort`. The preview is `bat -n` with `BAT_THEME=ansi`. <kbd>enter</kbd> runs `edit`: `nvim {}` on `/dev/tty`.
|
||||
|
||||
**Needs:** `git`, `fd`, `bat`, `mtime-sort`.
|
||||
|
||||
### pj
|
||||
|
||||
Source `pj --list`; tv shows the display column. The preview runs `pj --preview` in the global 50% panel, and <kbd>enter</kbd> runs `pj --run`. Running `pj` scans the project and opens this cable with its own records. See [pj](../shell/scripts.md#pj).
|
||||
|
||||
**Needs:** `pj`, `mtime-sort`.
|
||||
|
||||
### files
|
||||
|
||||
Overrides tv's stock `files` cable. Sources `Default` (`fd -t f`) and `Hidden` (`fd -t f -H`), both piped through `mtime-sort`. The `edit` action opens the selection in `nvim` on `/dev/tty`, so it also works from <kbd>ctrl-t</kbd>, where the shell captures tv's stdout.
|
||||
|
||||
**Needs:** `fd`, `bat`, `mtime-sort`.
|
||||
|
||||
### obsidian
|
||||
|
||||
Entries are `name<TAB>path` for every directory under `~/Documents/Obsidian` (depth 3) that contains `.obsidian`, named relative to that directory (nested vaults show as `Research/Sonr`) and sorted with `mtime-sort`. The preview is `eza --tree --level 2`.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>enter</kbd> | `open`: `xdg-open obsidian://open?path=<path>`, detached with `setsid -f` because the generic `xdg-open` stays in the foreground |
|
||||
| <kbd>ctrl-e</kbd> | `edit`: `cd <path> && nvim .` |
|
||||
|
||||
`obsidian://open?path=` only resolves vaults listed in `~/.config/obsidian/obsidian.json`, and Obsidian reads that file once at startup and rewrites it from memory. So when the vault is not listed and Obsidian is closed, `open` adds `{path, ts}` under a random 16-hex id first. When Obsidian is running, it sends a notification and opens the vault switcher (`obsidian://choose-vault`) for **Open folder as vault**.
|
||||
|
||||
**Needs:** `fd`, `jq`, `eza`, `obsidian`, `xdg-open`, `mtime-sort`.
|
||||
|
||||
### agents
|
||||
|
||||
The source is a table of known agent CLIs in the cable, `binary|launch command|description`, kept in table order (`omp` first). A row is listed only when `command -v <binary>` resolves, so agents appear and disappear as they are installed. Entries are `<name description><TAB><launch command><TAB><binary>`; the description is part of the matched text, so `openai` finds `codex`.
|
||||
|
||||
| Agents in the table | Launch |
|
||||
| --- | --- |
|
||||
| `omp`, `claude`, `codex`, `opencode`, `crush`, `pi`, `cursor-agent`, `copilot`, `gemini`, `agy`, `grok`, `muse`, `ori`, `hermes`, `amp`, `droid`, `qwen`, `kimi`, `goose`, `aider`, `auggie`, `kiro-cli`, `cn`, `fractal` | The binary, except `claude --dangerously-skip-permissions` (same as `ai`) |
|
||||
|
||||
The preview shows the launch command, the path on `PATH`, its `readlink -f` target, and, for the `~/.local/bin` wrappers that install the agent through mise on first run, the mise tool. It never runs the agent, since some wrappers take seconds to answer `--version`.
|
||||
|
||||
<kbd>enter</kbd> runs `launch` in execute mode: tv exits and the launch command runs in its place, in the current directory.
|
||||
|
||||
**Needs:** nothing beyond the agents themselves.
|
||||
|
||||
### omp-sessions
|
||||
|
||||
Source `omp-session --list`: the omp sessions of the current git repo, newest first, as `<age> <branch> <title>[ · <subdir>]<TAB><session file>`. tv shows and matches the display column, so typing a branch name filters to its sessions. The branch is the one HEAD was on when the session was last written, from the reflog; see [omp-session](../shell/scripts.md#omp-session).
|
||||
|
||||
The preview runs `omp-session --preview`: title, last-write time and cwd, then the text of every user and assistant message. <kbd>enter</kbd> runs `resume` in execute mode, `omp-session --resume <file>`, which `exec`s `omp --resume <file>`. <kbd>ctrl-n</kbd> runs `new`, `omp-session --new`, which starts a fresh `omp` session. In this cable <kbd>ctrl-n</kbd> no longer moves to the next entry; <kbd>down</kbd> and <kbd>ctrl-j</kbd> still do.
|
||||
|
||||
**Needs:** `omp-session`, `omp`.
|
||||
|
||||
### jobs
|
||||
|
||||
The current fish shell's background jobs, stopped or running, newest first. tv runs as a child process and cannot read the shell's job table, so `_jobs_bind` ([fish](../shell/fish.md#key-bindings)) writes it to a temp file named by `$TV_JOBS` and the source just `cat`s that file; opened any other way the list is empty. Entries are `%<id> <state> <command><TAB><id><TAB><pgid>`; <kbd>enter</kbd> prints the id and the binding runs `fg %<id>`.
|
||||
|
||||
The preview finds the job's processes by process group (procps `ps -g` matches sessions, so it filters `ps -e -o pgid,pid`) and shows the first process's cwd and start time, then `ps --forest` with PID, STAT (`T` = stopped), elapsed time, CPU, RSS, and arguments. The preview script avoids `{`/`}` because tv would parse them as templates and leave `{split:…}` unexpanded.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>enter</kbd> | Print the job id; `_jobs_bind` runs `fg` on it |
|
||||
| <kbd>ctrl-d</kbd> | `kill` then `reload_source`: SIGTERM to the job's process group, then SIGCONT so a stopped job receives it. Once the group is gone (polled up to 1 s) the row is removed from `$TV_JOBS`, so the reloaded list drops it; a job that ignores SIGTERM stays listed. Fish reports the termination at the next prompt |
|
||||
|
||||
**Needs:** `ps`, fish.
|
||||
|
||||
### kitty-days
|
||||
|
||||
Lists the daily kitty sessions that `~/.config/kitty/day_session.py` saves under `~/.local/share/kitty-sessions/<monday>/<day>.kitty-session` ([kitty daily sessions](../terminal/kitty.md#daily-sessions)). Entries are `<day> <weekday> week of <monday> <n> tabs<TAB><session file>`, through `mtime-sort`. The preview parses the session file with an inline `python3` script (written without braces, which tv would treat as templates): each tab, then each window's cwd and the program it restores, with the last 6 lines of its saved scrollback in color.
|
||||
|
||||
| Key | Action |
|
||||
| --- | --- |
|
||||
| <kbd>enter</kbd> | `open`: `setsid -f kitty --session <file>`, a new kitty with that day's tabs, scrollback and programs. Past days are read-only snapshots; today's file comes back as the live day if no kitty owns it |
|
||||
| <kbd>ctrl-e</kbd> | `edit`: the session file in `nvim` |
|
||||
|
||||
**Needs:** `kitty`, `python3`, `mtime-sort`.
|
||||
@@ -0,0 +1,72 @@
|
||||
# Topgrade
|
||||
|
||||
Topgrade config for Omarchy (Arch) machines, with yay as the package manager, chezmoi re-add before upgrades, and post-upgrade hooks.
|
||||
|
||||
[Topgrade](https://github.com/topgrade-rs/topgrade) runs every updater on the machine in one pass: system packages, cargo, firmware, git repos, flatpak, and custom commands. The config is written for an Omarchy (Arch) box running fish; most keys are left at topgrade's defaults.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | `dot_config/topgrade.toml` |
|
||||
| Target | `~/.config/topgrade.toml` |
|
||||
| Packages | `topgrade` (AUR, via yay) |
|
||||
|
||||
> [!NOTE]
|
||||
> The file's comments say topgrade on the owner's machine is cargo-installed, and that `cargo install-update` keeps it current. That is why self-update is off.
|
||||
|
||||
## [misc]
|
||||
|
||||
| Key | Value | Why |
|
||||
| --- | --- | --- |
|
||||
| `pre_sudo` | `true` | Caches sudo credentials up front so an unattended run does not stop at a password prompt partway through. |
|
||||
| `no_self_update` | `true` | The `[cargo]` step already updates the topgrade binary; two updaters would fight over it. |
|
||||
| `cleanup` | `true` | Runs distro cleanup afterwards (paccache needs `pacman-contrib`; skipped if absent). |
|
||||
| `show_distribution_summary` | `true` | Surfaces `*.pacnew` / `*.pacsave` files to merge. |
|
||||
| `disable` | `["containers", "config_update"]` | Skips pulling `:latest` for every local container image, and skips topgrade's config-update step. |
|
||||
| `ignore_failures` | `["uv", "containers"]` | Failures in these steps do not fail the run. |
|
||||
|
||||
The Python pip/conda steps stay off (topgrade's default), which protects a pinned ROCm build of torch from blind upgrades. A `remote_topgrades` entry for another host is present but commented out.
|
||||
|
||||
## [linux]
|
||||
|
||||
| Key | Value | Why |
|
||||
| --- | --- | --- |
|
||||
| `arch_package_manager` | `"yay"` | Pins Omarchy's AUR helper so topgrade does not fall back to bare `pacman`, which would skip the AUR. |
|
||||
| `show_arch_news` | `true` | Prints archlinux.org news before upgrading; Omarchy tracks Arch, so manual-intervention notices still apply. |
|
||||
|
||||
## Other steps
|
||||
|
||||
| Section | Key | Value | Effect |
|
||||
| --- | --- | --- | --- |
|
||||
| `[cargo]` | `git` | `true` | Also updates git-sourced cargo installs, not only crates.io ones. Needs `cargo-update`. |
|
||||
| `[firmware]` | `upgrade` | `false` | fwupd updates are listed, not flashed, so firmware is reviewed before applying. |
|
||||
| `[git]` | (none active) | | Predefined repos are still pulled; custom `repos` and `arguments` are commented out to avoid tripping over dirty working trees. |
|
||||
| `[flatpak]` | (none active) | | User-scope flatpaks update without sudo; `use_sudo` is commented out. |
|
||||
|
||||
## Pre- and post-commands
|
||||
|
||||
Pre-commands run before any upgrade step:
|
||||
|
||||
| Name | Command | Purpose |
|
||||
| --- | --- | --- |
|
||||
| Chezmoi Re-Add | `chezmoi re-add` | Pulls local edits to managed dotfiles back into the chezmoi source repo before anything changes them. Only re-adds files chezmoi already manages; review and commit in `~/.local/share/chezmoi` afterwards. |
|
||||
| GHQ Update | see below | Updates every ghq-managed repo. |
|
||||
|
||||
**~/.config/topgrade.toml**
|
||||
|
||||
```toml
|
||||
[pre_commands]
|
||||
"Chezmoi Re-Add" = "chezmoi re-add"
|
||||
"GHQ Update" = "ghq list | ghq get -u -s"
|
||||
```
|
||||
|
||||
Post-commands run after everything else:
|
||||
|
||||
| Name | Command |
|
||||
| --- | --- |
|
||||
| Hermes Update | `hermes update --backup --yes` |
|
||||
| Herdr Update | `herdr update` |
|
||||
|
||||
The post-commands assume the owner's own CLIs (`hermes`, `herdr`); on machines without them those steps fail. omp has no post-command: it is a global mise tool, so topgrade's built-in mise step (`mise upgrade`) updates it, and `omp update` would overwrite the binary inside mise's install directory.
|
||||
|
||||
> [!NOTE]
|
||||
> `chezmoi re-add` does not overwrite templates, so edits made directly to rendered files such as `~/.gitconfig` are not captured; change the `.tmpl` source instead.
|
||||
@@ -0,0 +1,270 @@
|
||||
# Yazi
|
||||
|
||||
Yazi file manager config — layout, openers, bat previews, keymap, plugins, flavors, and the Neovim bridge.
|
||||
|
||||
[Yazi](https://yazi-rs.github.io) is a terminal file manager. It is the default way to browse files here: shell keybindings, aliases, and a kitty shortcut all open it, and it hands files to Neovim.
|
||||
|
||||
| | |
|
||||
| --- | --- |
|
||||
| Source | [prdlk/yazi](https://github.com/prdlk/yazi) via `.chezmoiexternals/yazi.toml` (`git-repo`, pulled `--ff-only` every 168h) |
|
||||
| Target | `~/.config/yazi/` (git checkout; edit in place, commit and push from there) |
|
||||
| Files | `yazi.toml`, `keymap.toml`, `init.lua`, `package.toml`, `theme.toml`, `vfs.toml`, `flavors/{cyberdream,ii-auto}.yazi/flavor.toml`, `plugins/bunny.yazi/` (vendored) |
|
||||
| Helper | `dot_local/bin/executable_yazi-nvim-open` → `~/.local/bin/yazi-nvim-open` |
|
||||
| Packages | `yazi` plus preview backends `ffmpeg`, `ffmpegthumbnailer`, `poppler`, `resvg`, `imagemagick`, `7zip`, `unzip` |
|
||||
| Plugins | `run_onchange_after_install-yazi-plugins.sh.tmpl` → `ya pkg install` |
|
||||
|
||||
The whole directory is a symlink into the source tree, so edits apply without `chezmoi apply`.
|
||||
|
||||
```text
|
||||
yazi/
|
||||
yazi.toml
|
||||
keymap.toml
|
||||
init.lua
|
||||
package.toml
|
||||
theme.toml
|
||||
vfs.toml
|
||||
flavors/
|
||||
cyberdream.yazi/
|
||||
flavor.toml
|
||||
ii-auto.yazi/
|
||||
flavor.toml
|
||||
plugins/
|
||||
bunny.yazi/
|
||||
```
|
||||
|
||||
## yazi.toml
|
||||
|
||||
Plain TOML, not a template. The `open` opener runs `xdg-open`.
|
||||
|
||||
**~/.config/yazi/yazi.toml**
|
||||
|
||||
```toml
|
||||
[mgr]
|
||||
ratio = [0, 2, 6]
|
||||
|
||||
[opener]
|
||||
play = [
|
||||
{ run = "mpv %s", orphan = true, for = "unix" },
|
||||
]
|
||||
edit = [
|
||||
{ run = 'yazi-nvim-open %s', block = true, for = "unix" },
|
||||
]
|
||||
open = [
|
||||
{ run = "xdg-open %s1", desc = "Open" },
|
||||
]
|
||||
|
||||
[open]
|
||||
prepend_rules = [
|
||||
{ url = "*.{md,markdown}", use = [ "fry", "edit", "open" ] },
|
||||
]
|
||||
|
||||
[[plugin.prepend_previewers]]
|
||||
mime = "text/*"
|
||||
run = 'piper -- bat -p --color=always --terminal-width=$w "$1"'
|
||||
|
||||
[[plugin.prepend_previewers]]
|
||||
mime = "application/{mbox,javascript,wine-extension-ini}"
|
||||
run = 'piper -- bat -p --color=always --terminal-width=$w "$1"'
|
||||
```
|
||||
|
||||
| Setting | Effect |
|
||||
| --- | --- |
|
||||
| `mgr.ratio = [0, 2, 6]` | Hides the parent column; the file list takes 2/8 of the width and the preview 6/8. |
|
||||
| `opener.play` | `mpv`, detached from yazi (`orphan = true`). |
|
||||
| `opener.edit` | `yazi-nvim-open`, blocking, so yazi waits for the editor. |
|
||||
| `opener.open` | `xdg-open` on the first selected file. |
|
||||
| `open.prepend_rules` | Markdown files list `fry`, then `edit`, then `open`. No `fry` opener is defined in this file. |
|
||||
| Previewers | Text MIME types, plus mbox, JavaScript, and wine `.ini`, preview through the `piper` plugin running `bat -p --color=always`, so previews use the [bat](bat.md) cyberdream theme. Markdown falls under `text/*` too. |
|
||||
|
||||
## Keymap
|
||||
|
||||
All bindings in `keymap.toml` are `[[mgr.prepend_keymap]]` entries, so they take priority over yazi's defaults and leave the rest of the default keymap intact.
|
||||
|
||||
### Navigation
|
||||
|
||||
| Keys | Action |
|
||||
| --- | --- |
|
||||
| <kbd>l</kbd> | `plugin smart-enter`: enter a directory, or open a file |
|
||||
| <kbd>g</kbd> <kbd>r</kbd> | cd to the git root (`git rev-parse --show-toplevel`) |
|
||||
| <kbd>g</kbd> <kbd>C</kbd> | cd to `~/.local/share/chezmoi` |
|
||||
| <kbd>g</kbd> <kbd>d</kbd> | cd to `~/Downloads` |
|
||||
| <kbd>g</kbd> <kbd>D</kbd> <kbd>d</kbd> | cd to `$GHQ_ROOT/github.com` |
|
||||
| <kbd>g</kbd> <kbd>D</kbd> <kbd>w</kbd> | cd to `$GHQ_ROOT/github.com/wltbs` |
|
||||
| <kbd>g</kbd> <kbd>D</kbd> <kbd>p</kbd> | cd to `$GHQ_ROOT/github.com/prdlk` |
|
||||
| <kbd>g</kbd> <kbd>l</kbd> | cd to `~/.local` |
|
||||
| <kbd>g</kbd> <kbd>p</kbd> | cd to `~/Pictures` |
|
||||
| <kbd>g</kbd> <kbd>o</kbd> <kbd>p</kbd> | cd to `~/Documents/Obsidian/Personal` |
|
||||
| <kbd>g</kbd> <kbd>o</kbd> <kbd>r</kbd> | cd to `~/Documents/Obsidian/Research` |
|
||||
| <kbd>g</kbd> <kbd>o</kbd> <kbd>w</kbd> | cd to `~/Documents/Obsidian/Walletbase` |
|
||||
| <kbd>g</kbd> <kbd>b</kbd> | Back to the previous directory |
|
||||
| <kbd>g</kbd> <kbd>f</kbd> | Forward to the next directory |
|
||||
| <kbd>g</kbd> <kbd>m</kbd> <kbd>p</kbd> | cd to `sftp://gdrive-personal` |
|
||||
| <kbd>g</kbd> <kbd>m</kbd> <kbd>s</kbd> | cd to `sftp://gdrive-sonr` |
|
||||
| <kbd>g</kbd> <kbd>m</kbd> <kbd>h</kbd> | cd to `sftp://gdrive-hyperauth` |
|
||||
| <kbd>;</kbd> | Open the bunny hop menu |
|
||||
| <kbd>'</kbd> | Bunny fuzzy search over hops |
|
||||
|
||||
`$GHQ_ROOT` is `~/Code`, exported in `dot_config/fish/conf.d/10-env.fish`, `dot_zshrc`, and `dot_bashrc`. The `g m` bindings need the SFTP services in `vfs.toml`, which are commented out (see [vfs.toml](#vfstoml)).
|
||||
|
||||
### Finding and opening
|
||||
|
||||
| Keys | Action |
|
||||
| --- | --- |
|
||||
| <kbd>F</kbd> | `plugin smart-filter`: live filter; enters the directory or opens the file when one match remains |
|
||||
| <kbd>Ctrl</kbd>+<kbd>t</kbd> | `plugin tv`: jump to a file with television |
|
||||
| <kbd>Ctrl</kbd>+<kbd>g</kbd> | `plugin tv ghq`: jump to a ghq repo |
|
||||
| <kbd>Ctrl</kbd>+<kbd>d</kbd> | `plugin tv dirs`: jump to a directory |
|
||||
| <kbd>Ctrl</kbd>+<kbd>f</kbd> | `plugin tv text`: search text and open the match in Neovim at that line |
|
||||
| <kbd>Ctrl</kbd>+<kbd>v</kbd> | `yazi-nvim-open vsplit` on the selection (inside an nvim terminal only) |
|
||||
| <kbd>Ctrl</kbd>+<kbd>x</kbd> | `yazi-nvim-open split` on the selection (inside an nvim terminal only) |
|
||||
|
||||
The `tv` plugin shells out to [television](https://github.com/alexpasmantier/television), which is not in `packages.yaml`.
|
||||
|
||||
### Files and session
|
||||
|
||||
| Keys | Action |
|
||||
| --- | --- |
|
||||
| <kbd>A</kbd> | Create a directory (`create --dir`) |
|
||||
| <kbd>N</kbd> | Bulk-create files (`bulk_create`) |
|
||||
| <kbd>Shift</kbd>+<kbd>Tab</kbd> | Drop into `$SHELL` in the current directory (blocking) |
|
||||
| <kbd>Ctrl</kbd>+<kbd>q</kbd> | Quit |
|
||||
|
||||
In the shell opened by <kbd>Shift</kbd>+<kbd>Tab</kbd>, the `q` function (fish, bash, zsh) runs `ya emit quit` when `$YAZI_ID` is set, then exits. That closes the parent yazi too instead of returning to it.
|
||||
|
||||
## Plugins
|
||||
|
||||
`package.toml` pins every plugin to a commit and hash. `~/.config/yazi` is the [prdlk/yazi](https://github.com/prdlk/yazi) checkout, so `ya pkg install` writes plugins into its `plugins/`, which that repo's `.gitignore` excludes (`plugins/*`, `!plugins/bunny.yazi/`). The post-apply script reinstalls from the manifest:
|
||||
|
||||
**run_onchange_after_install-yazi-plugins.sh.tmpl**
|
||||
|
||||
```sh
|
||||
#!/bin/sh
|
||||
# Install the yazi plugins pinned in ~/.config/yazi/package.toml whenever it
|
||||
# changes. ~/.config/yazi is a git-repo external (prdlk/yazi); plugins land in
|
||||
# its plugins/ dir (gitignored there, except the vendored bunny.yazi).
|
||||
{{- $pkg := joinPath .chezmoi.homeDir ".config/yazi/package.toml" }}
|
||||
# package.toml hash: {{ if stat $pkg }}{{ include $pkg | sha256sum }}{{ end }}
|
||||
set -eu
|
||||
command -v ya >/dev/null 2>&1 || exit 0
|
||||
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/yazi/package.toml" ] || exit 0
|
||||
# ya's clone cache is disposable and clones made by an older ya can break a
|
||||
# newer one, so rebuild it once before giving up.
|
||||
ya pkg install || {
|
||||
rm -rf "${XDG_CACHE_HOME:-$HOME/.cache}/yazi/packages"
|
||||
ya pkg install
|
||||
}
|
||||
```
|
||||
|
||||
The embedded hash makes chezmoi re-run the script whenever `package.toml` changes.
|
||||
|
||||
bunny is not in `package.toml`: it is vendored at `71b14a3` in `plugins/bunny.yazi/` of the yazi repo, because its repo contains a Git symlink to a directory (`test/plugins/bunny.yazi -> ../..`) that `ya pkg` cannot materialize. To update it, re-copy the files from upstream.
|
||||
|
||||
| Plugin | Rev | Used by |
|
||||
| --- | --- | --- |
|
||||
| `yazi-rs/plugins:smart-filter` | `efa4d79` | <kbd>F</kbd> |
|
||||
| `uhs-robert/sshfs` | `a8b8903` | `require("sshfs"):setup()` in `init.lua` |
|
||||
| `yazi-rs/plugins:smart-enter` | `efa4d79` | <kbd>l</kbd> |
|
||||
| `yazi-rs/plugins:piper` | `efa4d79` | bat previewers in `yazi.toml` |
|
||||
| `Rolv-Apneseth/starship` | `ea92cf4` | Installed; not set up in `init.lua` |
|
||||
| `mikavilpas/easyjump.yazi:easyjump` | `4aa1a06` | Installed; not bound in `keymap.toml` |
|
||||
| `cap153/tv` | `b6b1f12` | <kbd>Ctrl</kbd>+<kbd>t</kbd>/<kbd>g</kbd>/<kbd>d</kbd>/<kbd>f</kbd> |
|
||||
| `stelcodes/bunny` | `71b14a3` (vendored) | <kbd>;</kbd> and <kbd>'</kbd>, configured in `init.lua` |
|
||||
| `coder0x6675/osc7` | `ae73046` | Installed; not referenced in config |
|
||||
| `WhoSowSee/mdv-previewer` | `ea4732b` | Installed; not referenced in `yazi.toml` |
|
||||
| `yazi-rs/plugins:vcs-files` | `efa4d79` | Installed; not bound in `keymap.toml` |
|
||||
| `yazi-rs/plugins:git` | `efa4d79` | `require("git"):setup { order = 1500 }` |
|
||||
| `yazi-rs/plugins:no-status` | `efa4d79` | `require("no-status"):setup()` |
|
||||
|
||||
`[flavor] deps` is empty: flavors ship as files in `flavors/`, not as packages.
|
||||
|
||||
### init.lua
|
||||
|
||||
**~/.config/yazi/init.lua**
|
||||
|
||||
```lua
|
||||
require("sshfs"):setup()
|
||||
require("bunny"):setup({ hops = { ... }, desc_strategy = "path", ephemeral = true, tabs = true, notify = false, fuzzy_cmd = "fzf" })
|
||||
require("git"):setup { order = 1500 }
|
||||
require("no-status"):setup()
|
||||
```
|
||||
|
||||
- **sshfs**: default setup, for mounting remote hosts over SSHFS.
|
||||
- **git**: git status signs in the file list, ordered at `1500` in the linemode.
|
||||
- **no-status**: removes the status bar.
|
||||
- **bunny**: bookmark "hops", with ephemeral hops and tab hops on, no notification after hopping, `fzf` for fuzzy search, and the path as the label when a hop has no `desc`.
|
||||
|
||||
| Hop key | Path | Label |
|
||||
| --- | --- | --- |
|
||||
| <kbd>/</kbd> | `/` | |
|
||||
| <kbd>t</kbd> | `/tmp` | |
|
||||
| <kbd>~</kbd> | `~` | Home |
|
||||
| <kbd>m</kbd> | `~/Music` | Music |
|
||||
| <kbd>d</kbd> | `~/Desktop` | Desktop |
|
||||
| <kbd>D</kbd> | `~/Developer` | Developer |
|
||||
| <kbd>c</kbd> | `~/.config` | Config files |
|
||||
| <kbd>l</kbd> <kbd>s</kbd> | `~/.local/share` | Local share |
|
||||
| <kbd>l</kbd> <kbd>b</kbd> | `~/.local/bin` | Local bin |
|
||||
| <kbd>l</kbd> <kbd>t</kbd> | `~/.local/state` | Local state |
|
||||
|
||||
## Theme and flavors
|
||||
|
||||
**~/.config/yazi/theme.toml**
|
||||
|
||||
```toml
|
||||
[flavor]
|
||||
light = "cyberdream"
|
||||
dark = "cyberdream"
|
||||
use = "cyberdream"
|
||||
```
|
||||
|
||||
Cyberdream is active in both light and dark mode, the palette shared with Ghostty, tmux, nvim, and television. Two flavors ship in `flavors/`:
|
||||
|
||||
| Flavor | Origin | Notes |
|
||||
| --- | --- | --- |
|
||||
| `cyberdream.yazi` | Hand-maintained cyberdream palette | Active. Sets `syntect_theme = "~/.config/bat/themes/cyberdream.tmTheme"`, so yazi's built-in code preview shares the [bat](bat.md) theme. Cyan cwd (`#5ef1ff`), green find keyword (`#5eff6c`), yellow and red copy/cut markers. |
|
||||
| `ii-auto.yazi` | Generated by the ii wallpaper theming system ("Do not edit manually") | Not selected. Monochrome palette taken from the wallpaper. |
|
||||
|
||||
To switch, change `use` (and `light`/`dark`) in `theme.toml` to `ii-auto`.
|
||||
|
||||
### Icons
|
||||
|
||||
`theme.toml` also carries a large `[icon]` table:
|
||||
|
||||
- `prepend_dirs`: Nerd Font icons for named directories: `Applications`, `Code`, `Desktop`, `Developer`, `github.com`, `prdlk`, `wltbs`, `Shared`, `Templates`, `env`, `go`, `js`, `dart`, `py`, `rs`, `tex`, `md`, `docs`, `prad.codes`.
|
||||
- `files` and `exts`: several hundred filename and extension rules, from dotfiles like `.gitignore` and `.zshrc` to formats like `kicad_pcb` and `wrangler.toml`. Each rule sets a Nerd Font glyph and a foreground color from the Catppuccin Mocha palette (`#a6e3a1`, `#f38ba8`, `#89b4fa`, `#cba6f7`, `#fab387`, ...).
|
||||
|
||||
Glyphs need a Nerd Font. The terminal uses VictorMono Nerd Font (see [Terminal](../terminal/README.md)).
|
||||
|
||||
## vfs.toml
|
||||
|
||||
Every line is commented out. The file sketches three SFTP services (`gdrive-personal`, `gdrive-sonr`, `gdrive-hyperauth`) on local ports, meant to be served by a local SFTP bridge to Google Drive. Until they are uncommented and the bridge is running, the <kbd>g</kbd> <kbd>m</kbd> bindings have nothing to connect to.
|
||||
|
||||
## Neovim bridge: yazi-nvim-open
|
||||
|
||||
`~/.local/bin/yazi-nvim-open [vsplit|split|tabedit] file...` backs the `edit` opener and the <kbd>Ctrl</kbd>+<kbd>v</kbd>/<kbd>Ctrl</kbd>+<kbd>x</kbd> bindings. It lives on `PATH` because yazi does not expand `$HOME` in opener commands.
|
||||
|
||||
1. **Parse mode**
|
||||
|
||||
A first argument of `vsplit`, `split`, or `tabedit` selects the mode; anything else means `edit`.
|
||||
|
||||
2. **Standalone yazi ($NVIM unset)**
|
||||
|
||||
`edit` runs `exec nvim "$@"`. Split modes do nothing and exit 0.
|
||||
|
||||
3. **Inside an nvim terminal ($NVIM set)**
|
||||
|
||||
Each file is resolved with `realpath`, escaped for a Vimscript string, and sent to the host with `nvim --server "$NVIM" --remote-expr "v:lua.EditFromYazi(mode, path)"`. The nvim side opens the file and hides the yazi window.
|
||||
|
||||
Set `YAZI_OPEN_TRACE` to a file path to log each call's `$NVIM`, mode, and arguments.
|
||||
|
||||
## Launching yazi
|
||||
|
||||
| Entry point | Behavior |
|
||||
| --- | --- |
|
||||
| `y` / `yy` (fish functions) | Run yazi with `--cwd-file`, then `cd` to the directory yazi was in on exit. The two are identical apart from `y` calling `command rm`. |
|
||||
| `yy` (bash, zsh functions) | Same wrapper for bash and zsh. |
|
||||
| <kbd>Ctrl</kbd>+<kbd>e</kbd> / <kbd>Ctrl</kbd>+<kbd>f</kbd> | fish and zsh keybindings that run `yy` and repaint the prompt. |
|
||||
| <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>f</kbd> | [Kitty](../terminal/kitty.md): yazi in a new tab at the current directory. |
|
||||
| Aliases | `e.y`, `e.k`, `e.n`, `e.f`, `e.v` open config directories in yazi; `cdc`, `cdl`, `cdw`, and `,,` (fish only; chezmoi source) cd first, then start yazi. |
|
||||
|
||||
[tmux](../terminal/tmux.md) sets `allow-passthrough on` so yazi's kitty-protocol image previews work inside tmux. Kitty's tab bar and the tmux window-name map show a folder icon for yazi. See [aliases](../shell/aliases.md) and [fish](../shell/fish.md) for the shell side.
|
||||
+93
@@ -0,0 +1,93 @@
|
||||
#
|
||||
# ~/.bashrc — managed by chezmoi
|
||||
#
|
||||
|
||||
alias vim="nvim"
|
||||
alias vi="nvim"
|
||||
|
||||
# If not running interactively, don't do anything
|
||||
[[ $- != *i* ]] && return
|
||||
|
||||
# PATH extras / tool envs (machine-optional, guarded)
|
||||
case ":$PATH:" in *":$HOME/.local/bin:"*) ;; *) PATH="$HOME/.local/bin:$PATH" ;; esac
|
||||
[ -f "$HOME/.cargo/env" ] && . "$HOME/.cargo/env"
|
||||
[ -d "$HOME/.maestro/bin" ] && PATH="$PATH:$HOME/.maestro/bin"
|
||||
|
||||
# Go — GOPATH/GOBIN under ~/.local/share to keep $HOME clean.
|
||||
# GOROOT is provided by mise (toolchain lives under ~/.local/share/mise).
|
||||
export GOPATH="$HOME/.local/share/go"
|
||||
export GOBIN="$GOPATH/bin"
|
||||
case ":$PATH:" in *":$GOBIN:"*) ;; *) PATH="$GOBIN:$PATH" ;; esac
|
||||
|
||||
# Repo roots (ghq) — same as fish's conf.d/10-env.fish; the ghq-repos tv
|
||||
# cable (ctrl-o) lists this root.
|
||||
export GHQ_ROOT="$HOME/Code"
|
||||
export CODE_ROOT="$HOME/Code"
|
||||
|
||||
# Android SDK — relocated under ~/.local/share/android.
|
||||
export ANDROID_HOME="$HOME/.local/share/android"
|
||||
export ANDROID_SDK_ROOT="$ANDROID_HOME"
|
||||
for _adir in "$ANDROID_HOME/platform-tools" "$ANDROID_HOME/cmdline-tools/latest/bin" "$ANDROID_HOME/emulator"; do
|
||||
case ":$PATH:" in *":$_adir:"*) ;; *) [ -d "$_adir" ] && PATH="$PATH:$_adir" ;; esac
|
||||
done
|
||||
unset _adir
|
||||
|
||||
# GITHUB_TOKEN from gh's keyring login — never stored on disk. An inherited
|
||||
# value wins, so nested shells skip the gh call.
|
||||
if [ -z "${GITHUB_TOKEN:-}" ] && command -v gh >/dev/null 2>&1; then
|
||||
_gh_token="$(gh auth token 2>/dev/null)"
|
||||
[ -n "$_gh_token" ] && export GITHUB_TOKEN="$_gh_token"
|
||||
unset _gh_token
|
||||
fi
|
||||
|
||||
# Shared aliases (same set as fish/zsh; source of truth: .chezmoidata/aliases.yaml)
|
||||
[ -f "$HOME/.config/shell/aliases.sh" ] && . "$HOME/.config/shell/aliases.sh"
|
||||
|
||||
# Shell functions — one file per function, bash ports of the fish ones
|
||||
# (cwd/history-touching helpers; standalone tools live in ~/.local/bin)
|
||||
if [ -d "$HOME/.config/bash/functions" ]; then
|
||||
for _f in "$HOME/.config/bash/functions"/*.bash; do
|
||||
[ -r "$_f" ] && . "$_f"
|
||||
done
|
||||
unset _f
|
||||
fi
|
||||
|
||||
# Flyline — enhanced Bash line editing (machine-optional, guarded)
|
||||
[ -f "$HOME/.local/lib/libflyline.so" ] && enable -f "$HOME/.local/lib/libflyline.so" flyline
|
||||
|
||||
|
||||
# Generated for envman. Do not edit.
|
||||
[ -s "$HOME/.config/envman/load.sh" ] && . "$HOME/.config/envman/load.sh"
|
||||
|
||||
# Prompt — starship, consistent with fish
|
||||
command -v starship >/dev/null 2>&1 && eval "$(starship init bash)"
|
||||
|
||||
# television: _tv completion (its ctrl-r is taken over by atuin below)
|
||||
command -v tv >/dev/null 2>&1 && eval "$(tv init bash)"
|
||||
|
||||
# Readline keybinds — bash ports of fish_user_key_bindings.fish (tv cables)
|
||||
[ -f "$HOME/.config/bash/keybinds.bash" ] && . "$HOME/.config/bash/keybinds.bash"
|
||||
|
||||
# atuin comes from the package manager (/usr/bin). No ~/.atuin/bin: an old
|
||||
# standalone install there shadowed it on PATH and its older schema rejected
|
||||
# the history DB the newer daemon had migrated.
|
||||
command -v atuin >/dev/null 2>&1 && eval "$(atuin init bash)"
|
||||
|
||||
# >>> termium >>>
|
||||
case ":$PATH:" in *:'/home/prad/.local/bin':*) ;; *) export PATH='/home/prad/.local/bin':"$PATH" ;; esac
|
||||
# <<< termium <<<
|
||||
|
||||
|
||||
# Added by LM Studio CLI (lms)
|
||||
export PATH="$PATH:/home/prad/.lmstudio/bin"
|
||||
# End of LM Studio CLI section
|
||||
|
||||
|
||||
if command -v wt >/dev/null 2>&1; then eval "$(command wt config shell init bash)"; fi
|
||||
|
||||
# >>> open-knowledge cli >>>
|
||||
# ! Contents within this block are managed by OpenKnowledge. Do not edit.
|
||||
# ! Delete this whole block to opt out — OpenKnowledge will not re-add it.
|
||||
[ -f "$HOME/.ok/env.sh" ] && . "$HOME/.ok/env.sh"
|
||||
# <<< open-knowledge cli <<<
|
||||
|
||||
@@ -0,0 +1,414 @@
|
||||
filter_mode_shell_up_key_binding = "directory" # or global, host, directory, etc
|
||||
|
||||
[dotfiles]
|
||||
enabled = true
|
||||
|
||||
## Base directory for Atuin data files (databases, keys, session, etc.)
|
||||
## All data file paths default to being relative to this directory.
|
||||
## linux/mac: ~/.local/share/atuin (or XDG_DATA_HOME/atuin)
|
||||
## windows: %USERPROFILE%/.local/share/atuin
|
||||
# data_dir = "~/.local/share/atuin"
|
||||
|
||||
## where to store your database, default is your system data directory
|
||||
## linux/mac: ~/.local/share/atuin/history.db
|
||||
## windows: %USERPROFILE%/.local/share/atuin/history.db
|
||||
# db_path = "~/.history.db"
|
||||
|
||||
## where to store your encryption key, default is your system data directory
|
||||
## linux/mac: ~/.local/share/atuin/key
|
||||
## windows: %USERPROFILE%/.local/share/atuin/key
|
||||
# key_path = "~/.key"
|
||||
|
||||
## where to store your auth session token, default is your system data directory
|
||||
## linux/mac: ~/.local/share/atuin/session
|
||||
## windows: %USERPROFILE%/.local/share/atuin/session
|
||||
# session_path = "~/.session"
|
||||
|
||||
## date format used, either "us" or "uk"
|
||||
# dialect = "us"
|
||||
|
||||
## default timezone to use when displaying time
|
||||
## either "l", "local" to use the system's current local timezone, or an offset
|
||||
## from UTC in the format of "<+|->H[H][:M[M][:S[S]]]"
|
||||
## for example: "+9", "-05", "+03:30", "-01:23:45", etc.
|
||||
# timezone = "local"
|
||||
|
||||
## enable or disable automatic sync
|
||||
auto_sync = true
|
||||
|
||||
## enable or disable automatic update checks
|
||||
update_check = true
|
||||
|
||||
## which release channel to follow with `atuin update` and update checks
|
||||
## "stable" for stable releases only, "nightly" to also receive prereleases
|
||||
# update_channel = "stable"
|
||||
|
||||
## address of the sync server
|
||||
# sync_address = "https://api.atuin.sh"
|
||||
|
||||
## how often to sync history. note that this is only triggered when a command
|
||||
## is ran, so sync intervals may well be longer
|
||||
## set it to 0 to sync after every command
|
||||
# sync_frequency = "5m"
|
||||
|
||||
## which search mode to use for interactive search
|
||||
## possible values: prefix, fulltext, fuzzy, daemon-fuzzy
|
||||
# search_mode = "fuzzy"
|
||||
|
||||
## which search mode to use when atuin is invoked from a shell up-key binding
|
||||
## the accepted values are identical to those of "search_mode"
|
||||
## leave unspecified to use same mode set in "search_mode"
|
||||
# search_mode_shell_up_key_binding = "fuzzy"
|
||||
|
||||
## which filter mode to use for interactive search
|
||||
## possible values: "global", "host", "session", "session-preload", "directory", "workspace"
|
||||
## consider using search.filters to customize the enablement and order of filter modes
|
||||
# filter_mode = "global"
|
||||
|
||||
## which filter mode to use when atuin is invoked from a shell up-key binding
|
||||
## the accepted values are identical to those of "filter_mode"
|
||||
## leave unspecified to use same mode set in "filter_mode"
|
||||
# filter_mode_shell_up_key_binding = "global"
|
||||
|
||||
## With workspace filtering enabled, Atuin will filter for commands executed
|
||||
## in any directory within a git repository tree (default: false).
|
||||
##
|
||||
## To use workspace mode by default when available, set this to true and
|
||||
## set filter_mode to "workspace" or leave it unspecified and
|
||||
## set search.filters to include "workspace" before other filter modes.
|
||||
workspaces = true
|
||||
|
||||
## which display style to use
|
||||
## possible values: auto, full, compact
|
||||
style = "auto"
|
||||
|
||||
## the maximum number of lines the interface should take up
|
||||
## set it to 0 to always go full screen
|
||||
# inline_height = 30
|
||||
|
||||
## the maximum number of lines the interface should take up
|
||||
## when atuin is invoked from a shell up-key binding
|
||||
## the accepted values are identical to those of "inline_height"
|
||||
inline_height_shell_up_key_binding = 20
|
||||
|
||||
## Invert the UI - put the search bar at the top , Default to `false`
|
||||
# invert = true
|
||||
|
||||
## enable or disable showing a preview of the selected command
|
||||
## useful when the command is longer than the terminal width and is cut off
|
||||
# show_preview = true
|
||||
|
||||
## what to do when the escape key is pressed when searching
|
||||
## possible values: return-original, return-query
|
||||
# exit_mode = "return-original"
|
||||
|
||||
## possible values: emacs, subl
|
||||
# word_jump_mode = "emacs"
|
||||
|
||||
## characters that count as a part of a word
|
||||
# word_chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
|
||||
|
||||
## number of context lines to show when scrolling by pages
|
||||
# scroll_context_lines = 1
|
||||
|
||||
## use ctrl instead of alt as the shortcut modifier key for numerical UI shortcuts
|
||||
## alt-0 .. alt-9
|
||||
# ctrl_n_shortcuts = false
|
||||
|
||||
## Show numeric shortcuts (1..9) beside list items in the TUI
|
||||
## set to false to hide the moving numbers if you find them distracting
|
||||
# show_numeric_shortcuts = true
|
||||
|
||||
## default history list format - can also be specified with the --format arg
|
||||
# history_format = "{time}\t{command}\t{duration}"
|
||||
|
||||
## Defaults to true. If enabled, strip trailing spaces and tabs from commands
|
||||
## before saving them to history.
|
||||
## Escaped trailing spaces (for example `printf foo\\ `) are preserved.
|
||||
# strip_trailing_whitespace = true
|
||||
|
||||
## prevent commands matching any of these regexes from being written to history.
|
||||
## Note that these regular expressions are unanchored, i.e. if they don't start
|
||||
## with ^ or end with $, they'll match anywhere in the command.
|
||||
## For details on the supported regular expression syntax, see
|
||||
## https://docs.rs/regex/latest/regex/#syntax
|
||||
# history_filter = [
|
||||
# "^secret-cmd",
|
||||
# "^innocuous-cmd .*--secret=.+",
|
||||
# ]
|
||||
|
||||
## prevent commands run with cwd matching any of these regexes from being written
|
||||
## to history. Note that these regular expressions are unanchored, i.e. if they don't
|
||||
## start with ^ or end with $, they'll match anywhere in CWD.
|
||||
## For details on the supported regular expression syntax, see
|
||||
## https://docs.rs/regex/latest/regex/#syntax
|
||||
# cwd_filter = [
|
||||
# "^/very/secret/area",
|
||||
# ]
|
||||
|
||||
## Configure the maximum height of the preview to show.
|
||||
## Useful when you have long scripts in your history that you want to distinguish
|
||||
## by more than the first few lines.
|
||||
# max_preview_height = 4
|
||||
|
||||
## Configure whether or not to show the help row, which includes the current Atuin
|
||||
## version (and whether an update is available), a keymap hint, and the total
|
||||
## amount of commands in your history.
|
||||
# show_help = true
|
||||
|
||||
## Configure whether or not to show tabs for search and inspect
|
||||
# show_tabs = true
|
||||
|
||||
## Configure whether or not the tabs row may be auto-hidden, which includes the current Atuin
|
||||
## tab, such as Search or Inspector, and other tabs you may wish to see. This will
|
||||
## only be hidden if there are fewer than this count of lines available, and does not affect the use
|
||||
## of keyboard shortcuts to switch tab. 0 to never auto-hide, default is 8 (lines).
|
||||
## This is ignored except in `compact` mode.
|
||||
# auto_hide_height = 8
|
||||
|
||||
## Defaults to true. This matches history against a set of default regex, and will not save it if we get a match. Defaults include
|
||||
## 1. AWS key id
|
||||
## 2. Github pat (old and new)
|
||||
## 3. Slack oauth tokens (bot, user)
|
||||
## 4. Slack webhooks
|
||||
## 5. Stripe live/test keys
|
||||
# secrets_filter = true
|
||||
|
||||
## Defaults to true. If enabled, upon hitting enter Atuin will immediately execute the command,
|
||||
## whereas tab will put the command in the prompt for editing.
|
||||
## If set to false, both enter and tab will place the command in the prompt for editing.
|
||||
## This applies for new installs. Old installs will keep the old behaviour unless configured otherwise.
|
||||
enter_accept = true
|
||||
search_mode = "daemon-fuzzy"
|
||||
|
||||
## Defaults to false. If enabled, when triggered after &&, || or |, Atuin will complete commands to chain rather than replace the current line.
|
||||
# command_chaining = false
|
||||
|
||||
## This specifies the keymap on the startup of `atuin search`. If this is set
|
||||
## to "auto", the startup keymap mode in the Atuin search is automatically
|
||||
## selected based on the shell's keymap where the keybinding is defined. If
|
||||
## this is set to "emacs", "vim-insert", or "vim-normal", the startup keymap
|
||||
## mode in the Atuin search is forced to be the specified one.
|
||||
# keymap_mode = "emacs"
|
||||
|
||||
## Cursor style in each keymap mode. If specified, the cursor style is changed
|
||||
## in entering the cursor shape. Available values are "default" and
|
||||
## "{blink,steady}-{block,underline,bar}".
|
||||
# keymap_cursor = { emacs = "blink-block", vim_insert = "blink-block", vim_normal = "steady-block" }
|
||||
|
||||
# network_connect_timeout = 5
|
||||
# network_timeout = 30
|
||||
|
||||
## Extra HTTP headers to send on every request to the sync server. Useful when
|
||||
## a self-hosted server sits behind a proxy that requires its own auth header,
|
||||
## e.g. Cloudflare Access. Headers that Atuin sets itself (e.g. Authorization)
|
||||
## cannot be overridden. When set, cross-origin redirects are refused so these
|
||||
## headers are never sent to a different origin.
|
||||
# extra_headers = { "CF-Access-Client-Id" = "...", "CF-Access-Client-Secret" = "..." }
|
||||
|
||||
## Timeout (in seconds) for acquiring a local database connection (sqlite)
|
||||
# local_timeout = 5
|
||||
|
||||
## Set this to true and Atuin will minimize motion in the UI - timers will not update live, etc.
|
||||
## Alternatively, set env NO_MOTION=true
|
||||
# prefers_reduced_motion = false
|
||||
|
||||
## Defaults to true. Configures whether to store commands that failed (those with non-zero exit status) or not.
|
||||
# store_failed = true
|
||||
|
||||
[stats]
|
||||
## Set commands where we should consider the subcommand for statistics. Eg, kubectl get vs just kubectl
|
||||
# common_subcommands = [
|
||||
# "apt",
|
||||
# "cargo",
|
||||
# "composer",
|
||||
# "dnf",
|
||||
# "docker",
|
||||
# "dotnet",
|
||||
# "git",
|
||||
# "go",
|
||||
# "ip",
|
||||
# "jj",
|
||||
# "kubectl",
|
||||
# "nix",
|
||||
# "nmcli",
|
||||
# "npm",
|
||||
# "pecl",
|
||||
# "pnpm",
|
||||
# "podman",
|
||||
# "port",
|
||||
# "systemctl",
|
||||
# "tmux",
|
||||
# "yarn",
|
||||
# ]
|
||||
|
||||
## Set commands that should be totally stripped and ignored from stats
|
||||
# common_prefix = ["sudo"]
|
||||
|
||||
## Set commands that will be completely ignored from stats
|
||||
# ignored_commands = [
|
||||
# "cd",
|
||||
# "ls",
|
||||
# "vi"
|
||||
# ]
|
||||
|
||||
[keys]
|
||||
# Defaults to true. If disabled, using the up/down key won't exit the TUI when scrolled past the first/last entry.
|
||||
# scroll_exits = true
|
||||
|
||||
# Defaults to true. The left arrow key will exit the TUI when scrolling before the first character
|
||||
# exit_past_line_start = true
|
||||
|
||||
# Defaults to true. The right arrow key performs the same functionality as Tab and copies the selected line to the command line to be modified.
|
||||
# accept_past_line_end = true
|
||||
|
||||
# Defaults to false. The left arrow key performs the same functionality as Tab and copies the selected line to the command line to be modified.
|
||||
# accept_past_line_start = false
|
||||
|
||||
# Defaults to false. The backspace key performs the same functionality as Tab and copies the selected line to the command line to be modified when at the start of the line.
|
||||
# accept_with_backspace = false
|
||||
|
||||
[preview]
|
||||
## which preview strategy to use to calculate the preview height (respects max_preview_height).
|
||||
## possible values: auto, static
|
||||
## auto: length of the selected command.
|
||||
## static: length of the longest command stored in the history.
|
||||
## fixed: use max_preview_height as fixed height.
|
||||
# strategy = "auto"
|
||||
|
||||
[daemon]
|
||||
enabled = true
|
||||
autostart = true
|
||||
## Enables using the daemon to sync.
|
||||
# enabled = false
|
||||
|
||||
## Automatically start and manage the daemon when needed.
|
||||
## Not compatible with `systemd_socket = true`.
|
||||
# autostart = false
|
||||
|
||||
## How often the daemon should sync in seconds
|
||||
# sync_frequency = 300
|
||||
|
||||
## The path to the unix socket used by the daemon (on unix systems)
|
||||
## linux/mac: ~/.local/share/atuin/atuin.sock
|
||||
## windows: Not Supported
|
||||
# socket_path = "~/.local/share/atuin/atuin.sock"
|
||||
|
||||
## The daemon pidfile used for lifecycle management.
|
||||
## Defaults to the Atuin data directory.
|
||||
# pidfile_path = "~/.local/share/atuin/atuin-daemon.pid"
|
||||
|
||||
## Use systemd socket activation rather than opening the given path (the path must still be correct for the client)
|
||||
## linux: false
|
||||
## mac/windows: Not Supported
|
||||
# systemd_socket = false
|
||||
|
||||
## The port that should be used for TCP on non unix systems
|
||||
# tcp_port = 8889
|
||||
|
||||
[pty_proxy]
|
||||
## If enabled, `atuin init` will first re-exec your shell inside `atuin pty-proxy`,
|
||||
## so you don't need a separate `eval "$(atuin pty-proxy init)"` line in your shell
|
||||
## config. Supported for bash, zsh, fish and nu on unix platforms.
|
||||
## For the fastest startup, keep your `atuin init` line near the top of your shell
|
||||
## config: everything sourced before it runs again inside the proxy.
|
||||
## Safe to combine with an existing `atuin pty-proxy init` line — the proxy only
|
||||
## starts once.
|
||||
enabled = false
|
||||
|
||||
[theme]
|
||||
## Color theme to use for rendering in the terminal.
|
||||
## There are some built-in themes, including the base theme ("default"),
|
||||
## "autumn" and "marine". You can add your own themes to the "./themes" subdirectory of your
|
||||
## Atuin config (or ATUIN_THEME_DIR, if provided) as TOML files whose keys should be one or
|
||||
## more of AlertInfo, AlertWarn, AlertError, Annotation, Base, Guidance, Important, and
|
||||
## the string values as lowercase entries from this list:
|
||||
## https://ogeon.github.io/docs/palette/master/palette/named/index.html
|
||||
## If you provide a custom theme file, it should be called "NAME.toml" and the theme below
|
||||
## should be the stem, i.e. `theme = "NAME"` for your chosen NAME.
|
||||
name = "cherry-blossom"
|
||||
|
||||
## Whether the theme manager should output normal or extra information to help fix themes.
|
||||
## Boolean, true or false. If unset, left up to the theme manager.
|
||||
# debug = true
|
||||
|
||||
[search]
|
||||
## The list of enabled filter modes, in order of priority.
|
||||
## The "workspace" mode is skipped when not in a workspace or workspaces = false.
|
||||
## Default filter mode can be overridden with the filter_mode setting.
|
||||
# filters = ["global", "host", "session", "workspace", "directory", "session-preload"]
|
||||
|
||||
## Filter interactive search results by the shell used to run the command:
|
||||
##
|
||||
## - "all": show all commands
|
||||
##
|
||||
## - "auto": show commands run by the current type of shell, or commands that
|
||||
## have no shell recorded (for example, from before Atuin started tracking it)
|
||||
##
|
||||
## - array of strings: show commands run by any shell in the array; "" includes
|
||||
## commands that have no recorded shell
|
||||
# shells = "auto"
|
||||
|
||||
[tmux]
|
||||
## Enable using atuin with tmux popup (requires tmux >= 3.2)
|
||||
## When enabled and running inside tmux, Atuin will use a popup window for interactive search.
|
||||
## Set to false to disable the popup.
|
||||
## This can also be controlled with the ATUIN_TMUX_POPUP environment variable.
|
||||
## Note: The tmux popup is currently supported in zsh, bash, and fish shells. This currently doesn't work with iTerm native tmux integration.
|
||||
enabled = true
|
||||
|
||||
## Width of the tmux popup window
|
||||
## Can be a percentage, or integer (e.g. "100" means 100 characters wide)
|
||||
width = "80%"
|
||||
|
||||
## Height of the tmux popup window
|
||||
## Can be a percentage, or integer (e.g. "100" means 100 lines tall)
|
||||
height = "60%"
|
||||
|
||||
[ui]
|
||||
|
||||
[ai]
|
||||
enabled = true
|
||||
## Columns to display in the interactive search, from left to right.
|
||||
## The selection indicator (" > ") is always shown first implicitly.
|
||||
##
|
||||
## Each column can be specified as a simple string (uses default width)
|
||||
## or as an object with type, width, and expand:
|
||||
## { type = "directory", width = 30, expand = true }
|
||||
##
|
||||
## Available column types (with default widths):
|
||||
## duration (5) - Command execution duration (e.g., "123ms")
|
||||
## time (8) - Relative time since execution (e.g., "59m ago")
|
||||
## datetime (16) - Absolute timestamp (e.g., "2025-01-22 14:35")
|
||||
## directory (20) - Working directory (truncated if too long)
|
||||
## host (15) - Hostname where command was run
|
||||
## user (10) - Username
|
||||
## exit (3) - Exit code (colored by success/failure)
|
||||
## command (*) - The command itself (expands by default)
|
||||
##
|
||||
## The "expand" option (default: true for command, false for others) makes a
|
||||
## column fill remaining space. Only one column should have expand = true.
|
||||
##
|
||||
## Default:
|
||||
# columns = ["duration", "time", "command"]
|
||||
##
|
||||
## Examples:
|
||||
##
|
||||
## Minimal - more space for commands:
|
||||
# columns = ["duration", "command"]
|
||||
##
|
||||
## With wider directory column:
|
||||
# columns = ["duration", { type = "directory", width = 30 }, "command"]
|
||||
##
|
||||
## Show host for multi-machine sync users:
|
||||
# columns = ["duration", "time", "host", "command"]
|
||||
##
|
||||
## Show exit codes prominently:
|
||||
# columns = ["exit", "duration", "command"]
|
||||
##
|
||||
## Make directory expand instead of command:
|
||||
# columns = ["duration", "time", { type = "directory", expand = true }, { type = "command", expand = false }]
|
||||
|
||||
## Syntax highlight commands in the search results, using the theme's colors.
|
||||
## Not available on all platforms (e.g. Windows).
|
||||
syntax_highlight = true
|
||||
@@ -0,0 +1,18 @@
|
||||
[theme]
|
||||
name = "cherry-blossom"
|
||||
|
||||
[colors]
|
||||
AlertInfo = "#a78266"
|
||||
AlertWarn = "#ae825f"
|
||||
AlertError = "#bf615d"
|
||||
Annotation = "#a6958f"
|
||||
Guidance = "#8f9aa0"
|
||||
Important = "#cf716f"
|
||||
Title = "#cf716f"
|
||||
Muted = "#a6958f"
|
||||
SyntaxCommand = "#cf716f"
|
||||
SyntaxFlag = "#a78266"
|
||||
SyntaxString = "#a6b084"
|
||||
SyntaxVariable = "#c17e4a"
|
||||
SyntaxOperator = "#ad6756"
|
||||
SyntaxComment = "#a6958f"
|
||||
@@ -0,0 +1,18 @@
|
||||
[theme]
|
||||
name = "cyberdream"
|
||||
|
||||
[colors]
|
||||
AlertInfo = "#5ef1ff"
|
||||
AlertWarn = "#f1ff5e"
|
||||
AlertError = "#ff6e5e"
|
||||
Annotation = "#7b8496"
|
||||
Guidance = "#5ea1ff"
|
||||
Important = "#ff5ef1"
|
||||
Title = "#5ef1ff"
|
||||
Muted = "#7b8496"
|
||||
SyntaxCommand = "#5ea1ff"
|
||||
SyntaxFlag = "#5ef1ff"
|
||||
SyntaxString = "#5eff6c"
|
||||
SyntaxVariable = "#ff5ef1"
|
||||
SyntaxOperator = "#ff5ea0"
|
||||
SyntaxComment = "#7b8496"
|
||||
@@ -0,0 +1,8 @@
|
||||
# c: clear with no args, cd with one.
|
||||
c() {
|
||||
if [ -z "${1-}" ]; then
|
||||
clear
|
||||
else
|
||||
cd "$1"
|
||||
fi
|
||||
}
|
||||
@@ -0,0 +1,23 @@
|
||||
# cd with zoxide fallback, else builtin cd.
|
||||
cd() {
|
||||
local rc target
|
||||
if [ $# -eq 0 ]; then
|
||||
builtin cd "$HOME"
|
||||
elif [ "$1" = - ]; then
|
||||
builtin cd -
|
||||
elif builtin cd "$1" 2>/dev/null; then
|
||||
: # exact path resolved, nothing else to do
|
||||
elif command -v zoxide >/dev/null 2>&1; then
|
||||
target=$(zoxide query -- "$1" 2>/dev/null)
|
||||
if [ -n "$target" ]; then
|
||||
builtin cd "$target"
|
||||
else
|
||||
builtin cd "$1" # let builtin cd surface the real error
|
||||
fi
|
||||
else
|
||||
builtin cd "$1"
|
||||
fi
|
||||
rc=$?
|
||||
command -v zoxide >/dev/null 2>&1 && zoxide add "$PWD" 2>/dev/null
|
||||
return $rc
|
||||
}
|
||||
@@ -0,0 +1,27 @@
|
||||
# Re-run last command, copy output to clipboard.
|
||||
# History-offset handling: some line editors add the current command to
|
||||
# history before execution, some after — detect instead of assuming.
|
||||
clip-last() {
|
||||
local last copy
|
||||
last=$(fc -ln -1 -1 2>/dev/null)
|
||||
last=${last#"${last%%[![:space:]]*}"} # trim leading whitespace
|
||||
case $last in
|
||||
clip-last*)
|
||||
last=$(fc -ln -2 -2 2>/dev/null)
|
||||
last=${last#"${last%%[![:space:]]*}"}
|
||||
;;
|
||||
esac
|
||||
if [ -z "$last" ]; then
|
||||
echo "clip-last: no previous command in history" >&2
|
||||
return 1
|
||||
fi
|
||||
if command -v wl-copy >/dev/null 2>&1; then
|
||||
copy=wl-copy
|
||||
else
|
||||
echo "clip-last: no clipboard tool (wl-copy) found" >&2
|
||||
return 1
|
||||
fi
|
||||
eval "$last" | "$copy"
|
||||
command -v notify-send >/dev/null 2>&1 \
|
||||
&& notify-send -a shell "Clipboard" "Command output copied to clipboard"
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
# ghq get + cd; clone/path logic lives in ~/.local/bin/ghg-clone.
|
||||
# (helper is not named ghg: an unrelated cargo binary owns that name)
|
||||
ghg() {
|
||||
local dir
|
||||
dir=$(ghg-clone "$@") || return
|
||||
cd "$dir" || return
|
||||
clear && onefetch
|
||||
}
|
||||
@@ -0,0 +1,6 @@
|
||||
# Create a repo (prad.codes/github.com) + cd; logic lives in ~/.local/bin/ghn.
|
||||
ghn() {
|
||||
local dir
|
||||
dir=$(command ghn "$@") || return
|
||||
cd "$dir" || return
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
# Pick a ghq repo / Obsidian vault with tv (ghq-repos cable) + cd.
|
||||
gho() {
|
||||
local dir
|
||||
dir=$(tv ghq-repos --inline) || return
|
||||
[ -n "$dir" ] || return 1
|
||||
cd "$dir" || return
|
||||
clear
|
||||
if [ -d .git ]; then
|
||||
onefetch
|
||||
fi
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
# yazi wrapper: cd to the directory yazi was left in on exit.
|
||||
yy() {
|
||||
local tmp cwd
|
||||
tmp=$(mktemp -t "yazi-cwd.XXXXXX")
|
||||
command yazi "$@" --cwd-file="$tmp"
|
||||
cwd=$(cat -- "$tmp" 2>/dev/null)
|
||||
if [ -n "$cwd" ] && [ "$cwd" != "$PWD" ] && [ -d "$cwd" ]; then
|
||||
builtin cd -- "$cwd"
|
||||
fi
|
||||
rm -f -- "$tmp"
|
||||
}
|
||||
@@ -0,0 +1,96 @@
|
||||
# ~/.config/bash/keybinds.bash — readline ports of the television keys in
|
||||
# fish_user_key_bindings.fish / zsh keybinds.zsh:
|
||||
# ctrl-o → gho (ghq-repos cable, cd) ctrl-e → tv git-files (nvim)
|
||||
# ctrl-p → pj (pj cable) down → pj on an empty prompt
|
||||
# ctrl-t → tv smart autocomplete (tv init bash ships no ctrl-t)
|
||||
# Keys owned by kitty.conf never reach the shell: ctrl-h/j/k/l (pass_keys.py).
|
||||
#
|
||||
# Every picker runs tv --inline: it opens on the line below the prompt and
|
||||
# leaves the cursor on that line when it exits. When nothing was printed
|
||||
# below, the binding steps back up (_kb_up) so readline redraws the prompt in
|
||||
# place after bind -x; output that must stay (a pj task) is left alone.
|
||||
|
||||
_kb_up() { printf '\033[A' >/dev/tty; }
|
||||
|
||||
# ctrl-e: enter opens nvim, which restores the cursor to tv's line.
|
||||
_kb_git_files() {
|
||||
tv git-files --inline </dev/tty
|
||||
_kb_up
|
||||
}
|
||||
bind -x '"\C-e": _kb_git_files'
|
||||
|
||||
# ctrl-p, and down on an empty prompt. pj reports through $PJ_STATE: `open`
|
||||
# = cancelled, `ran` = a task printed output, empty = no task sources.
|
||||
_kb_pj() {
|
||||
local state
|
||||
state=$(mktemp) || return
|
||||
PJ_STATE=$state pj "$@" </dev/tty
|
||||
[ "$(<"$state")" = open ] && _kb_up
|
||||
rm -f "$state"
|
||||
}
|
||||
bind -x '"\C-p": _kb_pj'
|
||||
|
||||
# ctrl-o: gho, split so the prompt is right. bind -x runs in the shell
|
||||
# process, so the cd persists — but readline keeps drawing the prompt it
|
||||
# started with. The macro runs \C-x1 (pick with tv, cd), then \C-x2 and \C-x3,
|
||||
# which _kb_gho rebinds: after a cd, \C-x2 accepts the stashed-empty line
|
||||
# (bash prints a fresh prompt for the new cwd; nothing reaches history) and
|
||||
# \C-x3 does gho's clear + onefetch, after which readline redraws that fresh
|
||||
# prompt below the output; when cancelled both just redraw. \C-x0 restores
|
||||
# the typed text.
|
||||
_kb_gho() {
|
||||
local dir
|
||||
_kb_line=$READLINE_LINE _kb_point=$READLINE_POINT
|
||||
dir=$(tv ghq-repos --inline </dev/tty)
|
||||
_kb_up
|
||||
if [ -n "$dir" ] && cd "$dir"; then
|
||||
READLINE_LINE='' READLINE_POINT=0
|
||||
bind '"\C-x2": accept-line'
|
||||
bind -x '"\C-x3": _kb_gho_show'
|
||||
else
|
||||
bind '"\C-x2": redraw-current-line'
|
||||
bind '"\C-x3": redraw-current-line'
|
||||
fi
|
||||
}
|
||||
_kb_gho_show() {
|
||||
clear
|
||||
if [ -d .git ]; then
|
||||
onefetch
|
||||
fi
|
||||
}
|
||||
_kb_restore() {
|
||||
READLINE_LINE=${_kb_line-} READLINE_POINT=${_kb_point-0}
|
||||
unset _kb_line _kb_point
|
||||
}
|
||||
bind -x '"\C-x1": _kb_gho'
|
||||
bind -x '"\C-x0": _kb_restore'
|
||||
bind '"\C-o": "\C-x1\C-x2\C-x3\C-x0"'
|
||||
|
||||
# down: the pj cable on an idle, empty prompt, otherwise history search
|
||||
# (fish's _pj_bind_down). bind -x can't call readline functions, so _kb_down
|
||||
# rebinds \C-x5, which the macro sends right after it.
|
||||
_kb_down() {
|
||||
if [ -n "$READLINE_LINE" ]; then
|
||||
bind '"\C-x5": history-search-forward'
|
||||
return
|
||||
fi
|
||||
PJ_QUIET=1 _kb_pj
|
||||
bind '"\C-x5": redraw-current-line'
|
||||
}
|
||||
bind -x '"\C-x4": _kb_down'
|
||||
bind '"\e[B": "\C-x4\C-x5"'
|
||||
bind '"\eOB": "\C-x4\C-x5"'
|
||||
|
||||
# ctrl-t: pick with the channel tv guesses from the text left of the cursor
|
||||
# (shell_integration.channel_triggers) and insert the picks there, quoted.
|
||||
_kb_tv_autocomplete() {
|
||||
local pre=${READLINE_LINE:0:READLINE_POINT} out item ins=''
|
||||
out=$(tv --autocomplete-prompt "$pre" --inline </dev/tty)
|
||||
_kb_up
|
||||
while IFS= read -r item; do
|
||||
[ -n "$item" ] && ins+="$(printf '%q' "$item") "
|
||||
done <<<"$out"
|
||||
READLINE_LINE=$pre$ins${READLINE_LINE:READLINE_POINT}
|
||||
READLINE_POINT=$((${#pre} + ${#ins}))
|
||||
}
|
||||
bind -x '"\C-t": _kb_tv_autocomplete'
|
||||
@@ -0,0 +1,25 @@
|
||||
# This is `bat`s configuration file. Each line either contains a comment or
|
||||
# a command-line option that you want to pass to `bat` by default. You can
|
||||
# run `bat --help` to get a list of all possible configuration options.
|
||||
|
||||
# Specify desired highlighting theme (e.g. "TwoDark"). Run `bat --list-themes`
|
||||
# for a list of all available themes
|
||||
--theme="cyberdream"
|
||||
|
||||
# Enable this to use italic text on the terminal. This is not supported on all
|
||||
# terminal emulators (like tmux, by default):
|
||||
#--italic-text=always
|
||||
|
||||
# Uncomment the following line to disable automatic paging:
|
||||
#--paging=never
|
||||
|
||||
# Uncomment the following line if you are using less version >= 551 and want to
|
||||
# enable mouse scrolling support in `bat` when running inside tmux. This might
|
||||
# disable text selection, unless you press shift.
|
||||
#--pager="less --RAW-CONTROL-CHARS --quit-if-one-screen --mouse"
|
||||
|
||||
# Syntax mappings: map a certain filename pattern to a language.
|
||||
# Example 1: use the C++ syntax for Arduino .ino files
|
||||
# Example 2: Use ".gitignore"-style highlighting for ".ignore" files
|
||||
#--map-syntax "*.ino:C++"
|
||||
#--map-syntax ".ignore:Git Ignore"
|
||||
@@ -0,0 +1,937 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
||||
<plist version="1.0">
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Cyberdream</string>
|
||||
<key>settings</key>
|
||||
<array>
|
||||
<dict>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>background</key>
|
||||
<string>#16181a</string>
|
||||
<key>caret</key>
|
||||
<string>#ffffff</string>
|
||||
<key>block_caret</key>
|
||||
<string>#7b8496</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
<key>invisibles</key>
|
||||
<string>#16181a</string>
|
||||
<key>lineHighlight</key>
|
||||
<string>#3c4048</string>
|
||||
<key>selection</key>
|
||||
<string>#3c4048</string>
|
||||
<key>findHighlight</key>
|
||||
<string>#5ef1ff</string>
|
||||
<key>findHighlightForeground</key>
|
||||
<string>#1e2124</string>
|
||||
<key>selectionBorder</key>
|
||||
<string>#16181a</string>
|
||||
<key>activeGuide</key>
|
||||
<string>#ffbd5e</string>
|
||||
<key>bracketsForeground</key>
|
||||
<string>#ff5ea0</string>
|
||||
<key>bracketsOptions</key>
|
||||
<string>underline</string>
|
||||
<key>bracketContentsForeground</key>
|
||||
<string>#ffffff</string>
|
||||
<key>bracketContentsOptions</key>
|
||||
<string>underline</string>
|
||||
<key>tagsOptions</key>
|
||||
<string>stippled_underline</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Comment</string>
|
||||
<key>scope</key>
|
||||
<string>comment</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#7b8496</string>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>String</string>
|
||||
<key>scope</key>
|
||||
<string>string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5eff6c</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Number</string>
|
||||
<key>scope</key>
|
||||
<string>constant.numeric</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Built-in constant</string>
|
||||
<key>scope</key>
|
||||
<string>constant.language</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>User-defined constant</string>
|
||||
<key>scope</key>
|
||||
<string>constant.character, constant.other</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Variable</string>
|
||||
<key>scope</key>
|
||||
<string>variable</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Ruby's @variable</string>
|
||||
<key>scope</key>
|
||||
<string>variable.other.readwrite.instance</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>String interpolation</string>
|
||||
<key>scope</key>
|
||||
<string>constant.character.escaped, constant.character.escape, string source, string source.ruby</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ef1</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Ruby Regexp</string>
|
||||
<key>scope</key>
|
||||
<string>source.ruby string.regexp.classic.ruby,source.ruby string.regexp.mod-r.ruby</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#ff6e5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Keyword</string>
|
||||
<key>scope</key>
|
||||
<string>keyword</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Keyword Operator</string>
|
||||
<key>scope</key>
|
||||
<string>keyword.operator</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Storage</string>
|
||||
<key>scope</key>
|
||||
<string>storage</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Storage type</string>
|
||||
<key>scope</key>
|
||||
<string>storage.type</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Storage Type Namespace</string>
|
||||
<key>scope</key>
|
||||
<string>storage.type.namespace</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Storage Type Class</string>
|
||||
<key>scope</key>
|
||||
<string>storage.type.class</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Class name</string>
|
||||
<key>scope</key>
|
||||
<string>entity.name.class</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>underline</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Meta Path</string>
|
||||
<key>scope</key>
|
||||
<string>meta.path</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>underline</string>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Inherited class</string>
|
||||
<key>scope</key>
|
||||
<string>entity.other.inherited-class</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic underline</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Function name</string>
|
||||
<key>scope</key>
|
||||
<string>entity.name.function</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#5ea1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Function argument</string>
|
||||
<key>scope</key>
|
||||
<string>variable.parameter</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Tag name</string>
|
||||
<key>scope</key>
|
||||
<string>entity.name.tag</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Tag attribute</string>
|
||||
<key>scope</key>
|
||||
<string>entity.other.attribute-name</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Library function</string>
|
||||
<key>scope</key>
|
||||
<string>support.function</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#5ea1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Library constant</string>
|
||||
<key>scope</key>
|
||||
<string>support.constant</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Library class/type</string>
|
||||
<key>scope</key>
|
||||
<string>support.type, support.class</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Library variable</string>
|
||||
<key>scope</key>
|
||||
<string>support.other.variable</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Support Other Namespace</string>
|
||||
<key>scope</key>
|
||||
<string>support.other.namespace</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Invalid</string>
|
||||
<key>scope</key>
|
||||
<string>invalid</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>background</key>
|
||||
<string>#ff5ea0</string>
|
||||
<key>fontStyle</key>
|
||||
<string></string>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Invalid deprecated</string>
|
||||
<key>scope</key>
|
||||
<string>invalid.deprecated</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>background</key>
|
||||
<string>#bd5eff</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON String</string>
|
||||
<key>scope</key>
|
||||
<string>meta.structure.dictionary.json string.quoted.double.json</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>diff.header</string>
|
||||
<key>scope</key>
|
||||
<string>meta.diff, meta.diff.header</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#7b8496</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>diff.deleted</string>
|
||||
<key>scope</key>
|
||||
<string>markup.deleted</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff6e5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>diff.inserted</string>
|
||||
<key>scope</key>
|
||||
<string>markup.inserted</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5eff6c</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>diff.changed</string>
|
||||
<key>scope</key>
|
||||
<string>markup.changed</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>scope</key>
|
||||
<string>constant.numeric.line-number.find-in-files - match</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ef1</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>scope</key>
|
||||
<string>entity.name.filename</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5eff6c</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>scope</key>
|
||||
<string>message.error</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff6e5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON Punctuation</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.definition.string.begin.json - meta.structure.dictionary.value.json, punctuation.definition.string.end.json - meta.structure.dictionary.value.json</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON Structure</string>
|
||||
<key>scope</key>
|
||||
<string>meta.structure.dictionary.json string.quoted.double.json</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON String</string>
|
||||
<key>scope</key>
|
||||
<string>meta.structure.dictionary.value.json string.quoted.double.json</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON: 6 deep</string>
|
||||
<key>scope</key>
|
||||
<string>meta meta meta meta meta meta meta.structure.dictionary.value string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON: 5 deep</string>
|
||||
<key>scope</key>
|
||||
<string>meta meta meta meta meta meta.structure.dictionary.value string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ef1</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON: 4 deep</string>
|
||||
<key>scope</key>
|
||||
<string>meta meta meta meta meta.structure.dictionary.value string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON: 3 deep</string>
|
||||
<key>scope</key>
|
||||
<string>meta meta meta meta.structure.dictionary.value string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ea1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON: 2 deep</string>
|
||||
<key>scope</key>
|
||||
<string>meta meta meta.structure.dictionary.value string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>JSON: 1 deep</string>
|
||||
<key>scope</key>
|
||||
<string>meta meta.structure.dictionary.value string</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
|
||||
<!-- Markdown Tweaks -->
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markup: strike</string>
|
||||
<key>scope</key>
|
||||
<string>markup.strike</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markup: bold</string>
|
||||
<key>scope</key>
|
||||
<string>markup.bold</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>bold</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markup: italic</string>
|
||||
<key>scope</key>
|
||||
<string>markup.italic</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: heading</string>
|
||||
<key>scope</key>
|
||||
<string>markup.heading</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffbd5e</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: List Items Punctuation</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.definition.list_item.markdown</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: Blockquote</string>
|
||||
<key>scope</key>
|
||||
<string>markup.quote</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: Blockquote Punctuation</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.definition.blockquote.markdown</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: Separator</string>
|
||||
<key>scope</key>
|
||||
<string>meta.separator</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#7b8496</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markup: raw inline</string>
|
||||
<key>scope</key>
|
||||
<string>text.html.markdown markup.raw.inline</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5eff6c</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markup: underline</string>
|
||||
<key>scope</key>
|
||||
<string>markup.underline</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>underline</string>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markup: Raw block</string>
|
||||
<key>scope</key>
|
||||
<string>markup.raw.block</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: Raw Block fenced source</string>
|
||||
<key>scope</key>
|
||||
<string>markup.raw.block.fenced.markdown source</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: Fenced Bode Block</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.definition.fenced.markdown, variable.language.fenced.markdown</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#7b8496</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Markdown: Fenced Language</string>
|
||||
<key>scope</key>
|
||||
<string>variable.language.fenced.markdown</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>fontStyle</key>
|
||||
<string>italic</string>
|
||||
<key>foreground</key>
|
||||
<string>#7b8496</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Punctuation Accessor</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.accessor</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Meta Function Return Type</string>
|
||||
<key>scope</key>
|
||||
<string>meta.function.return-type</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Punctuation Section Block Begin</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.section.block.begin</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Punctuation Section Block End</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.section.block.end</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Punctuation Section Embedded Begin</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.section.embedded.begin</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Punctuation Section Embedded End</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.section.embedded.end</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Punctuation Separator Namespace</string>
|
||||
<key>scope</key>
|
||||
<string>punctuation.separator.namespace</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Variable Function</string>
|
||||
<key>scope</key>
|
||||
<string>variable.function</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ea1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Variable Other</string>
|
||||
<key>scope</key>
|
||||
<string>variable.other</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Variable Language</string>
|
||||
<key>scope</key>
|
||||
<string>variable.language</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#bd5eff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Entity Name Module Ruby</string>
|
||||
<key>scope</key>
|
||||
<string>entity.name.module.ruby</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Entity Name Constant Ruby</string>
|
||||
<key>scope</key>
|
||||
<string>entity.name.constant.ruby</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ea1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Support Function Builtin Ruby</string>
|
||||
<key>scope</key>
|
||||
<string>support.function.builtin.ruby</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ffffff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Storage Type Namespace CS</string>
|
||||
<key>scope</key>
|
||||
<string>storage.type.namespace.cs</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#ff5ea0</string>
|
||||
</dict>
|
||||
</dict>
|
||||
<dict>
|
||||
<key>name</key>
|
||||
<string>Entity Name Namespace CS</string>
|
||||
<key>scope</key>
|
||||
<string>entity.name.namespace.cs</string>
|
||||
<key>settings</key>
|
||||
<dict>
|
||||
<key>foreground</key>
|
||||
<string>#5ef1ff</string>
|
||||
</dict>
|
||||
</dict>
|
||||
</array>
|
||||
<key>uuid</key>
|
||||
<string>68394a4e-1404-4971-bdfc-81dd7f9d29f6</string>
|
||||
<key>colorSpaceName</key>
|
||||
<string>sRGB</string>
|
||||
<key>semanticClass</key>
|
||||
<string>theme.cyberdream</string>
|
||||
<key>author</key>
|
||||
<string>Scott McKendry</string>
|
||||
</dict>
|
||||
</plist>
|
||||
@@ -0,0 +1,4 @@
|
||||
# drydock: scan the ghq root (~/Code/<host>/<owner>/<repo>, depth 3) directly,
|
||||
# not the ~/Projects symlink farm. Everything else stays at drydock's defaults
|
||||
# (`drydock config show` prints them).
|
||||
roots = ["~/Code"]
|
||||
Submodule
+1
Submodule dot_config/fish added at 87d8aa0e9c.
@@ -0,0 +1,12 @@
|
||||
<?xml version="1.0"?>
|
||||
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
|
||||
<fontconfig>
|
||||
<match target="pattern">
|
||||
<test name="family" qual="any">
|
||||
<string>monospace</string>
|
||||
</test>
|
||||
<edit name="family" mode="prepend_first" binding="strong">
|
||||
<string>VictorMono Nerd Font</string>
|
||||
</edit>
|
||||
</match>
|
||||
</fontconfig>
|
||||
@@ -0,0 +1,95 @@
|
||||
prSections:
|
||||
- title: My Pull Requests
|
||||
filters: is:open author:@me
|
||||
- title: Needs My Review
|
||||
filters: is:open review-requested:@me
|
||||
- title: Involved
|
||||
filters: is:open involves:@me -author:@me
|
||||
issuesSections:
|
||||
- title: My Issues
|
||||
filters: is:open author:@me
|
||||
- title: Assigned
|
||||
filters: is:open assignee:@me
|
||||
- title: Involved
|
||||
filters: is:open involves:@me -author:@me
|
||||
notificationsSections:
|
||||
- title: All
|
||||
filters: ""
|
||||
- title: Created
|
||||
filters: reason:author
|
||||
- title: Participating
|
||||
filters: reason:participating
|
||||
- title: Mentioned
|
||||
filters: reason:mention
|
||||
- title: Review Requested
|
||||
filters: reason:review-requested
|
||||
- title: Assigned
|
||||
filters: reason:assign
|
||||
- title: Subscribed
|
||||
filters: reason:subscribed
|
||||
- title: Team Mentioned
|
||||
filters: reason:team-mention
|
||||
repo:
|
||||
branchesRefetchIntervalSeconds: 30
|
||||
prsRefetchIntervalSeconds: 60
|
||||
defaults:
|
||||
preview:
|
||||
open: true
|
||||
width: 0.45
|
||||
prsLimit: 20
|
||||
prApproveComment: LGTM
|
||||
issuesLimit: 20
|
||||
notificationsLimit: 20
|
||||
view: prs
|
||||
layout:
|
||||
prs:
|
||||
updatedAt:
|
||||
width: 5
|
||||
createdAt:
|
||||
width: 5
|
||||
repo:
|
||||
width: 20
|
||||
author:
|
||||
width: 15
|
||||
authorIcon:
|
||||
hidden: false
|
||||
assignees:
|
||||
width: 20
|
||||
hidden: true
|
||||
base:
|
||||
width: 15
|
||||
hidden: true
|
||||
lines:
|
||||
width: 15
|
||||
issues:
|
||||
updatedAt:
|
||||
width: 5
|
||||
createdAt:
|
||||
width: 5
|
||||
repo:
|
||||
width: 15
|
||||
creator:
|
||||
width: 10
|
||||
creatorIcon:
|
||||
hidden: false
|
||||
assignees:
|
||||
width: 20
|
||||
hidden: true
|
||||
refetchIntervalMinutes: 30
|
||||
keybindings:
|
||||
prs:
|
||||
- key: T
|
||||
command: gh enhance -R {{.RepoName}} {{.PrNumber}}
|
||||
repoPaths: {}
|
||||
theme:
|
||||
ui:
|
||||
sectionsShowCount: true
|
||||
table:
|
||||
showSeparator: true
|
||||
compact: false
|
||||
pager:
|
||||
diff: "hunk pager"
|
||||
confirmQuit: false
|
||||
showAuthorIcons: true
|
||||
smartFilteringAtLaunch: true
|
||||
includeReadNotifications: true
|
||||
@@ -0,0 +1,27 @@
|
||||
# The current version of the config schema
|
||||
version: 1
|
||||
# What protocol to use when performing git operations. Supported values: ssh, https
|
||||
git_protocol: https
|
||||
# What editor gh should run when creating issues, pull requests, etc. If blank, will refer to environment.
|
||||
editor:
|
||||
# When to interactively prompt. This is a global config that cannot be overridden by hostname. Supported values: enabled, disabled
|
||||
prompt: enabled
|
||||
# Preference for editor-based interactive prompting. This is a global config that cannot be overridden by hostname. Supported values: enabled, disabled
|
||||
prefer_editor_prompt: disabled
|
||||
# A pager program to send command output to, e.g. "less". If blank, will refer to environment. Set the value to "cat" to disable the pager.
|
||||
pager:
|
||||
# Aliases allow you to create nicknames for gh commands
|
||||
aliases:
|
||||
co: pr checkout
|
||||
# The path to a unix socket through which to send HTTP connections. If blank, HTTP traffic will be handled by net/http.DefaultTransport.
|
||||
http_unix_socket:
|
||||
# What web browser gh should use when opening URLs. If blank, will refer to environment.
|
||||
browser:
|
||||
# Whether to display labels using their RGB hex color codes in terminals that support truecolor. Supported values: enabled, disabled
|
||||
color_labels: disabled
|
||||
# Whether customizable, 4-bit accessible colors should be used. Supported values: enabled, disabled
|
||||
accessible_colors: disabled
|
||||
# Whether an accessible prompter should be used. Supported values: enabled, disabled
|
||||
accessible_prompter: disabled
|
||||
# Whether to use a animated spinner as a progress indicator. If disabled, a textual progress indicator is used instead. Supported values: enabled, disabled
|
||||
spinner: enabled
|
||||
@@ -0,0 +1,2 @@
|
||||
GOPATH={{ .chezmoi.homeDir }}/.local/share/go
|
||||
GOBIN={{ .chezmoi.homeDir }}/.local/share/go/bin
|
||||
@@ -0,0 +1,10 @@
|
||||
# ── herdr-nvim (chmarax.herdr-nvim) ──
|
||||
# Read by the plugin binary from $XDG_CONFIG_HOME/herdr-nvim/config.toml.
|
||||
# Bound to ctrl+shift+e in kitty/ghostty → prefix+e (\x02e) → herdr-nvim.toggle.
|
||||
|
||||
[sidebar]
|
||||
# The nvim pane opens to the LEFT of the existing panes. The plugin collapses
|
||||
# the tab's current layout into one anchor group, splits the editor off it, and
|
||||
# for "left" round-trips the anchor through a temporary tab so nvim ends up on
|
||||
# the left edge and the previous panes sit to its right. Default is "right".
|
||||
position = "left"
|
||||
@@ -0,0 +1,12 @@
|
||||
theme = "auto" # any built-in theme id, auto, or custom
|
||||
mode = "auto" # auto, split, stack
|
||||
vcs = "git" # git, jj, sl
|
||||
watch = false
|
||||
exclude_untracked = true
|
||||
line_numbers = true
|
||||
tab_width = 4 # tab stops, 1-16
|
||||
wrap_lines = false
|
||||
menu_bar = true
|
||||
agent_notes = true
|
||||
prompt_save_view_preferences = false
|
||||
transparent_background = true
|
||||
@@ -0,0 +1,4 @@
|
||||
{
|
||||
"version": 1,
|
||||
"lastSeenCliVersion": "0.18.2"
|
||||
}
|
||||
Submodule
+1
Submodule dot_config/hypr added at 5e15ac16fc.
@@ -0,0 +1,11 @@
|
||||
gui:
|
||||
border: rounded
|
||||
theme:
|
||||
activeBorderColor:
|
||||
- "#cf716f"
|
||||
inactiveBorderColor:
|
||||
- "#a6958f"
|
||||
selectedLineBgColor:
|
||||
- "#453130"
|
||||
optionsTextColor:
|
||||
- "#a6958f"
|
||||
@@ -0,0 +1,498 @@
|
||||
gui:
|
||||
border: rounded
|
||||
theme:
|
||||
activeBorderColor:
|
||||
- "#cf716f"
|
||||
inactiveBorderColor:
|
||||
- "#a6958f"
|
||||
searchingActiveBorderColor:
|
||||
- "#c17e4a"
|
||||
optionsTextColor:
|
||||
- "#a6958f"
|
||||
selectedLineBgColor:
|
||||
- "#453130"
|
||||
cherryPickedCommitBgColor:
|
||||
- "#453130"
|
||||
cherryPickedCommitFgColor:
|
||||
- "#ad6756"
|
||||
unstagedChangesColor:
|
||||
- "#ae825f"
|
||||
defaultFgColor:
|
||||
- "#dcc1b7"
|
||||
authorColors:
|
||||
"*": "#dcc1b7" # The number of lines you scroll by when scrolling the main window
|
||||
scrollHeight: 2
|
||||
# If true, allow scrolling past the bottom of the content in the main window
|
||||
scrollPastBottom: true
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Config.md#scroll-off-margin
|
||||
scrollOffMargin: 2
|
||||
# One of: 'margin' (default) | 'jump'
|
||||
scrollOffBehavior: margin
|
||||
# If true, capture mouse events.
|
||||
# When mouse events are captured, it's a little harder to select text: e.g. requiring you to hold the option key when on macOS.
|
||||
mouseEvents: true
|
||||
# If true, do not show a warning when discarding changes in the staging view.
|
||||
skipDiscardChangeWarning: true
|
||||
# If true, do not show warning when applying/popping the stash
|
||||
skipStashWarning: true
|
||||
# If true, do not show a warning when attempting to commit without any staged files; instead stage all unstaged files.
|
||||
skipNoStagedFilesWarning: false
|
||||
# If true, do not show a warning when rewording a commit via an external editor
|
||||
skipRewordInEditorWarning: false
|
||||
# Fraction of the total screen width to use for the left side section. You may want to pick a small number (e.g. 0.2) if you're using a narrow screen, so that you can see more of the main section.
|
||||
# Number from 0 to 1.0.
|
||||
sidePanelWidth: 0.4
|
||||
# If true, increase the height of the focused side window; creating an accordion effect.
|
||||
expandFocusedSidePanel: true
|
||||
# The weight of the expanded side panel, relative to the other panels. 2 means
|
||||
# twice as tall as the other panels. Only relevant if `expandFocusedSidePanel` is true.
|
||||
expandedSidePanelWeight: 2
|
||||
# Sometimes the main window is split in two (e.g. when the selected file has both staged and unstaged changes). This setting controls how the two sections are split.
|
||||
# Options are:
|
||||
# - 'horizontal': split the window horizontally
|
||||
# - 'vertical': split the window vertically
|
||||
# - 'flexible': (default) split the window horizontally if the window is wide enough, otherwise split vertically
|
||||
mainPanelSplitMode: horizontal
|
||||
# How the window is split when in half screen mode (i.e. after hitting '+' once).
|
||||
# Possible values:
|
||||
# - 'left': split the window horizontally (side panel on the left, main view on the right)
|
||||
# - 'top': split the window vertically (side panel on top, main view below)
|
||||
enlargedSideViewLocation: left
|
||||
# One of 'auto' (default) | 'en' | 'zh-CN' | 'zh-TW' | 'pl' | 'nl' | 'ja' | 'ko' | 'ru'
|
||||
language: auto
|
||||
# Format used when displaying time e.g. commit time.
|
||||
# Uses Go's time format syntax: https://pkg.go.dev/time#Time.Format
|
||||
timeFormat: 02 Jan 06
|
||||
# Format used when displaying time if the time is less than 24 hours ago.
|
||||
# Uses Go's time format syntax: https://pkg.go.dev/time#Time.Format
|
||||
shortTimeFormat: 3:04PM
|
||||
# Config relating to colors and styles.
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Config.md#color-attributes
|
||||
# Config relating to the commit length indicator
|
||||
commitLength:
|
||||
# If true, show an indicator of commit message length
|
||||
show: true
|
||||
# If true, show the '5 of 20' footer at the bottom of list views
|
||||
showListFooter: true
|
||||
# If true, display the files in the file views as a tree. If false, display the files as a flat list.
|
||||
# This can be toggled from within Lazygit with the '~' key, but that will not change the default.
|
||||
showFileTree: true
|
||||
# If true, show a random tip in the command log when Lazygit starts
|
||||
showRandomTip: false
|
||||
# If true, show the command log
|
||||
showCommandLog: true
|
||||
# If true, show the bottom line that contains keybinding info and useful buttons. If false, this line will be hidden except to display a loader for an in-progress action.
|
||||
showBottomLine: false
|
||||
# If true, show jump-to-window keybindings in window titles.
|
||||
showPanelJumps: false
|
||||
# Deprecated: use nerdFontsVersion instead
|
||||
showIcons: true
|
||||
# Nerd fonts version to use.
|
||||
# One of: '2' | '3' | empty string (default)
|
||||
# If empty, do not show icons.
|
||||
nerdFontsVersion: "3"
|
||||
# If true (default), file icons are shown in the file views. Only relevant if NerdFontsVersion is not empty.
|
||||
showFileIcons: true
|
||||
# Length of author name in (non-expanded) commits view. 2 means show initials only.
|
||||
commitAuthorShortLength: 2
|
||||
# Length of author name in expanded commits view. 2 means show initials only.
|
||||
commitAuthorLongLength: 17
|
||||
# Length of commit hash in commits view. 0 shows '*' if NF icons aren't on.
|
||||
commitHashLength: 8
|
||||
# If true, show commit hashes alongside branch names in the branches view.
|
||||
showBranchCommitHash: true
|
||||
# Whether to show the divergence from the base branch in the branches view.
|
||||
# One of: 'none' | 'onlyArrow' | 'arrowAndNumber'
|
||||
showDivergenceFromBaseBranch: arrowAndNumber
|
||||
# Height of the command log view
|
||||
commandLogSize: 4
|
||||
# Whether to split the main window when viewing file changes.
|
||||
# One of: 'auto' | 'always'
|
||||
# If 'auto', only split the main window when a file has both staged and unstaged changes
|
||||
splitDiff: auto
|
||||
# Default size for focused window. Window size can be changed from within Lazygit with '+' and '_' (but this won't change the default).
|
||||
# One of: 'normal' (default) | 'half' | 'full'
|
||||
screenMode: normal
|
||||
# If true, show a seriously epic explosion animation when nuking the working tree.
|
||||
animateExplosion: true
|
||||
# Whether to stack UI components on top of each other.
|
||||
# One of 'auto' (default) | 'always' | 'never'
|
||||
portraitMode: auto
|
||||
# How things are filtered when typing '/'.
|
||||
# One of 'substring' (default) | 'fuzzy'
|
||||
filterMode: fuzzy
|
||||
# Config relating to the spinner.
|
||||
spinner:
|
||||
# The frames of the spinner animation.
|
||||
frames:
|
||||
- "|"
|
||||
- /
|
||||
- "-"
|
||||
- \
|
||||
# The "speed" of the spinner in milliseconds.
|
||||
rate: 50
|
||||
# Status panel view.
|
||||
# One of 'dashboard' (default) | 'allBranchesLog'
|
||||
statusPanelView: allBranchesLog
|
||||
# Config relating to git
|
||||
git:
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Custom_Pagers.md
|
||||
diffRenderers:
|
||||
# - pager: critique --stdin
|
||||
- # Value of the --color arg in the git diff command. Some pagers want this to be set to 'always' and some want it set to 'never'
|
||||
colorArg: always
|
||||
command: delta --dark --paging=never
|
||||
# e.g.
|
||||
# diff-so-fancy
|
||||
# delta --dark --paging=never
|
||||
# ydiff -p cat -s --wrap --width={{columnWidth}}
|
||||
# - pager: "git diff | git-split-diffs --color | less -RFX"
|
||||
# If true, Lazygit will use whatever pager is specified in `$GIT_PAGER`, `$PAGER`, or your *git config*. If the pager ends with something like ` | less` we will strip that part out, because less doesn't play nice with our rendering approach. If the custom pager uses less under the hood, that will also break rendering (hence the `--paging=never` flag for the `delta` pager).
|
||||
|
||||
# Config relating to committing
|
||||
commit:
|
||||
# If true, pass '--signoff' flag when committing
|
||||
signOff: false
|
||||
# Automatic WYSIWYG wrapping of the commit message as you type
|
||||
autoWrapCommitMessage: true
|
||||
# If autoWrapCommitMessage is true, the width to wrap to
|
||||
autoWrapWidth: 72
|
||||
# Config relating to merging
|
||||
merging:
|
||||
# If true, run merges in a subprocess so that if a commit message is required, Lazygit will not hang
|
||||
# Only applicable to unix users.
|
||||
manualCommit: false
|
||||
# Extra args passed to `git merge`, e.g. --no-ff
|
||||
args: ""
|
||||
# The commit message to use for a squash merge commit. Can contain "{{selectedRef}}" and "{{currentBranch}}" placeholders.
|
||||
squashMergeMessage: Squash merge {{selectedRef}} into {{currentBranch}}
|
||||
# list of branches that are considered 'main' branches, used when displaying commits
|
||||
mainBranches:
|
||||
- develop # git flow
|
||||
# Prefix to use when skipping hooks. E.g. if set to 'WIP', then pre-commit hooks will be skipped when the commit message starts with 'WIP'
|
||||
skipHookPrefix: WIP
|
||||
# If true, periodically fetch from remote
|
||||
autoFetch: true
|
||||
# If true, periodically refresh files and submodules
|
||||
autoRefresh: true
|
||||
# If true, pass the --all arg to git fetch
|
||||
fetchAll: true
|
||||
# Command used when displaying the current branch git log in the main window
|
||||
branchLogCmd: git log --graph --color=always --abbrev-commit --decorate --date=relative --pretty=medium {{branchName}} --
|
||||
# If true, do not spawn a separate process when using GPG
|
||||
overrideGpg: false
|
||||
# If true, do not allow force pushes
|
||||
disableForcePushing: false
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Config.md#predefined-commit-message-prefix
|
||||
commitPrefix:
|
||||
- # pattern to match on. E.g. for 'feature/AB-123' to match on the AB-123 use "^\\w+\\/(\\w+-\\w+).*"
|
||||
pattern: ""
|
||||
# Replace directive. E.g. for 'feature/AB-123' to start the commit message with 'AB-123 ' use "[$1] "
|
||||
replace: ""
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Config.md#predefined-branch-name-prefix
|
||||
branchPrefix: ""
|
||||
# If true, parse emoji strings in commit messages e.g. render :rocket: as 🚀
|
||||
# (This should really be under 'gui', not 'git')
|
||||
parseEmoji: true
|
||||
# Config for showing the log in the commits view
|
||||
log:
|
||||
# One of: 'date-order' | 'author-date-order' | 'topo-order' | 'default'
|
||||
# 'topo-order' makes it easier to read the git log graph, but commits may not
|
||||
# appear chronologically. See https://git-scm.com/docs/
|
||||
#
|
||||
# Deprecated: Configure this with `Log menu -> Commit sort order` (<c-l> in the commits window by default).
|
||||
order: topo-order
|
||||
# This determines whether the git graph is rendered in the commits panel
|
||||
# One of 'always' | 'never' | 'when-maximised'
|
||||
#
|
||||
# Deprecated: Configure this with `Log menu -> Show git graph` (<c-l> in the commits window by default).
|
||||
showGraph: always
|
||||
# displays the whole git graph by default in the commits view (equivalent to passing the `--all` argument to `git log`)
|
||||
showWholeGraph: true
|
||||
# When copying commit hashes to the clipboard, truncate them to this
|
||||
# length. Set to 40 to disable truncation.
|
||||
truncateCopiedCommitHashesTo: 8
|
||||
allBranchesLogCmds:
|
||||
- git log --graph --all --color=always --abbrev-commit --decorate --date=relative --pretty=medium
|
||||
# Periodic update checks
|
||||
update:
|
||||
# One of: 'prompt' (default) | 'background' | 'never'
|
||||
method: background
|
||||
# Period in days between update checks
|
||||
days: 14
|
||||
# Background refreshes
|
||||
refresher:
|
||||
# File/submodule refresh interval in seconds.
|
||||
# Auto-refresh can be disabled via option 'git.autoRefresh'.
|
||||
refreshInterval: 10
|
||||
# Re-fetch interval in seconds.
|
||||
# Auto-fetch can be disabled via option 'git.autoFetch'.
|
||||
fetchInterval: 60
|
||||
# If true, show a confirmation popup before quitting Lazygit
|
||||
confirmOnQuit: false
|
||||
# If true, exit Lazygit when the user presses escape in a context where there is nothing to cancel/close
|
||||
quitOnTopLevelReturn: true
|
||||
# Config relating to things outside of Lazygit like how files are opened, copying to clipboard, etc
|
||||
os:
|
||||
# Command for editing a file. Should contain "{{filename}}".
|
||||
edit: ""
|
||||
# Command for editing a file at a given line number. Should contain
|
||||
# "{{filename}}", and may optionally contain "{{line}}".
|
||||
editAtLine: ""
|
||||
# Same as EditAtLine, except that the command needs to wait until the
|
||||
# window is closed.
|
||||
editAtLineAndWait: ""
|
||||
# For opening a directory in an editor
|
||||
openDirInEditor: ""
|
||||
# A built-in preset that sets all of the above settings. Supported presets
|
||||
# are defined in the getPreset function in editor_presets.go.
|
||||
editPreset: ""
|
||||
# Command for opening a file, as if the file is double-clicked. Should
|
||||
# contain "{{filename}}", but doesn't support "{{line}}".
|
||||
open: ""
|
||||
# Command for opening a link. Should contain "{{link}}".
|
||||
openLink: "bash -C /home/prad/.local/share/omarchy/bin/omarchy-launch-webapp {{link}}"
|
||||
# EditCommand is the command for editing a file.
|
||||
# Deprecated: use Edit instead. Note that semantics are different:
|
||||
# EditCommand is just the command itself, whereas Edit contains a
|
||||
# "{{filename}}" variable.
|
||||
# EditCommandTemplate is the command template for editing a file
|
||||
# Deprecated: use EditAtLine instead.
|
||||
# OpenCommand is the command for opening a file
|
||||
# Deprecated: use Open instead.
|
||||
# OpenLinkCommand is the command for opening a link
|
||||
# Deprecated: use OpenLink instead.
|
||||
# CopyToClipboardCmd is the command for copying to clipboard.
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Config.md#custom-command-for-copying-to-and-pasting-from-clipboard
|
||||
copyToClipboardCmd: "wl-copy"
|
||||
# ReadFromClipboardCmd is the command for reading the clipboard.
|
||||
# See https://github.com/jesseduffield/lazygit/blob/master/docs/Config.md#custom-command-for-copying-to-and-pasting-from-clipboard
|
||||
readFromClipboardCmd: "wl-paste"
|
||||
# If true, don't display introductory popups upon opening Lazygit.
|
||||
disableStartupPopups: true
|
||||
# What to do when opening Lazygit outside of a git repo.
|
||||
# - 'prompt': (default) ask whether to initialize a new repo or open in the most recent repo
|
||||
# - 'create': initialize a new repo
|
||||
# - 'skip': open most recent repo
|
||||
# - 'quit': exit Lazygit
|
||||
notARepository: skip
|
||||
# If true, display a confirmation when subprocess terminates. This allows you to view the output of the subprocess before returning to Lazygit.
|
||||
promptToReturnFromSubprocess: false
|
||||
# Keybindings
|
||||
keybinding:
|
||||
universal:
|
||||
quit: q
|
||||
quit-alt1: <c-q>
|
||||
return: <esc>
|
||||
quitWithoutChangingDirectory: Q
|
||||
togglePanel: <tab>
|
||||
prevItem: <up>
|
||||
nextItem: <down>
|
||||
prevItem-alt: k
|
||||
nextItem-alt: j
|
||||
prevPage: ","
|
||||
nextPage: .
|
||||
scrollLeft: H
|
||||
scrollRight: L
|
||||
gotoTop: <
|
||||
gotoBottom: ">"
|
||||
toggleRangeSelect: v
|
||||
rangeSelectDown: <s-down>
|
||||
rangeSelectUp: <s-up>
|
||||
prevBlock: <left>
|
||||
nextBlock: <right>
|
||||
prevBlock-alt: h
|
||||
nextBlock-alt: l
|
||||
nextBlock-alt2: <tab>
|
||||
prevBlock-alt2: <backtab>
|
||||
jumpToBlock:
|
||||
- "1"
|
||||
- "2"
|
||||
- "3"
|
||||
- "4"
|
||||
- "5"
|
||||
nextMatch: "n"
|
||||
prevMatch: "N"
|
||||
startSearch: /
|
||||
optionMenu: "?"
|
||||
select: <space>
|
||||
goInto: <enter>
|
||||
confirm: <enter>
|
||||
confirmInEditor: <a-enter>
|
||||
remove: d
|
||||
new: "n"
|
||||
edit: e
|
||||
openFile: o
|
||||
scrollUpMain: <pgup>
|
||||
scrollDownMain: <pgdown>
|
||||
scrollUpMain-alt1: K
|
||||
scrollDownMain-alt1: J
|
||||
scrollUpMain-alt2: <c-u>
|
||||
scrollDownMain-alt2: <c-d>
|
||||
createRebaseOptionsMenu: m
|
||||
# 'Files' appended for legacy reasons
|
||||
pushFiles: P
|
||||
# 'Files' appended for legacy reasons
|
||||
pullFiles: p
|
||||
refresh: R
|
||||
createPatchOptionsMenu: <c-p>
|
||||
nextTab: "]"
|
||||
prevTab: "["
|
||||
nextScreenMode: +
|
||||
prevScreenMode: _
|
||||
undo: z
|
||||
redo: <c-z>
|
||||
filteringMenu: <c-s>
|
||||
diffingMenu: W
|
||||
diffingMenu-alt: <c-e>
|
||||
copyToClipboard: <c-o>
|
||||
openRecentRepos: <c-r>
|
||||
submitEditorText: <enter>
|
||||
extrasMenu: "@"
|
||||
toggleWhitespaceInDiffView: <c-w>
|
||||
increaseContextInDiffView: "}"
|
||||
decreaseContextInDiffView: "{"
|
||||
increaseRenameSimilarityThreshold: )
|
||||
decreaseRenameSimilarityThreshold: (
|
||||
openDiffTool: <c-t>
|
||||
newWorktree: w
|
||||
status:
|
||||
checkForUpdate: u
|
||||
recentRepos: <enter>
|
||||
allBranchesLogGraph: a
|
||||
files:
|
||||
commitChanges: c
|
||||
commitChangesWithoutHook: w
|
||||
amendLastCommit: E
|
||||
commitChangesWithEditor: C
|
||||
findBaseCommitForFixup: <c-f>
|
||||
confirmDiscard: x
|
||||
ignoreFile: i
|
||||
refreshFiles: r
|
||||
stashAllChanges: s
|
||||
viewStashOptions: S
|
||||
toggleStagedAll: a
|
||||
viewResetOptions: D
|
||||
fetch: f
|
||||
toggleTreeView: "`"
|
||||
openMergeOptions: M
|
||||
openStatusFilter: <c-b>
|
||||
copyFileInfoToClipboard: "y"
|
||||
branches:
|
||||
createPullRequest: "1"
|
||||
viewPullRequestOptions: O
|
||||
copyPullRequestURL: <c-y>
|
||||
checkoutBranchByName: c
|
||||
forceCheckoutBranch: F
|
||||
rebaseBranch: r
|
||||
renameBranch: R
|
||||
mergeIntoCurrentBranch: M
|
||||
viewGitFlowOptions: i
|
||||
fastForward: f
|
||||
createTag: T
|
||||
pushTag: P
|
||||
setUpstream: u
|
||||
fetchRemote: f
|
||||
sortOrder: s
|
||||
commits:
|
||||
squashDown: s
|
||||
renameCommit: r
|
||||
renameCommitWithEditor: R
|
||||
viewResetOptions: g
|
||||
markCommitAsFixup: f
|
||||
createFixupCommit: F
|
||||
squashAboveCommits: S
|
||||
moveDownCommit: <c-j>
|
||||
moveUpCommit: <c-k>
|
||||
resetCommitAuthor: a
|
||||
pickCommit: p
|
||||
revertCommit: t
|
||||
cherryPickCopy: C
|
||||
pasteCommits: V
|
||||
markCommitAsBaseForRebase: B
|
||||
tagCommit: T
|
||||
checkoutCommit: <space>
|
||||
resetCherryPick: <c-c>
|
||||
copyCommitAttributeToClipboard: "y"
|
||||
openLogMenu: <c-l>
|
||||
openInBrowser: o
|
||||
viewBisectOptions: b
|
||||
startInteractiveRebase: i
|
||||
amendAttribute:
|
||||
resetAuthor: a
|
||||
setAuthor: A
|
||||
addCoAuthor: c
|
||||
stash:
|
||||
popStash: g
|
||||
renameStash: r
|
||||
commitFiles:
|
||||
checkoutCommitFile: c
|
||||
main:
|
||||
toggleSelectHunk: a
|
||||
pickBothHunks: b
|
||||
editSelectHunk: E
|
||||
submodules:
|
||||
init: i
|
||||
update: u
|
||||
bulkMenu: b
|
||||
commitMessage:
|
||||
commitMenu: <c-o>
|
||||
customCommands:
|
||||
- key: "<c-i>"
|
||||
command: "gitv {{.Repository.Owner}}/{{.Repository.Name}}"
|
||||
context: "global"
|
||||
output: terminal
|
||||
- key: "<c-w>"
|
||||
command: "gwm"
|
||||
context: "global"
|
||||
output: terminal
|
||||
- key: "<c-a>"
|
||||
command: "wrkflw"
|
||||
context: "global"
|
||||
output: terminal
|
||||
- key: "<c-p>"
|
||||
command: "github prs"
|
||||
context: "global"
|
||||
output: terminal
|
||||
- key: "F"
|
||||
command: "gh repo sync && gh clean-branches --force"
|
||||
context: "files"
|
||||
output: log
|
||||
description: "Sync repo and clean branches, update DuckDB cache"
|
||||
- key: "A"
|
||||
description: "Smart commit with AI"
|
||||
context: "files"
|
||||
command: "gh commit"
|
||||
output: terminal
|
||||
- key: "C"
|
||||
description: "Smart commit with AI"
|
||||
context: "files"
|
||||
command: "gh commit"
|
||||
output: terminal
|
||||
- key: "o"
|
||||
description: "start ai pull request"
|
||||
command: "gh pr create --fill -w"
|
||||
context: "localBranches"
|
||||
- key: "O"
|
||||
context: "commits"
|
||||
command: 'hub browse -- "commit/{{.SelectedLocalCommit.Hash}}"'
|
||||
- key: "C"
|
||||
command: "gh repo sync && gh clean-branches --force"
|
||||
context: "localBranches"
|
||||
output: log
|
||||
description: "Sync repo, clean branches, update cache"
|
||||
- key: "a"
|
||||
context: "files"
|
||||
command: "git {{if .SelectedFile.HasUnstagedChanges}} add {{else}} reset {{end}} {{.SelectedFile.Name | quote}}"
|
||||
description: "Toggle file staged"
|
||||
- key: "L"
|
||||
context: "files"
|
||||
command: "livediff"
|
||||
output: terminal
|
||||
- key: "<c-d>"
|
||||
context: "files"
|
||||
command: "gh dash"
|
||||
output: terminal
|
||||
- key: "<c-o>"
|
||||
context: "files"
|
||||
command: "gh browse"
|
||||
@@ -0,0 +1,28 @@
|
||||
# Auto-generated by ii wallpaper theming system
|
||||
# This is the theme section for lazygit config.yml
|
||||
gui:
|
||||
theme:
|
||||
activeBorderColor:
|
||||
- "#FFFFFF"
|
||||
- bold
|
||||
inactiveBorderColor:
|
||||
- "#8F9192"
|
||||
optionsTextColor:
|
||||
- "#FFFFFF"
|
||||
selectedLineBgColor:
|
||||
- "#1F1F1F"
|
||||
selectedRangeBgColor:
|
||||
- "#1F1F1F"
|
||||
cherryPickedCommitFgColor:
|
||||
- "#FFFFFF"
|
||||
cherryPickedCommitBgColor:
|
||||
- "#1F1F1F"
|
||||
markedBaseCommitFgColor:
|
||||
- "#FFF17B"
|
||||
markedBaseCommitBgColor:
|
||||
- "#1F1F1F"
|
||||
unstagedChangesColor:
|
||||
- "#FF9BAD"
|
||||
defaultFgColor:
|
||||
- "#DFE3E3"
|
||||
|
||||
@@ -0,0 +1,64 @@
|
||||
[Default Applications]
|
||||
text/plain=vim.desktop
|
||||
text/x-shellscript=vim.desktop
|
||||
text/x-python=vim.desktop
|
||||
text/x-script.python=vim.desktop
|
||||
text/markdown=obsidian.desktop
|
||||
application/x-obsidian-canvas=obsidian.desktop
|
||||
application/x-obsidian-base=obsidian.desktop
|
||||
x-scheme-handler/obsidian=obsidian.desktop
|
||||
text/html=brave-origin.desktop
|
||||
x-scheme-handler/http=brave-origin.desktop
|
||||
x-scheme-handler/https=brave-origin.desktop
|
||||
x-scheme-handler/about=chromium.desktop
|
||||
x-scheme-handler/unknown=chromium.desktop
|
||||
x-scheme-handler/chrome=brave-origin.desktop
|
||||
application/x-extension-htm=brave-origin.desktop
|
||||
application/x-extension-html=brave-origin.desktop
|
||||
application/x-extension-shtml=brave-origin.desktop
|
||||
application/xhtml+xml=brave-origin.desktop
|
||||
application/x-extension-xhtml=brave-origin.desktop
|
||||
application/x-extension-xht=brave-origin.desktop
|
||||
x-scheme-handler/figma=figma-linux.desktop
|
||||
x-scheme-handler/claude=com.anthropic.Claude.desktop
|
||||
x-scheme-handler/claude-cli=claude-code-url-handler.desktop
|
||||
x-scheme-handler/com.todoist=todoist.desktop
|
||||
x-scheme-handler/todoist=todoist.desktop
|
||||
x-scheme-handler/openhuman=OpenHuman-handler.desktop
|
||||
application/vnd.microsoft.portable-executable=wine.desktop
|
||||
x-scheme-handler/slack=slack.desktop
|
||||
x-scheme-handler/mailto=omamail.desktop
|
||||
x-scheme-handler/anytype=anytype.desktop
|
||||
x-scheme-handler/piebald=piebald-handler.desktop
|
||||
x-scheme-handler/discord-647066573147996160=discord-647066573147996161.desktop
|
||||
x-scheme-handler/tolaria=tolaria-handler.desktop
|
||||
x-scheme-handler/antigravity=antigravity.desktop
|
||||
application/pdf=brave-origin.desktop
|
||||
x-scheme-handler/opencode=ai.opencode.desktop.desktop
|
||||
x-scheme-handler/follow=folo.desktop
|
||||
x-scheme-handler/folo=folo.desktop
|
||||
x-scheme-handler/tldraw-offline=tldraw-offline.desktop
|
||||
x-scheme-handler/notion=notion.desktop
|
||||
inode/directory=io.github.lgse.Strata.desktop
|
||||
x-scheme-handler/fastmail=com.fastmail.Fastmail.desktop
|
||||
x-scheme-handler/grokbot=grok-bot.desktop
|
||||
x-scheme-handler/sand=grok-bot.desktop
|
||||
x-scheme-handler/tern=so.stencil.tern.url.desktop
|
||||
x-scheme-handler/openknowledge=openknowledge.desktop
|
||||
|
||||
[Added Associations]
|
||||
x-scheme-handler/http=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
x-scheme-handler/https=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
x-scheme-handler/chrome=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
text/html=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/x-extension-htm=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/x-extension-html=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/x-extension-shtml=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/xhtml+xml=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/x-extension-xhtml=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/x-extension-xht=brave-origin.desktop;userapp-Floorp-8MTFP3.desktop;
|
||||
application/vnd.microsoft.portable-executable=wine.desktop;
|
||||
x-scheme-handler/mailto=userapp-Evolution-PCEYQ4.desktop;
|
||||
application/pdf=brave-origin.desktop;
|
||||
x-scheme-handler/opencode=ai.opencode.desktop.desktop;
|
||||
x-scheme-handler/openknowledge=openknowledge.desktop;
|
||||
@@ -0,0 +1,33 @@
|
||||
# Shared aliases for bash and zsh — generated from .chezmoidata/aliases.yaml.
|
||||
# fish renders the same data via fish/conf.d/20-aliases.fish. Edit the YAML,
|
||||
# not this file. Sourced from ~/.bashrc and ~/.zshrc (interactive shells only).
|
||||
{{- range .aliases }}
|
||||
|
||||
# {{ .section }}
|
||||
{{- range .items }}
|
||||
alias {{ .name }}='{{ .cmd }}'
|
||||
{{- end }}
|
||||
{{- end }}
|
||||
|
||||
# Clipboard
|
||||
if command -v wl-copy >/dev/null 2>&1; then
|
||||
alias cpy='wl-copy'
|
||||
alias pst='wl-paste'
|
||||
fi
|
||||
|
||||
# q exits the shell; if this shell was spawned from yazi's own `q` bind
|
||||
# (`shell "$SHELL" --block`), also tell that yazi to quit so exiting
|
||||
# doesn't bounce back into the file manager.
|
||||
q() {
|
||||
if [ -n "$YAZI_ID" ] && command -v ya >/dev/null 2>&1; then
|
||||
ya emit quit 2>/dev/null
|
||||
fi
|
||||
exit
|
||||
}
|
||||
|
||||
# Typo guards + eza (this file is only sourced by interactive shells)
|
||||
alias celar='clear'
|
||||
alias claer='clear'
|
||||
if command -v eza >/dev/null 2>&1; then
|
||||
alias ls='eza --icons'
|
||||
fi
|
||||
@@ -0,0 +1,140 @@
|
||||
"$schema" = 'https://starship.rs/config-schema.json'
|
||||
palette = "cherryblossom"
|
||||
|
||||
|
||||
format = """
|
||||
$username\
|
||||
$hostname\
|
||||
$directory\
|
||||
$git_branch\
|
||||
$git_state\
|
||||
$git_status\
|
||||
$cmd_duration\
|
||||
$python\
|
||||
$character"""
|
||||
|
||||
add_newline = true
|
||||
|
||||
right_format = """$time"""
|
||||
|
||||
# zsh transient prompt (~/.zshrc). `starship prompt --profile` emits
|
||||
# zsh-escaped output; `starship module` doesn't, which breaks RPROMPT width.
|
||||
[profiles]
|
||||
transient = "$character"
|
||||
transient_right = "$time"
|
||||
|
||||
[directory]
|
||||
style = "blue"
|
||||
|
||||
[character]
|
||||
success_symbol = "[❯](purple)"
|
||||
error_symbol = "[❯](red)"
|
||||
vimcmd_symbol = "[❮](green)"
|
||||
|
||||
[git_branch]
|
||||
format = "[$branch]($style)"
|
||||
style = "bright-black"
|
||||
|
||||
[git_status]
|
||||
format = "[[(*$conflicted$untracked$modified$staged$renamed$deleted)](218) ($ahead_behind$stashed)]($style)"
|
||||
style = "cyan"
|
||||
conflicted = ""
|
||||
untracked = ""
|
||||
modified = ""
|
||||
staged = ""
|
||||
renamed = ""
|
||||
deleted = ""
|
||||
stashed = "≡"
|
||||
|
||||
[git_state]
|
||||
format = '\([$state( $progress_current/$progress_total)]($style)\) '
|
||||
style = "bright-black"
|
||||
|
||||
[cmd_duration]
|
||||
format = "[$duration]($style) "
|
||||
style = "yellow"
|
||||
|
||||
[python]
|
||||
format = "[$virtualenv]($style) "
|
||||
style = "bright-black"
|
||||
detect_extensions = []
|
||||
detect_files = []
|
||||
|
||||
[time]
|
||||
disabled = false
|
||||
format = '[$time]($style)'
|
||||
time_format = '%-I:%M %p'
|
||||
style = "bright-black"
|
||||
|
||||
[palettes.cyberdream]
|
||||
# https://github.com/scottmckendry/cyberdream.nvim
|
||||
black = "#1e2124"
|
||||
red = "#ff6e5e"
|
||||
green = "#5eff6c"
|
||||
yellow = "#f1ff5e"
|
||||
blue = "#5ea1ff"
|
||||
purple = "#bd5eff"
|
||||
cyan = "#5ef1ff"
|
||||
white = "#ffffff"
|
||||
|
||||
bright-black = "#4a4d4f"
|
||||
bright-red = "#ff8b7e"
|
||||
bright-green = "#7eff89"
|
||||
bright-yellow = "#f3ff7e"
|
||||
bright-blue = "#7eb3ff"
|
||||
bright-purple = "#ff7ef3"
|
||||
bright-cyan = "#7ef3ff"
|
||||
bright-white = "#ffffff"
|
||||
|
||||
# Dim variants (usable as named colors in styles)
|
||||
dim-black = "#1c1f22"
|
||||
dim-red = "#d05c50"
|
||||
dim-green = "#4fd05b"
|
||||
dim-yellow = "#c5d050"
|
||||
dim-blue = "#4f85d1"
|
||||
dim-purple = "#d050c6"
|
||||
dim-cyan = "#4fc5d1"
|
||||
dim-white = "#d0d0d1"
|
||||
|
||||
# >>> CHERRYBLOSSOM STARSHIP PALETTE >>>
|
||||
# CherryBlossom Starship Palette
|
||||
|
||||
[palettes.cherryblossom]
|
||||
# Standard colors
|
||||
blue = "#7a858b"
|
||||
red = "#bf615d"
|
||||
green = "#8a9a6b"
|
||||
yellow = "#c17e4a"
|
||||
cyan = "#a78266"
|
||||
magenta = "#ad6756"
|
||||
white = "#dcc1b7"
|
||||
black = "#201d1c"
|
||||
|
||||
# Extended palette (Catppuccin-compatible names)
|
||||
rosewater = "#ae825f"
|
||||
flamingo = "#cf716f"
|
||||
pink = "#c6745f"
|
||||
mauve = "#ad6756"
|
||||
maroon = "#cf716f"
|
||||
peach = "#ae825f"
|
||||
teal = "#a78266"
|
||||
sky = "#baa59d"
|
||||
sapphire = "#8f9aa0"
|
||||
lavender = "#c6745f"
|
||||
|
||||
# Text shades
|
||||
text = "#dcc1b7"
|
||||
subtext1 = "#dcc1b7"
|
||||
subtext0 = "#5b5450"
|
||||
|
||||
# Surface shades
|
||||
overlay2 = "#5b5450"
|
||||
overlay1 = "#5b5450"
|
||||
overlay0 = "#201d1c"
|
||||
surface2 = "#201d1c"
|
||||
surface1 = "#201d1c"
|
||||
surface0 = "#222120"
|
||||
base = "#222120"
|
||||
mantle = "#222120"
|
||||
crust = "#222120"
|
||||
# <<< CHERRYBLOSSOM STARSHIP PALETTE <<<
|
||||
@@ -0,0 +1,13 @@
|
||||
[Unit]
|
||||
Description=Save kitty daily sessions before shutdown/reboot
|
||||
PartOf=graphical-session.target
|
||||
After=graphical-session.target
|
||||
|
||||
[Service]
|
||||
ExecStart=%h/.local/bin/kitty-day-save
|
||||
# Re-arm after a flush, in case the shutdown is cancelled.
|
||||
Restart=always
|
||||
RestartSec=10
|
||||
|
||||
[Install]
|
||||
WantedBy=graphical-session.target
|
||||
@@ -0,0 +1,6 @@
|
||||
[Unit]
|
||||
Description=Symlink ~/Code repos into ~/Projects
|
||||
|
||||
[Service]
|
||||
Type=oneshot
|
||||
ExecStart=%h/.local/bin/projects-sync
|
||||
@@ -0,0 +1,11 @@
|
||||
[Unit]
|
||||
Description=Keep ~/Projects in sync with ~/Code
|
||||
|
||||
# ponytail: polls every 5 min; ghq clones land two levels below ~/Code, out
|
||||
# of reach of a non-recursive .path unit. Switch to inotify if 5 min is slow.
|
||||
[Timer]
|
||||
OnStartupSec=30s
|
||||
OnUnitActiveSec=5min
|
||||
|
||||
[Install]
|
||||
WantedBy=timers.target
|
||||
@@ -0,0 +1,92 @@
|
||||
# ~/.config/topgrade.toml — tailored for Omarchy (Arch · yay · fish)
|
||||
# Only the keys that matter for this box are uncommented; everything else
|
||||
# keeps topgrade's sane defaults.
|
||||
|
||||
[misc]
|
||||
# pacman/yay escalate privileges mid-run; cache sudo creds up front so an
|
||||
# unattended run doesn't block on a password prompt halfway through.
|
||||
pre_sudo = true
|
||||
|
||||
# topgrade on this box is cargo-installed (~/.cargo/bin/topgrade), and the
|
||||
# [cargo] step below (cargo-update) already owns updating it. Self-update
|
||||
# stays off so two updaters don't fight over the same binary.
|
||||
no_self_update = true
|
||||
|
||||
# Run distro cleanup after upgrading (paccache).
|
||||
# Needs `pacman-contrib` for paccache; harmlessly skipped if absent.
|
||||
cleanup = true
|
||||
|
||||
# Surface *.pacnew / *.pacsave you need to merge — critical on a rolling
|
||||
# Arch base. (default true; pinned here as a reminder.)
|
||||
show_distribution_summary = true
|
||||
|
||||
# Globally skipped steps:
|
||||
# containers → topgrade pulls :latest for every local image on every run,
|
||||
# which is noisy and can drag in breaking tags. Drop this entry
|
||||
# if you actually want your dev images auto-refreshed.
|
||||
disable = ["containers", "config_update"]
|
||||
|
||||
ignore_failures = ["uv", "containers"]
|
||||
|
||||
# NOTE: the [python] pip/conda steps are off by default and left that way —
|
||||
# that's what protects your pinned torch 2.10.0+rocm7.2.4 from a blind upgrade.
|
||||
|
||||
# Optional: update topgrade on goliath in the same pass. Requires topgrade
|
||||
# installed there + tmux locally; rides your existing SSH ControlMaster.
|
||||
# remote_topgrades = ["goliath"]
|
||||
|
||||
|
||||
[linux]
|
||||
# Omarchy's AUR helper is yay. Pin it so topgrade never silently falls back
|
||||
# to bare `pacman` (which would skip the AUR).
|
||||
# Valid values: autodetect, aura, garuda_update, pacman, pamac, paru, pikaur,
|
||||
# trizen, yay
|
||||
arch_package_manager = "yay"
|
||||
|
||||
# Pull archlinux.org news before the upgrade. Omarchy tracks Arch, so
|
||||
# manual-intervention advisories (keyring, library bumps) still apply to you.
|
||||
show_arch_news = true
|
||||
|
||||
|
||||
[cargo]
|
||||
# Also update git-sourced installs (your smartcommit / skillforge CLIs),
|
||||
# not just crates.io ones. This step is also what keeps topgrade itself fresh.
|
||||
git = true
|
||||
# Requires the updater binary: cargo install cargo-update
|
||||
|
||||
|
||||
[firmware]
|
||||
# Check + display only — review fwupd updates before flashing the Z13 rather
|
||||
# than auto-applying firmware in an unattended run.
|
||||
upgrade = false
|
||||
|
||||
|
||||
[git]
|
||||
# Predefined repos still get pulled by default. Add your own globs if you want
|
||||
# configs fetched in the same pass; left commented so topgrade doesn't trip
|
||||
# over a dirty working tree mid-run.
|
||||
# repos = ["~/.config/omarchy", "~/Code/prad.codes/env/omarchy"]
|
||||
# arguments = "--rebase --autostash"
|
||||
|
||||
|
||||
[flatpak]
|
||||
# User-scope flatpaks update without sudo. Only set this if you keep
|
||||
# system-wide installs.
|
||||
# use_sudo = true
|
||||
|
||||
|
||||
[pre_commands]
|
||||
# "Emacs Snapshot" = "rm -rf ~/.emacs.d/elpa.bak && cp -rl ~/.emacs.d/elpa ~/.emacs.d/elpa.bak"
|
||||
# Capture local drift in managed config back into the chezmoi source repo
|
||||
# before anything upgrades. Note: only re-adds *managed* files; brand-new
|
||||
# configs still need a manual `chezmoi add`. Review/commit in
|
||||
# ~/.local/share/chezmoi afterwards.
|
||||
"Chezmoi Re-Add" = "chezmoi re-add"
|
||||
"GHQ Update" = "ghq list | ghq get -u -s"
|
||||
|
||||
|
||||
# Commands to run after anything
|
||||
[post_commands]
|
||||
# "Emacs Snapshot" = "rm -rf ~/.emacs.d/elpa.bak && cp -rl ~/.emacs.d/elpa ~/.emacs.d/elpa.bak"
|
||||
"Hermes Update" = "hermes update --backup --yes"
|
||||
"Herdr Update" = "herdr update"
|
||||
Loaded 100 of 163 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user