OpenCode - TecsaS3 CLI

¿Qué es opencode?

OpenCode es un coding agent open-source inspirado en Claude Code pero con un runtime portable, sin telemetría obligatoria y licencia permisiva. Carga skills desde dos rutas canónicas: ~/.config/opencode/skills/ (global por usuario) y .opencode/skills/ (local al repositorio), con la segunda prevaleciendo sobre la primera. La skill de tecsas3-cli se instala en la ruta global por defecto, pero soporta el flag --project para escribirla en .opencode/skills/ y versionarla junto al repositorio. Esto último es útil en monorepos donde múltiples agentes deben compartir la misma skill congelada.

Instalación de la skill

Automática (recomendada)
Manual
Target personalizado

python -m tecsas3_cli install-skill --agent opencode

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

mkdir -p ~/.config/opencode/skills/tecsas3-cli
curl -o ~/.config/opencode/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 opencode --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 opencode

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 opencode 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 opencode?

​Instalación de la skill

​Verificación

​Ejemplo de uso

​Troubleshooting

​Rutas candidatas

¿Qué es opencode?

Instalación de la skill

Verificación

Ejemplo de uso

Troubleshooting

Rutas candidatas