{"data":{"slug":"control-theory-gonzo","name":"gonzo","tagline":"TUI log analysis tool in Go","github_url":"https://github.com/control-theory/gonzo","owner":"control-theory","repo":"gonzo","owner_avatar_url":"https://avatars.githubusercontent.com/u/157961368?v=4","primary_language":"Go","stars":2769,"forks":111,"topics":["ai","golang","logs","ollama","openai","opentelemetry","otel","otlp","terminal","tui"],"archived":false,"github_pushed_at":"2026-09-11T15:51:14+00:00","maintenance_label":"Active","stars_delta_30d":24,"url":"https://www.graphcanon.com/tools/control-theory-gonzo","markdown_url":"https://www.graphcanon.com/tools/control-theory-gonzo.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/control-theory-gonzo","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=control-theory-gonzo","description":"Gonzo! The Go based TUI log analysis tool","homepage_url":"https://www.controltheory.com/gonzo/","license":"MIT","open_issues":18,"watchers":12,"ai_summary":"Gonzo is a command-line utility for analyzing logs with support for AI-driven log analysis via Claude Code plugin and skill. It supports various installation methods including Go, Homebrew, Nix, and source builds.","readme_excerpt":"### Installation\n\n#### Using Go\n\n```bash\ngo install github.com/control-theory/gonzo/cmd/gonzo@latest\n```\n\n#### Using Homebrew (macOS/Linux)\n\n```bash\nbrew install gonzo\n```\n\n#### Download Binary\n\nDownload the latest release for your platform from the [releases page](https://github.com/control-theory/gonzo/releases).\n\n#### Using Nix package manager (beta support)\n\n```bash\nnix run github:control-theory/gonzo\n```\n\n#### Build from Source\n\n```bash\ngit clone https://github.com/control-theory/gonzo.git\ncd gonzo\nmake build\n```\n\n#### Using with Claude Code (plugin and skill)\n\nThis repo includes a Claude Code plugin with a guided log-analysis skill. Inside Claude Code:\n\n```\n/plugin marketplace add control-theory/gonzo\n/plugin install gonzo@gonzo\n```\n\nThen ask Claude to \"tail my logs\", \"watch my Vercel logs\", or \"analyze my Kubernetes logs\". The skill detects your deployment platform, installs Gonzo if needed, configures AI analysis, and generates the right pipe command with platform-specific normalizers. See `skills/gonzo/` for the skill content.\n\n---\n\n# Analyze Docker container logs\ndocker logs -f my-container 2>&1 | gonzo\n\n---\n\n# Run Claude in a container (Podman/Docker)\nexport GONZO_CLAUDE_PATH=\"podman exec -it claude-container claude\"\ngonzo --ai-provider=claude-code -f logs.json\n\nexport GONZO_CLAUDE_PATH=\"docker exec -it my-claude-container claude\"\ngonzo --ai-provider=claude-code --ai-model=haiku -f /var/log/app.log --follow\n```\n\n**Available Models:**\n- `sonnet` (default) - Claude Sonnet, balanced performance and capability\n- `haiku` - Fastest and most efficient, best for high-volume logs\n- `opus` - Most capable, best for complex analysis\n\n**Notes:**\n- Claude Code CLI manages authentication independently. The `OPENAI_API_KEY` environment variable is not needed.\n- Use `GONZO_CLAUDE_PATH` to specify a custom path or command (useful for running Claude in containers).\n\n#### LM Studio (Local AI)\n\n```bash\n\n---\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.","github_created_at":"2025-08-18T18:21:51+00:00","created_at":"2026-07-15T11:17:42.435334+00:00","updated_at":"2026-09-20T05:15:49.529464+00:00","categories":[{"slug":"evaluation-observability","name":"Evaluation & Observability","url":"https://www.graphcanon.com/categories/evaluation-observability","markdown_url":"https://www.graphcanon.com/categories/evaluation-observability.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/evaluation-observability"}],"tags":[{"slug":"ai","name":"ai"},{"slug":"golang","name":"golang"},{"slug":"logs","name":"logs"},{"slug":"openai","name":"openai"},{"slug":"opentelemetry","name":"opentelemetry"},{"slug":"terminal","name":"terminal"},{"slug":"tui","name":"tui"}],"trust":{"provenance":{"is_fork":false,"github_id":1040280323,"owner_type":"Organization","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T05:15:47.739Z","maintenance":{"label":"Active","score":82,"methodology":"github_public_v1","releases_90d":1,"days_since_push":8,"last_release_at":"2026-07-15T13:53:23Z","stars_delta_30d":24,"open_issues_delta_30d":0},"security_summary":{"status":"findings","scanner":"osv@v1","low_count":14,"high_count":0,"last_scan_at":"2026-07-15T11:17:43.701Z","medium_count":0,"scan_profile":"deps","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T05:15:48.771Z"},"languages":{"value":["go"],"source":"github.language","observed_at":"2026-09-20T05:15:48.771Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-09-20T05:15:48.771Z"}},"decision_facts":{"hosting":null,"pricing":{"model":"freemium","summary":"Free and open-source with MIT license, but AI service costs are dependent on third-party API usage, such as Claude Code."},"requirements":{"notes":["Environment variable GONZO_CLAUDE_PATH is needed if using Claude in containers.","Does not require OPENAI_API_KEY for authentication, depending on Claude Code CLI."],"min_ram_gb":1,"requires_docker":false},"constraints":{"min_ram_gb":1,"pricing_model":"freemium","requires_docker":false},"when_to_use":["When you need visual log analysis with terminal-based interface support and want to leverage AI for deeper insights using the Claude Code plugin.","If you are working in environments where manual setup of AI models is challenging, as Gonzo automates much of this process through its integration."],"when_not_to_use":["For tasks that require real-time interaction with AI models without the need for a TUI interface, as other tools might offer more direct or streamlined integrations.","If your primary requirement is to use specific AI providers like OpenAI directly without the abstraction layer Gonzo provides, then Gonzo may not fit well."],"source":"enrich:decision_facts","observed_at":"2026-07-17T12:32:57.649Z"},"constraint_facets":{"min_ram_gb":1,"pricing_model":"freemium","requires_docker":false},"decision_summary":[{"label":"Pricing","value":"freemium - Free and open-source with MIT license, but AI service costs are dependent on third-party API usage, such as Claude Code."},{"label":"Requirements","value":"Min 1 GB RAM; Environment variable GONZO_CLAUDE_PATH is needed if using Claude in containers.; Does not require OPENAI_API_KEY for authentication, depending on Claude Code CLI."},{"label":"Adopt for","value":"A TUI log analysis tool with AI-driven capabilities via Claude Code plugin."}]}}