1 Commits

Author SHA1 Message Date
882fe4aa3c docs: add AGENTS.md with dev workflow conventions 2026-05-19 15:27:53 -04:00
8 changed files with 18 additions and 101 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,5 +1,5 @@
# 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
all: stow_all
wal -i ~/.config/wallpapers/green_yellow_forest.jpg -o ~/.config/waybar/launch.sh

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
(map! :leader
(:prefix ("w" . "window")
:desc "Minimize window" "O" #'minimize-window)
(:prefix ("z" . "Personal")
:desc "Hermes Agent" "h" #'gortium/hermes-vterm))
:desc "Minimize window" "O" #'minimize-window))
#+end_src
** Ultra-scroll
@@ -1832,25 +1830,6 @@ Org-AI
(org-ai-install-yasnippets)) ; if you are using yasnippet and want `ai` snippets
#+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
Remote connection to server inside emacs (with all my config) <3

View File

@@ -18,9 +18,7 @@
(map! :leader
(:prefix ("w" . "window")
:desc "Minimize window" "O" #'minimize-window)
(:prefix ("z" . "Personal")
:desc "Hermes Agent" "h" #'gortium/hermes-vterm))
:desc "Minimize window" "O" #'minimize-window))
(use-package! ultra-scroll
:init
@@ -1055,20 +1053,6 @@ DIFF:
:desc "GPT 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
(connection-local-set-profile-variables
'remote-direct-async-process

View File

@@ -147,8 +147,7 @@ animations {
# See https://wiki.hyprland.org/Configuring/Dwindle-Layout/ for more
dwindle {
# Note: pseudotile variable removed in 0.55+. Use `pseudo` dispatcher to toggle per-window.
# Bound to $mainMod + P below.
pseudotile = true # Master switch for pseudotiling. Enabling is bound to mainMod + P in the keybinds section below
# This prevents the layout from collapsing if you close one window
preserve_split = true # You probably want this
@@ -220,15 +219,14 @@ bind = $mainMod, E, exec, $editor
bind = $mainMod, V, togglefloating,
bind = $mainMod, R, exec, $menu
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 SHIFT, N, movecurrentworkspacetomonitor, +1
bind = $mainMod, X, swapwindow
bind = $mainMod, B, exec, python /home/tpouplier/ExoKortex/4-Automata/recordntrans/record_transcribe.py
# bind = $mainMod, G, exec, nerd-dictation end
bind = $mainMod, A, exec, $music
bind = $mainMod, C, exec, emacsclient -n -c -e '(gortium/hermes-vterm)'
# Full screen
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

@@ -19,33 +19,6 @@ alias emacs="emacsclient -c -a emacs"
# 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
alias y="yazi"
function yy() {