{"id":27214650,"url":"https://github.com/rae-api-com/rae-tui","last_synced_at":"2026-05-01T19:34:26.686Z","repository":{"id":285128971,"uuid":"957101173","full_name":"rae-api-com/rae-tui","owner":"rae-api-com","description":"Command utility to interact with rae-api.com API from the terminal","archived":false,"fork":false,"pushed_at":"2025-11-02T16:16:15.000Z","size":3873,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-02T18:11:59.598Z","etag":null,"topics":["rae","terminal","tui"],"latest_commit_sha":null,"homepage":"https://rae-api.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rae-api-com.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-29T15:02:19.000Z","updated_at":"2025-11-02T16:16:19.000Z","dependencies_parsed_at":"2025-09-02T13:11:07.567Z","dependency_job_id":"c788d943-d9bf-4301-b955-e2eca3eff843","html_url":"https://github.com/rae-api-com/rae-tui","commit_stats":null,"previous_names":["rae-api-com/rae-tui"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/rae-api-com/rae-tui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rae-api-com%2Frae-tui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rae-api-com%2Frae-tui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rae-api-com%2Frae-tui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rae-api-com%2Frae-tui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rae-api-com","download_url":"https://codeload.github.com/rae-api-com/rae-tui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rae-api-com%2Frae-tui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32510808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rae","terminal","tui"],"created_at":"2025-04-10T03:38:20.268Z","updated_at":"2026-05-01T19:34:26.672Z","avatar_url":"https://github.com/rae-api-com.png","language":"Go","funding_links":[],"categories":["Lengua Española y Diccionarios"],"sub_categories":["Wallapop"],"readme":"# RAE-TUI\n\n[![Go Version](https://img.shields.io/github/go-mod/go-version/rae-api-com/rae-tui)](https://golang.org/)\n[![Go Report Card](https://goreportcard.com/badge/github.com/rae-api-com/rae-tui)](https://goreportcard.com/report/github.com/rae-api-com/rae-tui)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Release](https://img.shields.io/github/v/release/rae-api-com/rae-tui)](https://github.com/rae-api-com/rae-tui/releases)\n[![Build Status](https://github.com/rae-api-com/rae-tui/workflows/CI/badge.svg)](https://github.com/rae-api-com/rae-tui/actions)\n\nCliente de diccionario español para la terminal, conectado a la Real Academia Española (RAE).\n\n![RAE-TUI Demo](demo.gif)\n\n## Características\n\n- **Búsqueda instantánea** - Consulta palabras directamente desde tu terminal\n- **Definiciones completas** - Visualiza significados detallados y acepciones múltiples\n- **Búsqueda difusa** - Cuando no se encuentra una palabra exacta, busca automáticamente términos similares con resultados relevantes\n- **Interfaz interactiva** - TUI moderna con navegación por teclado intuitiva\n- **Conjugaciones verbales** - Muestra todas las conjugaciones en todos los tiempos\n- **Modo CLI** - Consultas no-interactivas para uso en scripts\n- **Sin configuración** - Funciona inmediatamente sin API keys\n\n## Instalación\n\n### Instalación rápida\n\n```bash\ngo install github.com/rae-api-com/rae-tui@latest\n```\n\n### Binarios precompilados\n\nDescarga el binario apropiado para tu plataforma desde la página de [Releases](https://github.com/rae-api-com/rae-tui/releases).\n\n#### Linux/macOS\n\n```bash\ncurl -sf https://gobinaries.com/rae-api-com/rae-tui | sh\n```\n\n### Desde código fuente\n\n```bash\ngit clone https://github.com/rae-api-com/rae-tui.git\ncd rae-tui\ngo build -o rae-tui\n```\n\n## Uso\n\n### Modo interactivo (TUI)\n\nLanza la interfaz interactiva completa:\n\n```bash\nrae-tui\n# o explícitamente\nrae-tui tui\n```\n\nBúsqueda directa con una palabra:\n\n```bash\nrae-tui tui hola\n```\n\n### Modo CLI\n\nConsulta directa para scripts o uso rápido:\n\n```bash\nrae-tui palabra\n# Ejemplo:\nrae-tui computadora\n```\n\n#### Búsqueda difusa automática\n\nCuando una palabra no se encuentra en el diccionario y no hay sugerencias disponibles, el CLI automáticamente ejecuta una búsqueda difusa para encontrar palabras similares. Puedes seleccionar una de las opciones encontradas:\n\n```bash\nrae-tui \"persona que programa\"\n```\n\nSi no hay resultados exactos, se mostrará una lista de palabras similares con una vista previa de sus definiciones:\n\n```\nNo se encontró la palabra y no hay sugerencias disponibles para: persona que programa\nBuscando resultados difusos...\n\nBúsqueda difusa - Resultados encontrados:\n  1. programador - 1. adj. Que programa. U. t. c. s.\n  2. programadora - 1. adj. Que programa. U. t. c. s.\n  3. programadores - 1. adj. Que programa. U. t. c. s.\n  4. coguionista - 1. m. y f. Persona que escribe junto con otra u otras el gui...\n\nSelecciona una palabra (1-4) o 0 para cancelar:\n```\n\n### Ejemplos prácticos\n\n```bash\n# Buscar un verbo y ver conjugaciones\nrae-tui tui comer\n\n# Consulta rápida en scripts\nif rae-tui existir \u003e /dev/null; then\n    echo \"La palabra existe en el diccionario\"\nfi\n\n# Integración con otros comandos\necho \"palabras\\nque\\nbuscar\" | xargs -I {} rae-tui {}\n```\n\n### Atajos de teclado (Modo TUI)\n\n| Tecla          | Acción                         |\n| -------------- | ------------------------------ |\n| `↑` / `k`      | Mover selección hacia arriba    |\n| `↓` / `j`      | Mover selección hacia abajo     |\n| `n` / `Ctrl+N` | Buscar nueva palabra            |\n| `q` / `ESC`    | Salir o volver atrás            |\n| `Enter`        | Seleccionar elemento            |\n| `Tab`          | Cambiar entre paneles           |\n| `?` / `h`      | Mostrar ayuda                   |\n| `Ctrl+C`       | Salir inmediatamente            |\n\n## Desarrollo\n\n### Configuración del entorno\n\n```bash\n# Clonar el repositorio\ngit clone https://github.com/rae-api-com/rae-tui.git\ncd rae-tui\n\n# Instalar dependencias\ngo mod download\n\n# Ejecutar en modo desarrollo\ngo run . tui\n```\n\n### Testing\n\n```bash\n# Ejecutar tests\nmake test\n\n# Tests con coverage\nmake test-coverage\n\n# Ejecutar todos los checks\nmake ci\n```\n\n### Build\n\n```bash\n# Build local\nmake build\n\n# Build para múltiples plataformas\nmake build-all\n\n# Build con información de versión\nmake build VERSION=v1.0.0\n```\n\n## Contribuir\n\nLas contribuciones son bienvenidas. \n\n1. Haz fork del proyecto\n2. Crea tu rama de feature (`git checkout -b feature/AmazingFeature`)\n3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`)\n4. Push a la rama (`git push origin feature/AmazingFeature`)\n5. Abre un Pull Request\n\n### Ideas para contribuir\n\n- Mejoras en la UI/UX\n- Nuevas funcionalidades de búsqueda\n- Soporte para más idiomas\n- Integración con otras APIs\n- Corrección de bugs\n- Mejoras en documentación\n\n## Roadmap\n\n- [ ] Tema oscuro/claro automático\n- [ ] Sistema de cache local\n- [ ] Historial de búsquedas\n- [ ] Sistema de favoritos\n- [ ] Pronunciación de palabras\n\n## Licencia\n\nEste proyecto está bajo la [Licencia MIT](LICENSE).\n\n## Reconocimientos\n\n- **[go-rae](https://github.com/rae-api-com/go-rae)** - Cliente Go para la API de la RAE\n- **[tview](https://github.com/rivo/tview)** - Biblioteca para interfaces de terminal\n- **[Real Academia Española](https://www.rae.es/)** - Por mantener el diccionario más completo del español\n\n## Soporte\n\n¿Tienes algún problema o sugerencia?\n\n- [Reportar un bug](https://github.com/rae-api-com/rae-tui/issues/new?template=bug_report.md)\n- [Solicitar una funcionalidad](https://github.com/rae-api-com/rae-tui/issues/new?template=feature_request.md)\n- [Iniciar una discusión](https://github.com/rae-api-com/rae-tui/discussions)\n- [Documentación completa](https://pkg.go.dev/github.com/rae-api-com/rae-tui)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nHecho con ❤️ para los amantes del español y la terminal\n\n[⭐ Dale una estrella si te gusta el proyecto](https://github.com/rae-api-com/rae-tui/stargazers) • [🐛 Reportar un problema](https://github.com/rae-api-com/rae-tui/issues) • [💬 Unirse a la discusión](https://github.com/rae-api-com/rae-tui/discussions)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frae-api-com%2Frae-tui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frae-api-com%2Frae-tui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frae-api-com%2Frae-tui/lists"}