¿Qué hace hypershell-reach?
Homelab Agent Tooling & Skills (HATS): gestión de herramientas de agente, ejecución remota acotada, continuidad de tareas y descubrimiento compartido de habilidades.
Descripción general
Este skill proporciona un conjunto de herramientas y capacidades para agentes de IA en entornos homelab, permitiendo:
- Gestión de herramientas de agente: Instalación, configuración y actualización de herramientas para agentes.
- Ejecución remota acotada: Ejecución segura de comandos y scripts en máquinas remotas con límites de recursos.
- Continuidad de tareas: Mantenimiento del estado entre ejecuciones para tareas largas o complejas.
- Descubrimiento compartido de habilidades: Repositorio de habilidades reutilizables definidas por la comunidad.
Plataformas compatibles
- Claude Code
- Cursor
- Codex
- Otros agentes que soporten SKILL.md
Instalación
Para instalar este skill, clona el repositorio en tu directorio de skills:
git clone https://github.com/X1pheR/hypershell-reach.git ~/.config/skills/hypershell-reach
Luego, agrega la ruta a tu configuración de agente:
{
"skills": [
{
"name": "hypershell-reach",
"path": "~/.config/skills/hypershell-reach"
}
]
}
Uso
Ejecución remota acotada
hypershell run --host <host> --command "<comando>"
Ejemplo:
hypershell run --host node1 --command "ls -la /var/log"
Continuidad de tareas
hypershell resume --task-id <id>
Descubrimiento de habilidades
hypershell search --keyword "monitoreo"
Configuración
Las variables de entorno se pueden configurar en un archivo .env:
HYPERSHELL_HOST=localhost
HYPERSHELL_PORT=22
HYPERSHELL_USER=agent
SSH_KEY_PATH=~/.ssh/id_rsa
Contribución
Las contribuciones son bienvenidas. Por favor, consulta CONTRIBUTING.md para más detalles.
Licencia
Este proyecto está bajo la licencia MIT. Ver LICENSE para más información.