1 Commits

Author SHA1 Message Date
882fe4aa3c docs: add AGENTS.md with dev workflow conventions 2026-05-19 15:27:53 -04:00
11 changed files with 18 additions and 138 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 # 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 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

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

@@ -147,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
@@ -220,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

@@ -25,7 +25,6 @@
"modules-right": [ "modules-right": [
"group/hardware", "group/hardware",
"custom/disk-monitor",
"pulseaudio", "pulseaudio",
"bluetooth", "bluetooth",
"network", "network",

View File

@@ -88,13 +88,6 @@
"path": "/", "path": "/",
"on-click": "kitty btop" "on-click": "kitty btop"
}, },
// disk monitor (standalone, color-coded)
"custom/disk-monitor": {
"exec": "$HOME/.config/waybar/scripts/disk-monitor.sh --waybar",
"return-type": "json",
"interval": 60
},
// memory // memory
"memory": { "memory": {

View File

@@ -1,29 +0,0 @@
#!/usr/bin/env bash
# disk-monitor.sh -- Waybar disk usage monitor
# Outputs JSON for custom/disk-monitor module
# Class: "good" (<80%), "warning" (80-90%), "critical" (>90%)
set -euo pipefail
# Target partition (default: root)
TARGET="${1:-/}"
# Get disk usage percentage (strip % sign)
USAGE=$(df --output=pcent "$TARGET" | tail -1 | tr -d '% ')
# Determine icon and CSS class based on usage thresholds
if [ "$USAGE" -ge 90 ]; then
CLASS="critical"
TOOLTIP="Disk $TARGET at ${USAGE}% - CRITICAL"
elif [ "$USAGE" -ge 80 ]; then
CLASS="warning"
TOOLTIP="Disk $TARGET at ${USAGE}% - Warning"
else
CLASS="good"
TOOLTIP="Disk $TARGET at ${USAGE}%"
fi
# Output JSON for waybar
printf '{"text": " \uf4be %s%% ", "class": "%s", "alt": "%s", "tooltip": "%s"}\n' \
"$USAGE" "$CLASS" "disk-$CLASS" "$TOOLTIP"

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() {