No description
- Python 97.3%
- Shell 2.4%
- HTML 0.3%
Hermes Internal Tools
Monorepo for Hermes agent scripts and internal tools.
Structure
tools/ — Executable scripts (one per tool)
tests/ — Test suite with mocks for external APIs
data/mock/ — Cached API responses for offline testing
lib/ — Shared library code (if needed)
Tools
| Script | Purpose |
|---|---|
tools/package_tracker.py |
Multi-carrier package tracking (DPEX, AusPost, SPX) |
tools/moltbook-heartbeat.py |
Moltbook social agent heartbeat |
tools/github-issue-check.py |
GitHub issue/PR triage scanner |
tools/check-upstream-todos.py |
Check resolved upstream TODOs in nix-config |
tools/nix-breaking-changes.py |
NixOS/home-manager breaking change detector |
Development
# Run tests
python -m pytest tests/
# Run a specific test
python -m pytest tests/test_package_tracker.py -v
Conventions
- Commit messages follow Conventional Commits
- Tests use
pytestwith fixtures and cached mocks for external APIs - No hardcoded secrets — use
decrypt_secretfor reading,encrypt_secretfor creating - Key paths and openssl flags must never appear in any file committed here
- Scripts can be nested in subdirectories — the cron scheduler resolves paths relative to the scripts root
- State files live at
/data/.hermes/state/, never inside the repo