1 Commits

Author SHA1 Message Date
882fe4aa3c docs: add AGENTS.md with dev workflow conventions 2026-05-19 15:27:53 -04:00
9 changed files with 18 additions and 144 deletions

12
AGENTS.md Normal file
View File

@@ -0,0 +1,12 @@
# AGENTS.md
Personal development conventions — applies to all projects unless overridden by a project-level AGENTS.md.
## Workflow
- New feature → clean branch from `origin/master` → push → PR on Gitea
- Branch naming: `feat/description` (features), `fix/description` (bugs/docs/docs/chores)
- Always branch from `origin/master`, never from another feature branch
- PR title describes the change; body explains motivation + summary
- After PR merge, delete the feature branch
- Always validate before push (build, lint, test)

View File

@@ -1,15 +1,10 @@
# Define list of directories you want to stow # Define list of directories you want to stow
CONFIG_DIRS := btop doom hypr kitty local nvim rclone starship tmux wallpapers waybar wireplumber wofi yazi zsh CONFIG_DIRS := btop doom hypr kitty nvim rclone starship tmux wallpapers waybar wireplumber wofi yazi zsh
# Local stow package directory (installed to ~/.local)
STOW_LOCAL_DIR := local
all: stow_all all: stow_all
wal -i ~/.config/wallpapers/green_yellow_forest.jpg -o ~/.config/waybar/launch.sh wal -i ~/.config/wallpapers/green_yellow_forest.jpg -o ~/.config/waybar/launch.sh
neofetch neofetch
.PHONY: all stow_all stow_local stow_rclone post_install_rclone clean
# Main target to handle stowing for all directories except rclone # Main target to handle stowing for all directories except rclone
stow_all: $(filter-out rclone, $(CONFIG_DIRS)) stow_all: $(filter-out rclone, $(CONFIG_DIRS))
@echo "Cleaning broken symlinks in ~/.config..." @echo "Cleaning broken symlinks in ~/.config..."
@@ -26,13 +21,6 @@ stow_%:
@echo "Stowing $*" @echo "Stowing $*"
stow -v -t $(HOME) $* stow -v -t $(HOME) $*
# Special target for the local stow package
stow_local:
@echo "Cleaning broken symlinks in ~/.local/share/applications..."
find ~/.local/share/applications -xtype l -delete -print
@echo "Stowing local package"
stow -v -t $(HOME) $(STOW_LOCAL_DIR)
# Post-installation script for rclone (executed after stowing) # Post-installation script for rclone (executed after stowing)
post_install_rclone: post_install_rclone:
@echo "Running post-installation script for rclone" @echo "Running post-installation script for rclone"
@@ -47,11 +35,3 @@ stow_rclone:
@echo "Stowing rclone" @echo "Stowing rclone"
stow -v -t $(HOME) rclone stow -v -t $(HOME) rclone
@$(MAKE) post_install_rclone @$(MAKE) post_install_rclone
# Unstow all packages
clean:
@echo "Unstowing all packages..."
@for dir in $(CONFIG_DIRS); do \
echo "Unstowing $$dir..."; \
stow -v -D -t $(HOME) $$dir 2>/dev/null || true; \
done

View File

@@ -112,9 +112,7 @@ My current workflow consist in having the 3-5 files I work on open in vertical s
#+begin_src emacs-lisp #+begin_src emacs-lisp
(map! :leader (map! :leader
(:prefix ("w" . "window") (:prefix ("w" . "window")
:desc "Minimize window" "O" #'minimize-window) :desc "Minimize window" "O" #'minimize-window))
(:prefix ("z" . "Personal")
:desc "Hermes Agent" "h" #'gortium/hermes-vterm))
#+end_src #+end_src
** Ultra-scroll ** Ultra-scroll
@@ -1832,25 +1830,6 @@ Org-AI
(org-ai-install-yasnippets)) ; if you are using yasnippet and want `ai` snippets (org-ai-install-yasnippets)) ; if you are using yasnippet and want `ai` snippets
#+end_src #+end_src
** +Hermes Agent+
Hermes Agent runs on lazyworkhorse server. Launched via SSH in a vterm buffer.
#+begin_src emacs-lisp
(after! vterm
(defun gortium/hermes-vterm ()
"Launch Hermes Agent in vterm via SSH to lazyworkhorse (CLI mode)."
(interactive)
(let ((buf (get-buffer-create "*hermes*")))
(switch-to-buffer buf)
(unless (and (eq major-mode 'vterm-mode)
(get-buffer-process buf))
(vterm-mode)
(let ((proc (get-buffer-process buf)))
(when proc
(process-send-string
proc "ssh -t lazyworkhorse 'docker exec -it hermes /opt/hermes/.venv/bin/hermes'\n")))))))
#+end_src
* Tramp * Tramp
Remote connection to server inside emacs (with all my config) <3 Remote connection to server inside emacs (with all my config) <3

View File

@@ -18,9 +18,7 @@
(map! :leader (map! :leader
(:prefix ("w" . "window") (:prefix ("w" . "window")
:desc "Minimize window" "O" #'minimize-window) :desc "Minimize window" "O" #'minimize-window))
(:prefix ("z" . "Personal")
:desc "Hermes Agent" "h" #'gortium/hermes-vterm))
(use-package! ultra-scroll (use-package! ultra-scroll
:init :init
@@ -1055,20 +1053,6 @@ DIFF:
:desc "GPT generate commit" :desc "GPT generate commit"
"g" #'gortium/magit-gptel-generate-commit) "g" #'gortium/magit-gptel-generate-commit)
(after! vterm
(defun gortium/hermes-vterm ()
"Launch Hermes Agent in vterm via SSH to lazyworkhorse (CLI mode)."
(interactive)
(let ((buf (get-buffer-create "*hermes*")))
(switch-to-buffer buf)
(unless (and (eq major-mode 'vterm-mode)
(get-buffer-process buf))
(vterm-mode)
(let ((proc (get-buffer-process buf)))
(when proc
(process-send-string
proc "ssh -t lazyworkhorse 'docker exec -it hermes /opt/hermes/.venv/bin/hermes'\n")))))))
;; set `tramp-direct-async-process' locally in all ssh connections ;; set `tramp-direct-async-process' locally in all ssh connections
(connection-local-set-profile-variables (connection-local-set-profile-variables
'remote-direct-async-process 'remote-direct-async-process

View File

@@ -77,7 +77,6 @@ exec-once = hypridle
exec-once = hyprlock exec-once = hyprlock
exec-once = /usr/bin/emacs --daemon exec-once = /usr/bin/emacs --daemon
exec-once = dbus-update-activation-environment --systemd HYPRLAND_INSTANCE_SIGNATURE exec-once = dbus-update-activation-environment --systemd HYPRLAND_INSTANCE_SIGNATURE
exec-once = $HOME/.config/waybar/scripts/disk-monitor.sh --daemon
############################# #############################
### ENVIRONMENT VARIABLES ### ### ENVIRONMENT VARIABLES ###
@@ -148,8 +147,7 @@ animations {
# See https://wiki.hyprland.org/Configuring/Dwindle-Layout/ for more # See https://wiki.hyprland.org/Configuring/Dwindle-Layout/ for more
dwindle { dwindle {
# Note: pseudotile variable removed in 0.55+. Use `pseudo` dispatcher to toggle per-window. pseudotile = true # Master switch for pseudotiling. Enabling is bound to mainMod + P in the keybinds section below
# Bound to $mainMod + P below.
# This prevents the layout from collapsing if you close one window # This prevents the layout from collapsing if you close one window
preserve_split = true # You probably want this preserve_split = true # You probably want this
@@ -221,15 +219,14 @@ bind = $mainMod, E, exec, $editor
bind = $mainMod, V, togglefloating, bind = $mainMod, V, togglefloating,
bind = $mainMod, R, exec, $menu bind = $mainMod, R, exec, $menu
bind = $mainMod, Z, exec, $zen bind = $mainMod, Z, exec, $zen
# togglesplit removed as standalone dispatcher in 0.55+; use `layoutmsg togglesplit` instead #bind = $mainMod, P, pseudo, # dwindle
bind = $mainMod, P, pseudo, # dwindle bind = $mainMod, P, togglesplit, # dwindle
bind = $mainMod, N, movecurrentworkspacetomonitor, -1 bind = $mainMod, N, movecurrentworkspacetomonitor, -1
bind = $mainMod SHIFT, N, movecurrentworkspacetomonitor, +1 bind = $mainMod SHIFT, N, movecurrentworkspacetomonitor, +1
bind = $mainMod, X, swapwindow bind = $mainMod, X, swapwindow
bind = $mainMod, B, exec, python /home/tpouplier/ExoKortex/4-Automata/recordntrans/record_transcribe.py bind = $mainMod, B, exec, python /home/tpouplier/ExoKortex/4-Automata/recordntrans/record_transcribe.py
# bind = $mainMod, G, exec, nerd-dictation end # bind = $mainMod, G, exec, nerd-dictation end
bind = $mainMod, A, exec, $music bind = $mainMod, A, exec, $music
bind = $mainMod, C, exec, emacsclient -n -c -e '(gortium/hermes-vterm)'
# Full screen # Full screen
bind = SUPER, F, fullscreen bind = SUPER, F, fullscreen

View File

@@ -1,8 +0,0 @@
[Desktop Entry]
Name=QET (Xephyr)
Comment=QElectroTech in nested X server for Wayland compatibility
Exec=/home/tpouplier/ExoKortex/4-Automata/dotfiles/scripts/qet-xephyr.sh
Icon=qelectrotech
Type=Application
Categories=Graphics;Engineering;
Terminal=false

View File

@@ -1,21 +0,0 @@
#!/bin/bash
# Launch QElectroTech in a nested Xephyr X server with Openbox
# Works around Wayland drag-and-drop issue in QET
XEPHYR_PID=""
cleanup() {
kill $XEPHYR_PID 2>/dev/null
exit 0
}
trap cleanup SIGINT SIGTERM
Xephyr -screen 1920x1080 :1 -title QET -br &
XEPHYR_PID=$!
sleep 1
DISPLAY=:1 openbox &
sleep 0.5
DISPLAY=:1 qelectrotech &
wait $XEPHYR_PID

View File

@@ -213,28 +213,6 @@ tooltip label {
} }
/* custom modules */ /* custom modules */
#custom-disk-monitor {
margin: 0px 0px 0px 5px;
padding: 1px 8px 0px 8px;
font-size: 16px;
color: @text;
border-radius: 5px;
background-color: @set;
}
#custom-disk-monitor.warning {
background-color: #ff9a3c;
color: #FFFFFF;
}
#custom-disk-monitor.critical {
background-color: #dc2f2f;
color: #FFFFFF;
animation-name: blink;
animation-duration: 0.5s;
animation-timing-function: linear;
animation-iteration-count: infinite;
animation-direction: alternate;
}
#custom-exit { #custom-exit {
margin: 0px 18px 0px 5px; margin: 0px 18px 0px 5px;
padding: 0px; padding: 0px;

View File

@@ -19,33 +19,6 @@ alias emacs="emacsclient -c -a emacs"
# Opencode # Opencode
alias oc="opencode" alias oc="opencode"
# Hermes Agent - SSH directly to remote server
alias hermes="ssh -t lazyworkhorse 'docker exec -it hermes /opt/hermes/.venv/bin/hermes'"
hermes-cp() {
if [ $# -eq 0 ]; then
echo "Usage: hermes-cp <file_or_directory> [...]"
echo ""
echo "Copies files/directories from your Arch laptop into the Hermes"
echo "agent container at /opt/data/home/ preserving directory structure."
echo ""
echo "Examples:"
echo " hermes-cp document.pdf # single file"
echo " hermes-cp *.pdf # multiple files (glob)"
echo " hermes-cp manuals/ # whole directory"
echo " hermes-cp manuals/ keyence-docs/ # multiple items"
echo ""
echo "To copy to a different destination inside the container:"
echo " tar -czf - . | ssh gortium@lazyworkhorse \\"
echo " \"docker exec -i hermes sh -c 'cd /opt/data/projects && tar -xzf -'\""
return 1
fi
# tar everything into a single SSH pipe, extract inside container
# Supports: single files, directories, glob patterns, mixed args
tar -czf - "$@" | ssh gortium@lazyworkhorse \
"docker exec -i hermes sh -c 'cd /opt/data/home && tar -xzf -'"
}
# Yazi # Yazi
alias y="yazi" alias y="yazi"
function yy() { function yy() {