Hermes - TecsaS3 CLI

¿Qué es hermes?

Hermes es un coding agent open-source diseñado para entornos donde la portabilidad y la ausencia de dependencias externas son críticas. Reconoce skills vía la convención 2026-spec y las busca en ~/.hermes/skills/. Su runtime es una sola biblioteca Python, lo que lo hace ideal para CI, contenedores efímeros y workstations aisladas. La skill de tecsas3-cli dota a Hermes de un plano de control determinista para interactuar con el Ecosistema Salud TecsaS3: en lugar de improvisar llamadas HTTP, el agente delega en la CLI y mantiene la invariante de redacción PHI y multi-tenant por construcción.

Instalación de la skill

Automática (recomendada)
Manual
Target personalizado

python -m tecsas3_cli install-skill --agent hermes

Esto copia la skill a ~/.hermes/skills/tecsas3-cli/SKILL.md con frontmatter YAML.

mkdir -p ~/.hermes/skills/tecsas3-cli
curl -o ~/.hermes/skills/tecsas3-cli/SKILL.md \
  https://raw.githubusercontent.com/tecsas3/saludrural/main/docs/skills/tecsas3-cli/SKILL.md

python -m tecsas3_cli install-skill --agent hermes --target /ruta/personalizada/SKILL.md

Verificación

Versión del CLI

python -m tecsas3_cli --version

Debe retornar 0.4.1.

Autodescubrimiento

python -m tecsas3_cli --json --no-input util agent-info | jq '.cli.version'

Smoke test

python -m tecsas3_cli install-skill list | grep hermes

Debe listar las rutas candidatas.

Ejemplo de uso

Prompt que el usuario puede darle al agente:

Lista los 5 primeros pacientes del tenant demo usando tecsas3-cli.
Usa --json --no-input y dame el output como tabla.

El agente ejecutará:

python -m tecsas3_cli --json --no-input paciente list --page-size 5

Troubleshooting

Permisos: si el directorio de skills de hermes está Owned por otro usuario, ejecuta con sudo o cambia el --target a un directorio escribible.

Sin keyring: el CLI cae automáticamente al archivo ~/.tecsas3/credentials con permisos 0600.

HTTPS obligatorio: load_settings(base_url='http://...') lanza ConfigError. Usa siempre https://.

Rutas candidatas

| Agente | Ruta(s) | Probado en este host | |---|---| pendiente |

​¿Qué es hermes?

​Instalación de la skill

​Verificación

​Ejemplo de uso

​Troubleshooting

​Rutas candidatas

¿Qué es hermes?

Instalación de la skill

Verificación

Ejemplo de uso

Troubleshooting

Rutas candidatas