{"id":34977426,"url":"https://github.com/onurhan1337/quzz-cli","last_synced_at":"2026-05-21T01:39:09.634Z","repository":{"id":321627567,"uuid":"1086065047","full_name":"onurhan1337/quzz-cli","owner":"onurhan1337","description":"Browse and analyze Quzz traces from your terminal. Filter by component, duration, and errors, and toggle a stats view.","archived":false,"fork":false,"pushed_at":"2025-10-30T16:07:58.000Z","size":55,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-30T18:07:47.405Z","etag":null,"topics":["bubbles","bubbletea","cobra","go","goreleaser"],"latest_commit_sha":null,"homepage":"","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/onurhan1337.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-29T22:35:19.000Z","updated_at":"2025-10-30T16:12:22.000Z","dependencies_parsed_at":"2025-10-30T18:08:03.701Z","dependency_job_id":"e1b43445-025f-4aae-aaae-54726db7f708","html_url":"https://github.com/onurhan1337/quzz-cli","commit_stats":null,"previous_names":["onurhan1337/quzz-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/onurhan1337/quzz-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onurhan1337%2Fquzz-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onurhan1337%2Fquzz-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onurhan1337%2Fquzz-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onurhan1337%2Fquzz-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/onurhan1337","download_url":"https://codeload.github.com/onurhan1337/quzz-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/onurhan1337%2Fquzz-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28066196,"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","status":"online","status_checked_at":"2025-12-26T02:00:06.189Z","response_time":55,"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":["bubbles","bubbletea","cobra","go","goreleaser"],"created_at":"2025-12-27T00:28:39.133Z","updated_at":"2025-12-27T00:28:39.812Z","avatar_url":"https://github.com/onurhan1337.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quzz CLI\n\nA powerful CLI for debugging React Server Components. Built with Go and Bubble Tea for a modern, interactive terminal experience.\n\n## Features\n\n- **Interactive TUI** - Full-screen terminal interface with smooth navigation\n- **Keyboard Shortcuts** - Vim-style (j/k) and arrow keys\n- **Smart Pagination** - Handles large trace files efficiently\n- **Rich Filtering** - By component, duration, date, errors, and more\n- **Statistics Dashboard** - Toggle detailed stats with Tab key\n- **Zero-Config** - Works out of the box\n\n## Installation\n\n### Option 1: Download Pre-built Binaries (Recommended)\n\nDownload the latest release for your platform from [GitHub Releases](https://github.com/onurhan1337/quzz-cli/releases).\n\n**macOS/Linux:**\n```bash\n# Download, extract, and install (replace VERSION and OS/ARCH as needed)\ncurl -LO https://github.com/onurhan1337/quzz-cli/releases/download/v1.0.0/quzz-cli_Darwin_x86_64.tar.gz\ntar -xzf quzz-cli_Darwin_x86_64.tar.gz\nsudo mv quzz /usr/local/bin/\nquzz --version\n```\n\n**Windows:**\n1. Download the `.zip` file from [Releases](https://github.com/onurhan1337/quzz-cli/releases)\n2. Extract `quzz.exe`\n3. Add to your PATH or move to a directory in your PATH\n\n### Option 2: Install with Go\n\n```bash\ngo install github.com/onurhan1337/quzz-cli@latest\n```\n\n**Note:** The binary will be named `quzz-cli` when using `go install`. Run commands as `quzz-cli` instead of `quzz`.\n\n## Quick Start\n\nInitialize configuration:\n```bash\nquzz init\n```\n\nVisualize traces:\n```bash\nquzz visualize traces.json\n```\n\n### Keyboard Shortcuts\n\n| Key | Action |\n|-----|--------|\n| Up / k | Scroll up |\n| Down / j | Scroll down |\n| PgUp / b | Page up |\n| PgDn / f | Page down |\n| Home / g | Jump to top |\n| End / G | Jump to bottom |\n| Tab | Toggle statistics |\n| ? | Show help |\n| q / Esc | Quit |\n\n## Commands\n\n### `quzz init`\n\nInteractive setup wizard for project configuration.\n\n```bash\nquzz init                 # Interactive mode\nquzz init --typescript    # Generate TypeScript config\nquzz init --skip-prompts  # Use defaults\n```\n\n### `quzz visualize [path]`\n\nView and analyze traces with interactive TUI.\n\n```bash\nquzz visualize traces.json\n```\n\n**Filtering:**\n```bash\nquzz visualize traces.json --component UserProfile\nquzz visualize traces.json --min-duration 100 --max-duration 500\nquzz visualize traces.json --errors\nquzz visualize traces.json --component-regex \"^(Blog|Product)\"\n```\n\n**Flags:**\n- `-c, --component` - Filter by component name\n- `-o, --operation` - Filter by operation\n- `-l, --level` - Filter by log level (error, warn, info, debug)\n- `--min-duration` - Minimum duration in ms\n- `--max-duration` - Maximum duration in ms\n- `--errors` - Show only errors\n- `--warnings` - Show only warnings\n- `--component-regex` - Filter by regex pattern\n- `--limit` - Limit number of traces (default: 50)\n- `-j, --json` - Output as JSON\n- `-s, --stats` - Show only statistics\n\n## Configuration\n\nGenerated config file (`quzz.config.js` or `quzz.config.ts`):\n\n```javascript\nmodule.exports = {\n  logLevel: \"info\",\n  outputFormat: \"pretty\",\n  performance: {\n    enabled: true,\n    warnThreshold: 500,\n  },\n  componentFilter: /^(Blog|Product)/,\n};\n```\n\n## Technologies\n\n- [Bubble Tea](https://github.com/charmbracelet/bubbletea) - TUI framework\n- [Bubbles](https://github.com/charmbracelet/bubbles) - TUI components\n- [Lipgloss](https://github.com/charmbracelet/lipgloss) - Terminal styling\n- [Cobra](https://github.com/spf13/cobra) - CLI framework\n\n## Development\n\n```bash\ngo build -o quzz\ngo test ./...\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Links\n\n- [Quzz npm package](https://github.com/onurhan1337/quzz)\n- [Report Issues](https://github.com/onurhan1337/quzz-cli/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonurhan1337%2Fquzz-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fonurhan1337%2Fquzz-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fonurhan1337%2Fquzz-cli/lists"}