{"id":25083694,"url":"https://github.com/appthrust/kutelog","last_synced_at":"2025-04-01T11:35:02.908Z","repository":{"id":275943170,"uuid":"927688335","full_name":"appthrust/kutelog","owner":"appthrust","description":"Browser Console-based log viewer for Kubebuilder controllers with structured JSON support and real-time updates","archived":false,"fork":false,"pushed_at":"2025-02-06T01:57:10.000Z","size":663,"stargazers_count":7,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T11:45:45.703Z","etag":null,"topics":["cli","console","developer-tools","go","json","kubebuilder","kubernetes","logging","websocket"],"latest_commit_sha":null,"homepage":null,"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/appthrust.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2025-02-05T11:29:04.000Z","updated_at":"2025-02-10T12:58:10.000Z","dependencies_parsed_at":"2025-02-05T12:36:07.702Z","dependency_job_id":"eaf08797-c102-4d7f-a5b2-98b329b0cf00","html_url":"https://github.com/appthrust/kutelog","commit_stats":null,"previous_names":["appthrust/kutelog"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appthrust%2Fkutelog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appthrust%2Fkutelog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appthrust%2Fkutelog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/appthrust%2Fkutelog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/appthrust","download_url":"https://codeload.github.com/appthrust/kutelog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246634539,"owners_count":20809264,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["cli","console","developer-tools","go","json","kubebuilder","kubernetes","logging","websocket"],"created_at":"2025-02-07T06:28:58.603Z","updated_at":"2025-04-01T11:35:02.873Z","avatar_url":"https://github.com/appthrust.png","language":"Go","readme":"# 🌸 AppThrust Kutelog\n\n[![GitHub Release](https://img.shields.io/github/v/release/appthrust/kutelog)](https://github.com/appthrust/kutelog/releases/latest)\n[![Go Report Card](https://goreportcard.com/badge/github.com/appthrust/kutelog)](https://goreportcard.com/report/github.com/appthrust/kutelog)\n[![GitHub License](https://img.shields.io/github/license/appthrust/kutelog)](https://github.com/appthrust/kutelog/blob/main/LICENSE)\n[![Go Version](https://img.shields.io/github/go-mod/go-version/appthrust/kutelog)](https://github.com/appthrust/kutelog)\n[![Build Status](https://github.com/appthrust/kutelog/actions/workflows/ci.yml/badge.svg\n)](https://github.com/appthrust/kutelog/actions)\n\nKutelog is a development tool that leverages your browser's Console to make structured logs from Kubebuilder controllers easy to read in real-time. By utilizing the Console's powerful features, it helps developers see and analyze what their controllers are doing while they work on them.\n\nWorks with Chrome, Firefox, Safari, and Edge.\n\n![Kutelog Screenshot](screenshots/image.png)\n\n## 📦 Installation\n\n### Using Homebrew\n\n```bash\nbrew tap appthrust/tap\nbrew install kutelog\n```\n\n### Manual Installation\n\nDownload the latest binary from [GitHub Releases](https://github.com/appthrust/kutelog/releases).\n\n## 🚀 Usage\n\n### With Kubebuilder Controllers\n```bash\nmake run 2\u003e\u00261 | kutelog\n```\n\n### With Kubernetes Logs\n```bash\nkubectl logs -f deployment/myapp | kutelog\n```\n\n## 🤔 Why Browser Console?\n\nTraditional CLI tools are great, but Browser Console offers unique advantages for structured logs:\n\n- **JSON Handling**\n  - CLI: Long, hard-to-read single-line JSON strings\n  - Console: Interactive object explorer with expand/collapse functionality\n  - Easily navigate through nested data structures\n\n- **Filtering Capabilities**\n  - CLI: Limited to grep-like text filtering\n  - Console: Rich filtering options using built-in Console filters\n  - Quickly switch between log levels (error, warn, info)\n\n- **Search Experience**\n  - CLI: Basic text search\n  - Console: Advanced search with pattern matching\n  - Search within specific log fields\n\n## 💡 Console Tips\n\n- **Log Level Filtering**\n  - Use `error` to show only error logs\n  - Use `warn` to show warnings and errors\n  - Use `info` to show info, warnings, and errors\n  - Click the level icons in the Console toolbar for quick filtering\n\n- **Search Techniques**\n  - Use `/pattern/` for regex search\n  - Use `-word` to exclude entries containing \"word\"\n\n- **Object Navigation**\n  - Click the ▶ arrow to expand objects\n  - Right-click properties for copy options\n\n- **Console Management**\n  - Click clear button (⊘ in Chrome/Edge, 🗑️ in Firefox/Safari) or press Cmd+K (macOS) / Ctrl+L (Windows/Linux) to clear console\n  - Type `////////////////////////////////////` to add a visual separator\n\n## ✨ Features\n\n- 🔍 **Browser Console Benefits**\n  - Interactive exploration of structured JSON data\n  - Expand/collapse nested objects with ease\n  - No more dealing with single-line JSON strings\n\n- 🎯 **Powerful Filtering**\n  - Filter by log levels using Console filters (error, warn, info)\n  - Advanced text search capabilities\n  - Focus on what matters to you\n\n- 🔄 **Real-time Updates**\n  - WebSocket-based live streaming\n  - Automatic reconnection if connection is lost\n\n## 🛠️ How to Use\n\n1. Start Kutelog with your log stream\n2. Open `http://localhost:9106` in your browser\n3. Open DevTools Console (F12 or Cmd+Option+J)\n4. Use Console filters to focus on specific log levels\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappthrust%2Fkutelog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fappthrust%2Fkutelog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fappthrust%2Fkutelog/lists"}