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 19 additions and 182 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
CONFIG_DIRS := btop doom hypr kitty local nvim rclone starship tmux wallpapers waybar wireplumber wofi yazi zsh
# Local stow package directory (installed to ~/.local)
STOW_LOCAL_DIR := local
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
neofetch
.PHONY: all stow_all stow_local stow_rclone post_install_rclone clean
# Main target to handle stowing for all directories except rclone
stow_all: $(filter-out rclone, $(CONFIG_DIRS))
@echo "Cleaning broken symlinks in ~/.config..."
@@ -26,13 +21,6 @@ stow_%:
@echo "Stowing $*"
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_install_rclone:
@echo "Running post-installation script for rclone"
@@ -47,11 +35,3 @@ stow_rclone:
@echo "Stowing rclone"
stow -v -t $(HOME) 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
(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
@@ -496,19 +494,6 @@ change ~org-directory~. It must be set before org loads!
((org-agenda-tag-filter-preset '("+BA_ON_SITE")))
)
("wA" "Projet Airbus Vision"
((agenda ""
((org-agenda-span 150)
(org-agenda-start-day "2026-05-01")
(org-agenda-overriding-header "📅 Projet Airbus Vision")
(org-agenda-prefix-format " %12t") ;; reserve time space
(org-agenda-todo-keyword-format " %-5s") ;; fixed-width TODO
(org-agenda-tags-column -100) ;; right-align tags
(org-agenda-time-grid nil)
)))
((org-agenda-tag-filter-preset '("+airbus")))
)
)
)
)
@@ -1845,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
@@ -367,19 +365,6 @@
((org-agenda-tag-filter-preset '("+BA_ON_SITE")))
)
("wA" "Projet Airbus Vision"
((agenda ""
((org-agenda-span 150)
(org-agenda-start-day "2026-05-01")
(org-agenda-overriding-header "📅 Projet Airbus Vision")
(org-agenda-prefix-format " %12t") ;; reserve time space
(org-agenda-todo-keyword-format " %-5s") ;; fixed-width TODO
(org-agenda-tags-column -100) ;; right-align tags
(org-agenda-time-grid nil)
)))
((org-agenda-tag-filter-preset '("+airbus")))
)
)
)
)
@@ -1068,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

9
hypr/.config/hypr/hyprland.conf Executable file → Normal file
View File

@@ -8,7 +8,6 @@
# You can split this configuration into multiple files
# Create your files separately and then link them to this file like this:
# source = ~/.config/hypr/myColors.conf
source = mocha.conf
source = ~/.cache/wal/colors-hyprland.conf
################
@@ -148,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
@@ -221,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

8
hypr/.config/hypr/mocha.conf Executable file → Normal file
View File

@@ -76,11 +76,3 @@ $mantleAlpha = 181825
$crust = rgb(11111b)
$crustAlpha = 11111b
# Fallback colors for when pywal hasn't generated colors-hyprland.conf
# (sourced by hyprland.conf — $color1/$color2 for active border gradients,
# $background for inactive border and general bg usage)
$color1 = rgb(cba6f7)
$color2 = rgb(f5c2e7)
$color3 = rgb(89b4fa)
$background = rgb(1e1e2e)

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

@@ -1,16 +0,0 @@
#!/bin/bash
scrot-ocr: Select screen region → OCR → clipboard
Deps: grim, slurp, tesseract, wl-clipboard, libnotify
set -euo pipefail
LANG="${1:-eng}"
IMG="/tmp/scrot-ocr-$(date +%s).png"
grim -g "$(slurp -d)" "$IMG"
TEXT=$(tesseract "$IMG" stdout -l "$LANG" 2>/dev/null | sed '/^[[:space:]]*$/d')
echo -n "$TEXT" | wl-copy --paste-once
echo "$TEXT"
notify-send "scrot-ocr" "$(echo "$TEXT" | wc -l) lines copied to clipboard" -t 3000
rm -f "$IMG"

View File

@@ -1,5 +1,6 @@
# A TOML linter such as https://taplo.tamasfe.dev/ can use this schema to validate your config.
# If you encounter any issues, please make an issue at https://github.com/yazi-rs/schemas.
"$schema" = "https://yazi-rs.github.io/schemas/yazi.json"
[mgr]
ratio = [ 1, 4, 3 ]

View File

@@ -19,43 +19,6 @@ alias emacs="emacsclient -c -a emacs"
# Opencode
alias oc="opencode"
# Hermes Agent - SSH directly to remote server
hermes() {
if [[ -n "$1" ]]; then
ssh -t lazyworkhorse \
"docker exec -e HERMES_HONCHO_PEER_NAME=$1 -it hermes \
/opt/hermes/.venv/bin/hermes --profile $1"
else
ssh -t lazyworkhorse \
"docker exec -e HERMES_HONCHO_PEER_NAME=thierry -it hermes \
/opt/hermes/.venv/bin/hermes"
fi
}
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() {