Codex - TecsaS3 CLI

¿Qué es codex?

Codex CLI es el agente oficial de OpenAI para terminal, alimentado por la familia de modelos Codex y GPT-5. Carga skills en ~/.codex/skills/ y las trata como tools declarativos invocables desde el prompt. Su runtime local puede ejecutarse en modo --approval-mode full-auto para agentes desatendidos, o con aprobación por comando para uso interactivo. La skill de tecsas3-cli se integra como tool determinista: el agente Codex delega las llamadas al CLI en lugar de improvisar peticiones HTTP, manteniendo la invariante de redacción PHI y multi-tenant. Esto es crítico en escenarios donde Codex se ejecuta en pipelines CI contra entornos de staging.

Instalación de la skill

Automática (recomendada)
Manual
Target personalizado

python -m tecsas3_cli install-skill --agent codex

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

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

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

​Instalación de la skill

​Verificación

​Ejemplo de uso

​Troubleshooting

​Rutas candidatas

¿Qué es codex?

Instalación de la skill

Verificación

Ejemplo de uso

Troubleshooting

Rutas candidatas