{"id":48348406,"url":"https://github.com/quality-max/qmax-code-releases","last_synced_at":"2026-06-04T21:00:51.195Z","repository":{"id":347615268,"uuid":"1194658880","full_name":"Quality-Max/qmax-code-releases","owner":"Quality-Max","description":"qmax-code — AI testing agent for your terminal. 50 tools, self-healing scripts, cloud execution.","archived":false,"fork":false,"pushed_at":"2026-06-02T11:55:39.000Z","size":1149519,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T13:14:40.106Z","etag":null,"topics":["ai","cli","k6","playwright","qa","self-healing","terminal","test-automation","testing"],"latest_commit_sha":null,"homepage":"https://qualitymax.io/qmax-code","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Quality-Max.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"custom":["https://buymeacoffee.com/qualitymax"]}},"created_at":"2026-03-28T16:43:21.000Z","updated_at":"2026-06-02T11:55:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Quality-Max/qmax-code-releases","commit_stats":null,"previous_names":["quality-max/qmax-code-releases"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/Quality-Max/qmax-code-releases","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quality-Max%2Fqmax-code-releases","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quality-Max%2Fqmax-code-releases/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quality-Max%2Fqmax-code-releases/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quality-Max%2Fqmax-code-releases/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Quality-Max","download_url":"https://codeload.github.com/Quality-Max/qmax-code-releases/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Quality-Max%2Fqmax-code-releases/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33917202,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","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":["ai","cli","k6","playwright","qa","self-healing","terminal","test-automation","testing"],"created_at":"2026-04-05T08:03:52.543Z","updated_at":"2026-06-04T21:00:51.185Z","avatar_url":"https://github.com/Quality-Max.png","language":"Shell","funding_links":["https://buymeacoffee.com/qualitymax"],"categories":[],"sub_categories":[],"readme":"```\n                                    ╱|、\n                                   (˚ˎ 。7\n                                    |、˜〵\n                                    じしˍ,)ノ\n\n             ██████╗ ███╗   ███╗ █████╗ ██╗  ██╗\n            ██╔═══██╗████╗ ████║██╔══██╗╚██╗██╔╝\n            ██║   ██║██╔████╔██║███████║ ╚███╔╝\n            ██║▄▄ ██║██║╚██╔╝██║██╔══██║ ██╔██╗\n            ╚██████╔╝██║ ╚═╝ ██║██║  ██║██╔╝ ██╗\n             ╚══▀▀═╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝\n                             c o d e\n```\n\n# qmax-code\n\n[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-support-yellow?logo=buymeacoffee)](https://buymeacoffee.com/qualitymax)\n\n**AI-powered terminal agent for QualityMax.** Named after Max, the real cat who inspired it all.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/max-the-cat.gif\" alt=\"Max the cat\" width=\"300\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eNamed after Max, the real cat who inspired it all.\u003c/em\u003e\n\u003c/p\u003e\n\n**The first AI testing agent built for your terminal.**\n\n48 MCP tools, natural language interface, self-healing scripts, cloud execution, k6 load testing — all from the command line. Nothing else does this.\n\n[Product Page](https://qualitymax.io/qmax-code) · [QualityMax Platform](https://app.qualitymax.io) · [Source Code](https://github.com/Quality-Max/qmax-code) · [Releases](https://github.com/Quality-Max/qmax-code-releases/releases)\n\n\u003e **This is the releases repository** — binary downloads and install scripts only.\n\u003e The source code lives at [Quality-Max/qmax-code](https://github.com/Quality-Max/qmax-code).\n\n---\n\n## Install\n\n**One command:**\n\n```bash\ncurl -sL https://qualitymax.io/static/install-qmax-code.txt | bash\n```\n\n**Or download a binary:**\n\n| Platform | Download |\n|----------|----------|\n| macOS Apple Silicon | [qmax-code-darwin-arm64.tar.gz](https://github.com/Quality-Max/qmax-code-releases/releases/latest/download/qmax-code-darwin-arm64.tar.gz) |\n| macOS Intel | [qmax-code-darwin-amd64.tar.gz](https://github.com/Quality-Max/qmax-code-releases/releases/latest/download/qmax-code-darwin-amd64.tar.gz) |\n| Linux x64 | [qmax-code-linux-amd64.tar.gz](https://github.com/Quality-Max/qmax-code-releases/releases/latest/download/qmax-code-linux-amd64.tar.gz) |\n| Linux ARM | [qmax-code-linux-arm64.tar.gz](https://github.com/Quality-Max/qmax-code-releases/releases/latest/download/qmax-code-linux-arm64.tar.gz) |\n| Windows x64 | [qmax-code-windows-amd64.zip](https://github.com/Quality-Max/qmax-code-releases/releases/latest/download/qmax-code-windows-amd64.zip) |\n| Windows ARM | [qmax-code-windows-arm64.zip](https://github.com/Quality-Max/qmax-code-releases/releases/latest/download/qmax-code-windows-arm64.zip) |\n\n**Or move the binary manually:**\n\n```bash\n# After downloading and extracting:\nchmod +x qmax-code-* \u0026\u0026 sudo mv qmax-code-* /usr/local/bin/qmax-code\n```\n\n## Quick Start\n\n```bash\n# Install\ncurl -sL https://qualitymax.io/static/install-qmax-code.txt | bash\n\n# Launch — interactive setup guides you through login\nqmax-code\n\n# Or jump straight in\nqmax-code \"crawl staging.myapp.com and generate tests\"\n```\n\nOn first run, Max the cat walks you through:\n1. **Connect** — browser opens, click authorize (like Railway CLI)\n2. **Pick a project** — or create one on the spot\n3. **Set your LLM key** — stored in OS keychain, never plaintext\n\n## What Can It Do?\n\n### Talk naturally. Max handles the rest.\n\n```\nqmax \u003e import https://github.com/my-org/my-app and generate tests\n\n  ✓ Project created: my-app (ID: 142)\n  ✓ Repository imported\n  ✓ 23 test cases generated\n  ✓ 8 Playwright scripts auto-generated\n\nqmax \u003e run all tests\n\n  ⠹ ████████████████████░░░░░░░░░░ [32s] 70% Running test 6/8...\n  ✓ 6 passed  ✗ 2 failed\n\nqmax \u003e heal the failures\n\n  🔧 Script #1204: Fixed password selector\n  🔧 Script #1207: Updated nav link text\n  ✓ Re-run: 8/8 passed\n```\n\n### 48 Tools Across 8 Categories\n\n| Category | Tools | What they do |\n|----------|-------|-------------|\n| **AI Crawl** | `start_crawl`, `crawl_results` | Point at a URL, get Playwright tests |\n| **k6 Performance** | `k6_generate`, `k6_run_test`, `k6_report` | Load, stress, spike, soak testing |\n| **Test Execution** | `run_test`, `run_local_test` | Cloud (BrowserBase) or local (pytest/playwright) |\n| **Self-Healing** | `update_script`, `rollback_script` | Fix broken selectors, rollback if worse |\n| **Test Management** | `create_test_case`, `enhance_test_case` | Full CRUD + AI enhancement |\n| **CI/CD** | `export_framework`, `trigger_framework_run` | GitHub Actions, one-click setup |\n| **Repository** | `import_repo`, `generate_gap_tests` | Import, analyze, find testing gaps |\n| **QTML** | `export_qtml`, `import_qtml` | Portable test markup language |\n\n### Terminal Commands\n\n| Command | What it does |\n|---------|-------------|\n| `/connect` | Browser-based login (Railway-style) |\n| `/disconnect` | Log out |\n| `/keys` | Interactive API key management |\n| `/status` | Connection + session info |\n| `/screenshot` | Capture screen, send to AI for analysis |\n| `/paste` | Paste image or text from clipboard |\n| `/project \u003cid\u003e` | Switch active project |\n| `/help` | Show all commands |\n\n## Features\n\n### Browser Auth\nType `/connect`. Browser opens. Click \"Authorize\". Done. No copy-pasting API keys.\n\n### OS Keychain Security\nAPI keys stored in macOS Keychain or Linux secret-tool. Masked input while typing. Never written to plaintext files.\n\n### Syntax Highlighting\nCode blocks rendered with full syntax highlighting via glamour. JavaScript, Python, YAML — all colored in your terminal.\n\n### Screenshot \u0026 Image Support\n- `/screenshot` — capture a screen region, AI analyzes it\n- `/paste` — paste images from clipboard\n- Drag image files into terminal — auto-attached to conversation\n\n### Progress Bar + Browser Animation\nLive ASCII browser animation during cloud test execution with progress bar, elapsed time, and status.\n\n### Local Test Runner\nRun pytest or Playwright tests locally. Results automatically reported back to the QualityMax platform.\n\n### Error Reporting\nBuilt-in Bugsink integration. Panics and errors reported automatically so we can fix issues before you notice them.\n\n## Requirements\n\n- **LLM API key** — Anthropic, OpenAI, or other supported provider (BYOLLM)\n- **QualityMax account** — free tier available at [app.qualitymax.io](https://app.qualitymax.io)\n- **macOS, Linux, or Windows**\n\n## How It's Different\n\n| | qmax-code | AI Assistants | Test Platforms |\n|---|---|---|---|\n| Terminal AI agent | Yes | No | No |\n| Natural language QA | Yes | Code suggestions only | No |\n| AI crawl + test gen | Yes | No | Record only |\n| Cloud execution | Yes | No | Yes |\n| Self-healing | Yes | No | Basic |\n| k6 load testing | Yes | No | No |\n| CI/CD export | Yes | No | Config only |\n| BYOLLM / open source | Yes | No | No |\n| Behind firewalls | Yes | Yes | No |\n\n## Links\n\n- [Product Page](https://qualitymax.io/qmax-code)\n- [QualityMax Platform](https://app.qualitymax.io)\n- [Source Code](https://github.com/Quality-Max/qmax-code)\n- [API Documentation](https://qualitymax.io/api-guide)\n- [Blog](https://qualitymax.io/blog)\n- [Building qmax-code: Why We Built Our Own AI Testing Agent](https://qualitymax.io/blog/building-qmax-code)\n\n## License\n\n[FSL-1.1-ALv2](LICENSE) — free to use for non-competing purposes. Converts to Apache 2.0 two years after each release.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eBuilt by \u003ca href=\"https://qualitymax.io/about\"\u003eQualityMax\u003c/a\u003e in Berlin. Max the cat approves.\u003c/sub\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquality-max%2Fqmax-code-releases","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquality-max%2Fqmax-code-releases","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquality-max%2Fqmax-code-releases/lists"}