gitea-cli
Herramienta CLI en Go para gestionar servidores Gitea auto-alojados, diseñada para agentes de IA. Usa SDK oficial de Gitea, autenticación vía HTTP Basic Auth con tokens en keyring de git (libsecret/osxkeychain), y salida JSON estructurada (--json). Soporta CRUD completo: repositorios, issues, PRs, u
Ficha actualizada 27 sept 2026, 20:44 · upstream 27 sept 2026, 20:34 · release v0.1.0
Qué es gitea-cli
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
gitea-cli es una herramienta de línea de comandos escrita en Go para operar servidores Gitea auto-alojados, construida específicamente para agentes de IA como Claude Code, pi o Cursor. Utiliza la SDK oficial de Gitea (https://code.gitea.io/sdk/gitea) y cobra como framework CLI. La autenticación se realiza mediante HTTP Basic Auth: el nombre de usuario es el identificador del servidor y el token de acceso actúa como contraseña. Los tokens no se almacenan en archivos de configuración por defecto, sino en el keyring nativo de git (libsecret en Linux, osxkeychain en macOS, pass o store según la configuración), siguiendo las convenciones de seguridad de git.
La herramienta ofrece operaciones CRUD completas: gestión de repositorios (listar, crear, eliminar, marcar como favorito, observar), issues (crear, cerrar, reabrir, comentar), pull requests, usuarios, organizaciones y sus miembros, equipos dentro de organizaciones, releases y webhooks. La configuración separa la información del servidor (URL, nombre de usuario) en un archivo YAML (~/.gitea-cli/config.yaml) y el token en el keyring, aunque permite opcionalmente almacenar el token en el archivo si se prefiere.
Está optimizada para agentes de IA: incluye una bandera global --json para salida estructurada (incluyendo errores), detecta entornos no interactivos y rechaza operaciones destructivas sin --yes para evitar bloqueos. Soporta inicialización no interactiva vía stdin (--token-stdin) o variables de entorno (GITEA_URL, GITEA_USERNAME, GITEA_TOKEN). Las versiones se gestionan mediante GitHub Actions + GoReleaser, generando binarios multiplataforma (Linux/macOS/Windows/FreeBSD/OpenBSD × amd64/arm64/arm) con checksums y archivos fuente.
- Automatización de tareas repetitivas en Gitea: crear repositorios, issues o releases mediante scripts sin intervención manual.
- Integración con agentes de IA para gestión de código: los agentes pueden listar repositorios, revisar issues pendientes o crear PRs automáticamente.
- Gestión de webhooks programáticos: configurar notificaciones a servicios externos (Slack, Discord) desde la CLI.
- Auditoría y mantenimiento: listar usuarios, organizaciones o equipos y limpiar recursos obsoletos con confirmación automática (--yes).
- Despliegue en entornos headless (servidores sin terminal interactivo): inicialización vía stdin o variables de entorno para agentes de IA.
- Autenticación segura mediante keyring de git (libsecret/osxkeychain), nunca en archivos de configuración por defecto.
- Salida JSON estructurada (--json) y detección automática de entornos no interactivos para evitar bloqueos.
- Operaciones destructivas requieren --yes en entornos no interactivos, previniendo errores por falta de confirmación.
- Binarios precompilados multiplataforma (Linux/macOS/Windows/FreeBSD/OpenBSD × amd64/arm64/arm) vía GitHub Actions + GoReleaser.
- Separación clara entre configuración del servidor (URL, usuario) y credenciales (token en keyring).
- Compatibilidad con WAFs que bloquean Authorization: token header al usar HTTP Basic Auth.
- Dependencia de la SDK oficial de Gitea v1.x; cambios en la API pueden requerir actualizaciones del código.
- Requiere autenticación explícita (token) para todas las operaciones; sin token, el acceso falla.
- Algunas operaciones destructivas (eliminar repositorios, issues, releases) requieren confirmación (--yes) o interacción manual.
- No soporta Docker ni Kubernetes nativamente; debe integrarse manualmente en orquestadores externos.
- La inicialización interactiva no es viable para agentes de IA sin terminal; requiere stdin o variables de entorno.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Recomendaciones: 1) Usar --json siempre para parsing programático. 2) Inicializar con gitea-cli config init --token-stdin en entornos headless. 3) Para operaciones destructivas, incluir --yes en scripts automatizados. 4) Verificar que el keyring de git esté configurado (git config credential.helper). 5) En WAFs, preferir HTTP Basic Auth sobre Authorization: token header. 6) Actualizar la herramienta tras cambios en la SDK oficial de Gitea.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.