{"id":35142383,"url":"https://github.com/ebubekirtabak/riflebird","last_synced_at":"2026-01-13T21:06:44.350Z","repository":{"id":327448042,"uuid":"1102643812","full_name":"ebubekirtabak/riflebird","owner":"ebubekirtabak","description":"Automated test generation \u0026 repair — produces unit, integration, E2E, performance, accessibility and visual tests automatically to cut development time.","archived":false,"fork":false,"pushed_at":"2025-12-28T16:10:55.000Z","size":1425,"stargazers_count":0,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-12-29T09:33:28.548Z","etag":null,"topics":["ai","e2e","llm","testing","unit-testing","visual-testing"],"latest_commit_sha":null,"homepage":"https://riflebird.dev","language":"TypeScript","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/ebubekirtabak.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":"SECURITY.md","support":null,"governance":null,"roadmap":"ROADMAP.md","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-11-23T20:30:15.000Z","updated_at":"2025-12-28T10:38:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ebubekirtabak/riflebird","commit_stats":null,"previous_names":["ebubekirtabak/riflebird"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/ebubekirtabak/riflebird","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebubekirtabak%2Friflebird","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebubekirtabak%2Friflebird/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebubekirtabak%2Friflebird/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebubekirtabak%2Friflebird/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ebubekirtabak","download_url":"https://codeload.github.com/ebubekirtabak/riflebird/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ebubekirtabak%2Friflebird/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28400669,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","e2e","llm","testing","unit-testing","visual-testing"],"created_at":"2025-12-28T12:05:56.306Z","updated_at":"2026-01-13T21:06:44.345Z","avatar_url":"https://github.com/ebubekirtabak.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\".github/riflebird-logo-dark.svg\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\".github/riflebird-logo.png\"\u003e\n    \u003cimg alt=\"Riflebird Logo\" src=\".github/riflebird-logo.png\" width=\"200\" height=\"200\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eRiflebird\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ebubekirtabak/riflebird/actions/workflows/test.yml\"\u003e\n    \u003cimg src=\"https://github.com/ebubekirtabak/riflebird/actions/workflows/test.yml/badge.svg\" alt=\"Test\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/ebubekirtabak/riflebird\"\u003e\n    \u003cimg src=\"https://codecov.io/gh/ebubekirtabak/riflebird/branch/master/graph/badge.svg\" alt=\"Coverage\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/riflebird\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/v/riflebird.svg\" alt=\"npm version\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/riflebird\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/dm/riflebird.svg\" alt=\"npm downloads\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  AI-driven test generation and execution platform — automatically produces\n  unit, integration, end-to-end (E2E), performance, accessibility, and visual\n  tests. Built with self-healing selectors, semantic element targeting,\n  multi-framework execution (Playwright, Cypress, Puppeteer, WebdriverIO),\n  and CI-friendly outputs to integrate easily into your pipelines.\n\u003c/p\u003e\n\n## Framework Ecosystem\n\nGenerate native tests and documentation for the industry's leading tools:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Vitest-6E9F18?style=for-the-badge\u0026logo=vitest\u0026logoColor=white\" alt=\"Vitest\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Jest-C21325?style=for-the-badge\u0026logo=jest\u0026logoColor=white\" alt=\"Jest\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Mocha-8D6748?style=for-the-badge\u0026logo=mocha\u0026logoColor=white\" alt=\"Mocha\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Storybook-FF4785?style=for-the-badge\u0026logo=storybook\u0026logoColor=white\" alt=\"Storybook\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Chromatic-FC521F?style=for-the-badge\u0026logo=chromatic\u0026logoColor=white\" alt=\"Chromatic\" /\u003e\n\u003c/p\u003e\n\n## Project Status\n\nFor a detailed roadmap including planned features, timelines, and success metrics, see [ROADMAP.md](./ROADMAP.md).\n\n**Current Status Summary**:\n\n- ✅ **Unit Testing**: Beta (90% success rate) - Core functionality working, auto healing implemented\n- ✅ **Documentation**: Beta - Generates Storybook stories and documentation\n- ✅ **Visual Testing**: Added in documentation generation\n- ⚠️ **E2E Testing**: In Progress - Adapters exist, full implementation in progress\n- ❌ **Performance Testing**: Planned for v2.0 - Architecture design phase\n- ❌ **Accessibility Testing**: Planned for v2.0 - Axe/pa11y integration planned\n\n## Installation\n\n```bash\nnpm install -g riflebird\n# or\npnpm add -g riflebird\n```\n\n### LLM Model Performance\n\nBenchmark results from internal testing. Success rate = percentage of generated tests that compile and pass with correct assertions.\n\n| Model                           | Provider    |  Test Type | Success Rate | Notes                            |\n| ------------------------------- | ----------- | ---------: | -----------: | -------------------------------- |\n| claude-sonnet-4.5 (Copilot CLI) | Anthropic   |       Unit |          99% | Excellent for complex test cases |\n| Kimi-k2:1t                      | Moonshot AI |       Unit |          99% | Excellent for complex test cases |\n| Devstral 2                      | Frontier AI |       Unit |          99% | Excellent for complex test cases |\n| gpt-5-mini (Copilot CLI)        | OpenAI      |       Unit |          90% | Handles complex components well  |\n| qwen3-coder:480b-cloud          | Alibaba     |       Unit |          50% | Best for simple components       |\n| Gemini 3 Pro                    | Google      | Unit / E2E |          N/A | Testing in progress              |\n| GPT-4                           | OpenAI      | Unit / E2E |          N/A | Testing in progress              |\n| GPT-4o                          | OpenAI      |       Unit |          N/A | Testing in progress              |\n\n_Results based on internal validation; performance may vary by use case._\n\n## Quick Start\n\n1. Initialize Riflebird in your project:\n\n```bash\nriflebird init\n```\n\n2. Generate tests for all files:\n\n```bash\nriflebird fire --all\n```\n\n3. Generate a test for a single file:\n\n```bash\nriflebird fire ./src/components/cards/PeopleCard/PeopleCard.component.tsx\n```\n\n4. Use scope filtering to target specific file types:\n\n```bash\nriflebird fire --all --scope component --unit\n```\n\nFor more advanced usage including glob patterns, test type filtering, and scope options, see the [Fire Command Documentation](docs/FIRE_COMMAND.md).\n\n## Features\n\n- 🎯 **AI-Powered Test Generation** - Describe tests in natural language\n- 📚 **Auto-Documentation \u0026 Visual Testing** - Generate Storybook stories, docs, and visual regression tests\n- 🔄 **Self-Healing** - Automatically fix broken tests\n- 🧠 **Smart Selectors** - Intelligent element targeting\n- 🚀 **Multi-Framework** - Supports Playwright, Cypress, Puppeteer, WebdriverIO\n- 🔒 **Secret Sanitization** - Automatically detects and redacts API keys, tokens, and credentials before sending code to LLM providers ([learn more](packages/core/src/security/README.md))\n\n## Commands\n\n- `riflebird init` - Initialize configuration\n- `riflebird fire [path]` - Generate and execute tests with flexible filtering options ([detailed documentation](docs/FIRE_COMMAND.md))\n\n### Copilot CLI provider\n\nYou can use the GitHub Copilot CLI as an AI provider by setting the AI provider to `copilot-cli`.\nConfigure the CLI command and any static arguments in your `riflebird.config.ts` under `ai.copilotCli`:\n\n```ts\nexport default defineConfig({\n  ai: {\n    provider: 'copilot-cli',\n    model: 'gpt-5-mini',\n    copilotCli: {\n      // `cmd` is fixed to the official `copilot` executable. Configure any\n      // static subcommands / flags here.\n      args: ['query'], // optional static args\n    },\n  },\n});\n```\n\nThe CLI provider will feed the chat messages to the command's stdin and interpret stdout as the assistant response. This is useful for local/offline workflows where an external CLI provides AI completions.\n\n### Gemini CLI Provider\n\nYou can use the Gemini CLI as an AI provider by setting the AI provider to `gemini-cli`.\nEnsure you have the `gemini` command executable in your path and authenticated.\n\n```ts\nexport default defineConfig({\n  ai: {\n    provider: 'gemini-cli',\n    model: 'gemini-1.5-pro',\n  },\n});\n```\n\n## Security\n\n### Automatic Secret Sanitization 🔒\n\n**Humans make mistakes. We've got you covered.**\n\nRiflebird includes a built-in security layer that automatically detects and redacts sensitive data before sending code to AI providers. Even if secrets accidentally end up in your code (we know it happens!), they won't reach the LLM.\n\n#### How It Works\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                    YOUR PROJECT FILES                       │\n│  📄 api-client.ts                                           │\n│     const apiKey = \"sk-1234567890abcdef...\"                 │\n│     const awsKey = \"AKIAIOSFODNN7PRODXYZ\"                   │\n│  📄 config.json                                             │\n│     { \"githubToken\": \"ghp_abc123xyz...\" }                   │\n│  📄 .env                                                    │\n│     DATABASE_URL=postgres://user:pass@host/db              │\n└────────────┬────────────────────────────────────────────────┘\n             │\n             │ riflebird fire --all\n             ▼\n    ┌────────────────────────────────────┐\n    │   1. Read Files                    │\n    │   ProjectFileWalker                │\n    └────────┬───────────────────────────┘\n             │\n             │ 🔍 Scan for patterns\n             ▼\n    ┌────────────────────────────────────┐\n    │   2. Detect Secrets                │\n    │   • API keys (sk-, AKIA...)        │\n    │   • Tokens (ghp_, jwt...)          │\n    │   • Passwords, DB URLs             │\n    │   • SSH keys                       │\n    └────────┬───────────────────────────┘\n             │\n             │ ✂️ Redact values\n             ▼\n    ┌────────────────────────────────────────────┐\n    │   3. Sanitized Code                        │\n    │   apiKey = \"[REDACTED_API_KEY_3f810a]\"     │\n    │   awsKey = \"[REDACTED_AWS_KEY_f8a2b1]\"     │\n    │   token = \"[REDACTED_GITHUB_TOKEN_4b9d2e]\" │\n    └────────┬───────────────────────────────────┘\n             │\n             │ 🔒 Safe to analyze\n             ▼\n    ┌────────────────────────────────────┐\n    │   4. Send to LLM                   │\n    │   OpenAI / Anthropic / Local       │\n    └────────────────────────────────────┘\n\n             ✅ Your secrets never leave your machine in plaintext\n             📊 Only detection stats logged: \"Sanitized 3 secrets from api-client.ts\"\n\n             NOTE: Sanitization previously performed inside the `ai-client` helper was removed to avoid double-sanitization. Riflebird performs sanitization at a single entry point: `ProjectFileWalker.readFileFromProject()` — all code is sanitized there before being passed to downstream components.\n```\n\n**Protected secret types:**\n\n- API Keys (OpenAI, Anthropic, generic)\n- AWS Access Keys \u0026 Secret Keys\n- GitHub Tokens\n- SSH Private Keys\n- Database URLs (PostgreSQL, MySQL, MongoDB, Redis)\n- JWT Tokens\n- OAuth Tokens\n- Passwords \u0026 Environment Variables\n\n**Why this matters:**\n\n- 🔴 Developers accidentally commit secrets (it happens to everyone!)\n- 🔴 Test files sometimes contain real credentials during development\n- 🔴 Config files may have production passwords temporarily\n- 🛡️ **Riflebird protects you automatically** - no configuration needed\n\n**Key features:**\n\n- ✅ Secrets never leave your machine in plaintext\n- ✅ Automatic detection with smart false-positive filtering\n- ✅ Safe logging (only counts, never actual values)\n- ✅ Original files unchanged on disk\n- ✅ **Always active** - protection you can forget about\n\n[→ Read full security documentation](packages/core/src/security/README.md)\n\n## Development\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed development guidelines.\n\n```bash\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm build\n\n# Run in development mode\npnpm dev\n\n# Run tests with coverage\npnpm test -- --run --coverage\n```\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details on:\n\n- Development setup\n- Testing standards (TDD approach)\n- Code quality requirements\n- TypeScript conventions\n- Pull request process\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Febubekirtabak%2Friflebird","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Febubekirtabak%2Friflebird","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Febubekirtabak%2Friflebird/lists"}