mirrors/hermes-agent
1
0
Fork 0
mirror of https://github.com/NousResearch/hermes-agent.git synced 2026-04-25 00:51:20 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
hermes-agent/optional-skills/email/mail-auto-draft/references/setup-commands.md
Josefo (jozrftamson) 38c052d2e0 docs(skills): polish mail auto-draft skill
2026-03-28 02:23:40 +01:00

2.4 KiB
Raw Blame History

Setup Commands

Concrete command sequence for setting up a local Himalaya-based mail auto-reply workflow.

1. Verify tools

himalaya --version
python3 --version
systemctl --user --version
python3 -c "import yaml, requests"

2. Create project directories

PROJECT_DIR="$HOME/Projekte/Automation/mail-auto-draft"
mkdir -p "$PROJECT_DIR"/{drafts,logs,data,runtime,prompts,deploy/systemd}

3. Create local secrets file

mkdir -p "$HOME/.config/mail-auto-draft"
chmod 700 "$HOME/.config/mail-auto-draft"
cat > "$HOME/.config/mail-auto-draft/secrets.env" <<'EOF'
GMAIL_APP_PASSWORD='YOUR_APP_PASSWORD'
EOF
chmod 600 "$HOME/.config/mail-auto-draft/secrets.env"

4. Configure Himalaya for Gmail

Example auth commands inside ~/.config/himalaya/config.toml:

backend.auth.cmd = "sh -lc '. $HOME/.config/mail-auto-draft/secrets.env && printf %s \"$GMAIL_APP_PASSWORD\"'"
message.send.backend.auth.cmd = "sh -lc '. $HOME/.config/mail-auto-draft/secrets.env && printf %s \"$GMAIL_APP_PASSWORD\"'"

5. Validate script syntax

cd "$PROJECT_DIR"
python3 -m py_compile process_inbox.py

6. Test in draft mode

cd "$PROJECT_DIR"
python3 process_inbox.py --mode draft --limit 5

Review:

  • drafts in drafts/
  • logs in logs/mail_actions.jsonl

7. Test in auto mode with one mail

cd "$PROJECT_DIR"
python3 process_inbox.py --mode auto --limit 1

8. Install systemd user units

PROJECT_DIR="$HOME/Projekte/Automation/mail-auto-draft"
mkdir -p "$HOME/.config/systemd/user"
sed "s|__PROJECT_DIR__|$PROJECT_DIR|g" "$PROJECT_DIR/deploy/systemd/mail-auto-draft.service" > "$HOME/.config/systemd/user/mail-auto-draft.service"
cp "$PROJECT_DIR/deploy/systemd/mail-auto-draft.timer" "$HOME/.config/systemd/user/mail-auto-draft.timer"
systemctl --user daemon-reload
systemctl --user enable --now mail-auto-draft.timer

9. Start and inspect background processing

systemctl --user start mail-auto-draft.service
systemctl --user status mail-auto-draft.timer --no-pager
systemctl --user status mail-auto-draft.service --no-pager
journalctl --user -u mail-auto-draft.service -n 50 --no-pager

10. Day-to-day commands

Manual run:

cd "$PROJECT_DIR"
python3 process_inbox.py --limit 1

Stop timer:

systemctl --user stop mail-auto-draft.timer

Restart timer:

systemctl --user restart mail-auto-draft.timer