Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
202 commits
Select commit Hold shift + click to select a range
b9bdd1c
Update README.md
shuvonsec Apr 7, 2026
d9e254b
Update README.md
shuvonsec Apr 7, 2026
1c1183d
add: meme coin security module — 8 token bug classes, token scanner, …
shuvonsec Apr 13, 2026
7abd37b
fix: mark TODO-4 resolved — hunt.py BASE_DIR already correct via tool…
shuvonsec Apr 16, 2026
137af78
add: logo SVG assets (banner + icon variants)
shuvonsec Apr 16, 2026
58417fc
add: CHANGELOG v4.0.0 + v4.1.0 entries — meme coin module + patch fixes
shuvonsec Apr 16, 2026
749f0e8
fix: autoplan review — README v4.1.0, hunt-memory gitignore, Quick St…
shuvonsec Apr 16, 2026
2ce27ac
feat: auto-memory at session end — log_session_summary() wired into h…
shuvonsec Apr 16, 2026
d981a3f
docs: rewrite README for clarity — plain language, everyone can under…
shuvonsec Apr 16, 2026
9ae32c2
docs: add FAQ.md and TERMS.md — plain language for everyone
shuvonsec Apr 16, 2026
d75a811
Add: IP and CIDR target support (hunt.py + recon_engine.sh)
shuvonsec Apr 17, 2026
1043315
Improve: Burp Suite-style HTML report generator
shuvonsec Apr 17, 2026
4560879
Add: MFA bypass and SAML/SSO checks to vuln_scanner.sh
shuvonsec Apr 17, 2026
63a0082
fix: orphan process leak, macOS compat, dalfox timeout, severity clas…
shuvonsec Apr 17, 2026
a74f182
feat: CVSS 4.0 scoring, recon adapter, TODO fixes (#10)
shuvonsec Apr 17, 2026
320523d
fix: rename /resume → /pickup, add session isolation, multi-target, C…
shuvonsec Apr 17, 2026
7e2baab
remove: cve_hunter.py, report_generator.py, hunt_journal.py — replace…
shuvonsec Apr 18, 2026
a94871c
fix installation_tools.sh verification
Apr 20, 2026
1b9b914
Merge pull request #23 from TRIKKSS/main
shuvonsec Apr 20, 2026
bcccbda
feat: v4.2.0 — memory rotation + README polish
shuvonsec Apr 29, 2026
85dd85b
fix: v4.2.1 — PatternDB.save() O(n²) perf bug
shuvonsec May 1, 2026
21a59fe
fix: v4.2.2 — restore missing ReconAdapter class
shuvonsec May 1, 2026
4ada94f
feat: v4.2.3 — Stop hook for memory-gc auto-rotation
shuvonsec May 1, 2026
f2c200b
fix: restore tools/__init__.py so test_credential_store / test_token_…
venkatas May 6, 2026
806f77e
fix: brain auto-detect prioritizes cloud providers with API keys (#19)
venkatas May 6, 2026
229a526
fix: cap katana crawl at 5 min; wire it into recon_engine.sh (#20)
venkatas May 6, 2026
60d14e2
fix: 2 false-positive correctness bugs from VAPT engagement (#31)
venkatas May 6, 2026
e5ca999
feat: domain-list mode, Caido MCP, authorization preamble, README cla…
shuvonsec May 6, 2026
c720e5a
feat: 7 new commands, auth-session, methodology cheatsheet, recon nuc…
shuvonsec May 11, 2026
483ad80
README: drop crypto badges, add v4.3 notes + recon toolkit table
May 11, 2026
711c2f2
Feat/commands and auth session (#37)
shuvonsec May 11, 2026
e4099d8
Feat/banner and command fixes (#43)
shuvonsec May 16, 2026
599c582
feat: add bughunter.fun landing page (site/index.html)
awarexonedev May 19, 2026
8dfd9f9
docs: add "ask Claude to install" path + paste-ready usage prompts
awarexonedev May 21, 2026
d17aa44
Merge remote-tracking branch 'origin/main' into landing-page
awarexonedev May 21, 2026
f6b1b6b
Landing page (#55)
shuvonsec May 21, 2026
e9516c0
fix(vuln_scanner): remove mkdir referencing $FINDINGS_DIR before assi…
BeargleIndustries Jun 7, 2026
e513e15
fix(vuln_scanner): repair orphaned if-block in XSS check (#46)
BeargleIndustries Jun 7, 2026
86c12aa
bugfix: improve Go PATH hangling and version detection in install_too…
Shawanga Jun 7, 2026
04757c8
Update api-endpoints.txt (#52)
adityaax Jun 7, 2026
cb30b16
Update sensitive-files.txt (#53)
adityaax Jun 7, 2026
480ebea
feat(opencode): add uninstall scripts, fix MCP format, replace plugin…
savioruz Jun 7, 2026
e493d3c
feat(vuln-classes): add error disclosure & framework debug endpoints …
letztek Jun 7, 2026
f7270f4
feat(vuln-classes): add postMessage testing subsection to XSS (#48)
letztek Jun 7, 2026
68d0924
feat: 3 small recon/brain/dork-runner improvements from VAPT engageme…
venkatas Jun 7, 2026
a734f34
feat: credential attack pipeline — wordlist-gen / osint / breach-chec…
letztek Jun 7, 2026
2b1905f
feat(vuln-classes): add CSS injection coverage
letztek May 19, 2026
3befcb2
feat: harden cli and bump v4.3.1
awarexonedev Jun 8, 2026
233b778
Merge origin/main into landing-page
awarexonedev Jun 8, 2026
500d5cd
I'm back with some update. (#59)
shuvonsec Jun 8, 2026
44d3c1b
fix: stop promoting weak scanner signals into findings (4-layer FP re…
awarexonedev Jun 9, 2026
3305af0
chore: commit local changes before merge with main
awarexonedev Jun 9, 2026
e7b4491
merge: resolve conflicts from origin/main merge
awarexonedev Jun 9, 2026
62f178e
docs: add Star History chart to README
awarexonedev Jun 9, 2026
9fecd91
Merge pull request #60 from shuvonsec/landing-page
shuvonsec Jun 9, 2026
539018f
docs: clean README redesign — simpler, cleaner, top-class
awarexonedev Jun 9, 2026
0b79364
docs: add project structure section + folder READMEs for every major …
awarexonedev Jun 9, 2026
49c1e34
feat: false positive reduction — scanner confidence + validation gate…
awarexonedev Jun 9, 2026
bf6e848
chore: add GitHub community health files + organize root structure
awarexonedev Jun 9, 2026
684fef0
chore: remove TODOS.md and TUTORIAL.md from root (moved to docs/)
awarexonedev Jun 9, 2026
17f9d34
Merge pull request #61 from shuvonsec/landing-page
shuvonsec Jun 9, 2026
87b94f2
docs: record calibration handoff updates
awarexonedev Jun 9, 2026
6ee4fe8
feat(vuln-classes): add CSS injection coverage
shuvonsec Jun 9, 2026
44bfa24
chore: bump claude-opus-4-6 → claude-opus-4-7 in report-writer agent …
awarexonedev Jun 10, 2026
6346e4e
feat(vuln-classes): add padding oracle and crypto misuse coverage
letztek May 20, 2026
6423669
feat(skills): add client-reverse skill (request-signing / anti-bot to…
letztek Jun 10, 2026
b389e53
feat: add AI-assisted hunt playbook
awarexonedev Jun 11, 2026
b3b07fa
feat: add standalone engine — run bughunter without any AI subscription
awarexonedev Jun 11, 2026
98f524d
Merge pull request #62 from shuvonsec/update/claude-model-opus-4-7
shuvonsec Jun 11, 2026
e3acde6
docs: update README with standalone engine and free provider support
awarexonedev Jun 11, 2026
5c093a6
Merge pull request #71 from shuvonsec/update/claude-model-opus-4-7
shuvonsec Jun 11, 2026
9ce874e
docs: add Star History chart to top of README
awarexonedev Jun 11, 2026
bd21686
feat(arsenal): add kimchi and freebuff compatibility
nurazhardotcom Jun 12, 2026
272c6ba
feat: add friendlier CLI help and aliases
awarexonedev Jun 12, 2026
ffd4406
Fix recon wordlist lookup
awarexonedev Jun 12, 2026
8debd33
Merge pull request #73 from nurazhardotcom/feature/kimchi-freebuff-co…
shuvonsec Jun 12, 2026
22cbae0
fix(uninstall): remove installed agents on uninstall (#72)
Realgagenichols Jun 15, 2026
7ea1610
macOS: fix unclosed if in vuln_scanner.sh XSS section (#57)
AurisDSP Jun 15, 2026
2712b46
feat(skills): add mobile-pentest skill (Android/iOS runtime-first wor…
letztek Jun 15, 2026
b1810e7
feat(waf-bypass): systematic WAF bypass pipeline — encoder, analyzer,…
letztek Jun 15, 2026
9b77a8b
feat(skills): add framework 1-day quick-wins to security-arsenal (#68)
letztek Jun 15, 2026
c7afef4
feat(web2-vuln-classes): add LFI / file inclusion -> RCE class (#65)
letztek Jun 15, 2026
3fc09c1
feat(web2-vuln-classes): add MCP & RAG-specific attacks to LLM/AI cla…
letztek Jun 15, 2026
07eaa15
feat(web2-vuln-classes): add Insecure Deserialization as class 24 (PH…
shuvonsec Jun 15, 2026
76fe9f5
feat(brain): add 6 new LLM providers — Gemini, Kimi, Mistral, Togethe…
shuvonsec Jun 15, 2026
11e4575
feat: add GraphQL audit skill + tool — introspection, batching DoS, I…
shuvonsec Jun 16, 2026
cfd5ef3
docs: move Star History chart to top of README
awarexonedev Jun 16, 2026
935f342
fix: use OpenCode tool mappings for agents (#75)
Edneam Jun 18, 2026
e91489a
feat: add 6 web + LLM vuln scanners — CORS, CRLF, NoSQLi, JWT, OOB, L…
DebasishTripathy13 Jun 19, 2026
ddc7062
feat: add web-llm-scanners skill packaging the 6 new tools
DebasishTripathy13 Jun 19, 2026
b9e429b
rename: web-llm-scanners skill -> 'argus' (the all-seeing scanner suite)
DebasishTripathy13 Jun 19, 2026
3893032
perf: speed up nuclei, httpx, subfinder, katana, dalfox, gau, arjun a…
shuvonsec Jun 21, 2026
f298871
feat: add Lead Board — persistent recon→skill lead ledger (#85)
SeekAndExploit Jul 9, 2026
fde37e9
feat(brain): add OpenRouter LLM provider for standalone bughunter (#94)
depapp Jul 21, 2026
6b7456a
feat: prefer uv over pipx/pip for Python installs in install_tools.sh…
thuvh Jul 21, 2026
850b650
Update README.md
shuvonsec Jul 21, 2026
0bbf302
Update README.md
shuvonsec Jul 21, 2026
cf80f28
Update README.md
shuvonsec Jul 22, 2026
9abb019
Update README.md
shuvonsec Jul 24, 2026
2e15e57
Update README.md
shuvonsec Jul 25, 2026
0a4a847
Update README.md
shuvonsec Jul 31, 2026
35c4591
Remove CA address from README
shuvonsec Aug 1, 2026
7b0378c
Clean up formatting in README.md
shuvonsec Aug 1, 2026
7b6d25e
Update README to enhance description clarity
shuvonsec Aug 1, 2026
1f43ba0
Fix formatting in README description
shuvonsec Aug 1, 2026
f0e4590
Update README.md
shuvonsec Aug 1, 2026
79c7eba
Improve standalone Ollama setup and lifecycle
Aug 4, 2026
eeb2e05
fix: support DeepSeek v4-flash and v4-pro (#98)
zeze-zeze Aug 6, 2026
7868944
feat: add eol_check.py lifecycle/EOL intel tool (#97)
grave0x Aug 6, 2026
038e9b0
fix: harden error handling and security across codebase (#81)
onlybugs05 Aug 6, 2026
d083c2d
merge: resolve PR #99 conflicts with main
awarexonedev Aug 6, 2026
ec88b9b
docs: polish README hero and showcase real CLI banner
awarexonedev Aug 6, 2026
88c6465
docs: fix README hero spacing and banner alignment
awarexonedev Aug 6, 2026
9e5e260
feat: power up hunt pipeline and sync tools docs/skills
shuvonsec Aug 6, 2026
c874f5f
Deepen SQLi guidance: DBMS fingerprinting, injection coverage, read-o…
letztek Aug 6, 2026
2884a25
feat(web2-recon): add source disclosure & extraction section (#67)
letztek Aug 6, 2026
fea1d8b
feat(web2-vuln-classes): add dependency confusion / supply chain clas…
letztek Aug 6, 2026
4f11db6
merge: resolve PR #82 conflicts with main
awarexonedev Aug 6, 2026
8eeb180
merge: resolve PR #51 conflicts with main
awarexonedev Aug 6, 2026
32bf7e7
merge: resolve PR #63 conflicts with main
awarexonedev Aug 6, 2026
eabf80c
fix: add recon log_vuln helper and polish README
awarexonedev Aug 6, 2026
615f552
docs(readme): center hacker-green CLI banner hero
awarexonedev Aug 6, 2026
45eb49b
docs(readme): add Buy Me a Coffee support link
awarexonedev Aug 6, 2026
ce3e7a5
Update README.md
shuvonsec Aug 10, 2026
26ef8be
Update README.md
shuvonsec Aug 10, 2026
b2facdf
Update README.md
shuvonsec Aug 10, 2026
e363fa0
Update README.md
shuvonsec Aug 10, 2026
1f829ed
Docs/awarexone branding (#103)
shuvonsec Aug 21, 2026
ed2dcb4
docs(readme): fix broken star history chart (#102)
OctoBored Aug 21, 2026
5e73c33
feat(brain): add OrcaRouter LLM provider (#101)
Marc-oss-hub Aug 21, 2026
edde1ad
docs: lead with sponsorship callout, add Sponsor button and site cred…
shuvonsec Aug 21, 2026
273aeae
docs: add Used By section and ADOPTERS.md (#106)
shuvonsec Aug 21, 2026
a44153d
docs: refine Used By into an adopter grid with an add-your-team CTA (…
shuvonsec Aug 21, 2026
861cd41
feat: wire naabu/eyewitness/semgrep into portscan, screenshot, and sa…
shuvonsec Aug 21, 2026
2b06d18
ci: run pytest on push and PR (#109)
shuvonsec Aug 21, 2026
4cf51dd
feat: add /domxss headless-browser DOM XSS confirmation harness (#111)
shuvonsec Aug 21, 2026
40919b7
safety: enforce scope as hard block in AutopilotGuard (fail-closed); …
ftacorn Aug 23, 2026
9fd1941
fix: bash 3.2 aborts on empty-array expansion in install/uninstall (#…
NaorYaacov Aug 23, 2026
186568a
safety: fix the autonomous agent's unconfirmed shell-execution path +…
ftacorn Aug 23, 2026
a22af36
docs: refresh README banner and expand AwareXone attribution (#116)
shuvonsec Aug 25, 2026
b3dac79
docs: introduce AwareXone in the intro, fix stale repo path (#117)
shuvonsec Aug 25, 2026
88010fd
fix: point CLI banner at AwareXone + current repo path (#118)
shuvonsec Aug 25, 2026
80efb01
docs: drop CLI-banner image and Star History, strip em dashes (#119)
shuvonsec Aug 25, 2026
37876b7
Trim the README hero, move the sponsor pitch down (#120)
shuvonsec Aug 25, 2026
4543224
Give the sponsorship pitch its own heading in Support (#121)
shuvonsec Aug 25, 2026
1f87d7a
Un-shrink the AwareXone credit line in the hero (#122)
shuvonsec Aug 25, 2026
8df0cbd
Sweep the rest of the old repo path out of the codebase (#123)
shuvonsec Aug 25, 2026
0826b13
Move Support This Project up, actually pitch AwareXone's services (#124)
shuvonsec Aug 25, 2026
02c57f5
Add crypto donation addresses and standardize contact email. (#126)
shuvonsec Sep 1, 2026
6d0d991
README.md
shuvonsec Sep 4, 2026
8892e47
Update README.md
shuvonsec Sep 4, 2026
8d54fca
Point landing and README X links to @awarexone.
Sep 4, 2026
114c90c
Add Product Hunt featured badge to README and site.
Sep 4, 2026
792a194
docs: add Netflix privacy opt-out guide and 2026 statement reproducti…
H4d3es Sep 14, 2026
7c55571
feat: add LiteLLM as a multi-provider gateway backend (#129)
prodmanpd Sep 14, 2026
9c80682
docs: add 'Starred By Engineers At' section to README (#131)
shuvonsec Sep 14, 2026
4d20b2c
docs: retitle stargazer section and move it under the header (#132)
shuvonsec Sep 14, 2026
7e31394
docs: restyle Thanks section and add 7 missing contributors (#133)
shuvonsec Sep 14, 2026
5ce34aa
fix: raise requests and pytest minimum versions (#134)
shuvonsec Sep 14, 2026
8147100
fix/claude-plugin-manifest (#125)
Amine-Genin Sep 14, 2026
4f31f2d
docs: update AwareXone emails and promote AXguard at top (#135)
shuvonsec Sep 15, 2026
0f5d88c
docs: move AXguard down and tidy README layout (#137)
shuvonsec Sep 15, 2026
cb22397
docs: move Trusted By Engineers At under the hero (#138)
shuvonsec Sep 15, 2026
ea3a621
feat(core): add research learning and schema v2 memory (#139)
shuvonsec Sep 16, 2026
e198d9a
fix: restore OpenCode tools mapping schema in agent frontmatter (#140)
Biruk121 Sep 16, 2026
c6cce19
feat(mcp): add native bug bounty research interface (#141)
shuvonsec Sep 17, 2026
a5ce7c9
fix: point Dependency Graph at the Awarexone module path (#142)
shuvonsec Sep 19, 2026
6cb9dab
chore: enable GitHub Sponsors button (#145)
shuvonsec Sep 21, 2026
063d6b1
Update FUNDING.yml
shuvonsec Sep 21, 2026
b81d2e7
feat: Fluxion × Agentic Bug Hunter partnership (#146)
shuvonsec Sep 21, 2026
919c4d8
docs: polish Fluxion README placement and drop Product Hunt (#147)
shuvonsec Sep 21, 2026
fccfaf7
Promote social media case review at README top
awarexonedev Sep 21, 2026
f07e0aa
Use a single lime Case Review button in README
awarexonedev Sep 21, 2026
44d7eaf
Add short recovery line above Case Review button
awarexonedev Sep 21, 2026
33dbd74
Use SocialSafe site copy above Case Review button
awarexonedev Sep 21, 2026
5082886
Style SocialSafe blurb in site lime
awarexonedev Sep 21, 2026
3ddc792
feat(poc): add PoC evidence bundler (/poc) (#144)
shivsin25 Sep 21, 2026
28da103
feat: package as pip-installable distribution (agentic-bug-hunter) (#…
shuvonsec Sep 22, 2026
c1551d0
docs: fix broken README images on PyPI + add downloads badge (#149)
shuvonsec Sep 22, 2026
f57ca44
docs: document pip install (PyPI) in Quick Start (#150)
shuvonsec Sep 22, 2026
e1c77c6
docs: add 'Get started (30 seconds)' quick-start near top (#151)
shuvonsec Sep 22, 2026
1ddb741
Update project description
shuvonsec Sep 23, 2026
ae31936
Update README
shuvonsec Sep 23, 2026
aafa48f
Revise project description and CA address
shuvonsec Sep 23, 2026
10f3ea0
Update README.md
shuvonsec Sep 23, 2026
93aa1fe
Fix Groq integration, target normalization, local targets + security/…
amanssj3 Sep 24, 2026
54241ed
fix(security): command injection #153 + SkillsLLM scan findings (#165)
shuvonsec Sep 28, 2026
1812994
fix(tools): point _dep_hint fallback at a path that exists (#162)
indraoverflow Sep 28, 2026
b8344e1
fix(docs): correct install_tools.sh path, add doc-path regression tes…
indraoverflow Sep 28, 2026
6f56563
fix(hackerone-mcp): update Team GraphQL query for removed H1 fields (…
indraoverflow Sep 28, 2026
78a3413
feat(brain): add Requesty LLM provider (#159)
Thibaultjaigu Sep 28, 2026
bfcdc78
fix(install): resolve split repo layout, anchor to script dir, fail l…
indraoverflow Sep 28, 2026
db925b7
feat(dashboard): local web Hunt Dashboard (/dashboard) (#143)
shivsin25 Sep 28, 2026
c2472d9
feat(verify): the report gate — prove-or-suppress (/verify) [Verifica…
shivsin25 Sep 28, 2026
2e86602
Add Infistar sponsor banner to the README.
shuvonsec Sep 30, 2026
47b90b2
Update contributors list and avatars (35 contributors)
shuvonsec Oct 2, 2026
ba255bc
Revert "Update contributors list and avatars (35 contributors)"
shuvonsec Oct 2, 2026
f511fba
Update contributors list and avatars (35 contributors) (#169)
shuvonsec Oct 2, 2026
647a9ea
feat: deterministic-verification + parallel-swarm architecture (#170)
shuvonsec Oct 2, 2026
deda2c5
TEST
shuvonsec Oct 3, 2026
977ba6a
Update README.md
shuvonsec Oct 3, 2026
8e45dc9
feat(skills): add bug-chaining, johnwick, jsmax, pii-hunter, omni-kil…
lucifer0xf Oct 5, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
29 changes: 29 additions & 0 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
{
"name": "agentic-bug-hunter",
"description": "AI-powered bug bounty toolkit — recon, vulnerability hunting, validation gates, and submission-ready reports for HackerOne, Bugcrowd, Intigriti, and Immunefi.",
"version": "6.0.1",
"author": {
"name": "AwareXone",
"url": "https://awarexone.com"
},
"homepage": "https://github.com/Awarexone/Agentic-Bug-Hunter",
"repository": {
"type": "git",
"url": "https://github.com/Awarexone/Agentic-Bug-Hunter.git"
},
"license": "MIT",
"keywords": [
"bug-bounty",
"security",
"recon",
"vulnerability-hunting",
"pentest",
"hackerone",
"bugcrowd",
"immunefi"
],
"commands": "./commands",
"agents": "./bughunter/agents",
"skills": "./skills",
"hooks": "./hooks/hooks.json"
}
17 changes: 17 additions & 0 deletions .claude/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "[ -f tools/memory_gc.py ] && python3 -m tools.memory_gc --rotate >/dev/null 2>&1 || true",
"timeout": 30,
"async": true
}
]
}
]
}
}
31 changes: 31 additions & 0 deletions .github/CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Code of Conduct

## Our Pledge

We are a community of security researchers, bug bounty hunters, and developers. We pledge to make participation welcoming and harassment-free for everyone, regardless of experience level, background, or identity.

## Our Standards

**Expected:**
- Respectful, constructive communication
- Sharing knowledge and techniques that help others improve
- Accepting feedback gracefully and giving it kindly
- Crediting others for their work and findings

**Not acceptable:**
- Harassment, personal attacks, or discriminatory language
- Sharing others' private information without consent
- Using this toolkit or community to conduct unauthorized testing
- Claiming others' bug bounty reports as your own

## Scope

This Code of Conduct applies in all project spaces — GitHub issues, PRs, discussions, and any community channels representing this project.

## Enforcement

Violations can be reported to [shuvon@awarexone.com](mailto:shuvon@awarexone.com) or [hello@awarexone.com](mailto:hello@awarexone.com). All reports are reviewed confidentially. Maintainers may remove, edit, or reject contributions that violate this Code of Conduct.

---

This project follows a simplified version of the [Contributor Covenant v2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
61 changes: 61 additions & 0 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Contributing

Bug hunters welcome. Every improvement here makes real hunts more effective.

## What We Most Need

| Contribution | Why It Matters |
|:---|:---|
| New scanner modules or detection techniques | Increases surface coverage |
| Payload additions to `skills/security-arsenal/SKILL.md` | Better bypass coverage |
| Methodology improvements backed by paid reports | Proven techniques only |
| Platform support (YesWeHack · Synack · HackenProof) | Wider program coverage |
| False positive fixes with regression tests | Community's top complaint |

## Before You Start

1. **Check open issues** — your idea may already be in progress
2. **One feature per PR** — keeps review fast and clean
3. **Test your changes** — run `pytest tests/` before opening the PR
4. **No theoretical bugs** — if it's a scanner addition, it must have a real PoC or real-world precedent

## Workflow

```bash
# 1. Fork and clone
git clone https://github.com/YOUR_USERNAME/Agentic-Bug-Hunter.git
cd Agentic-Bug-Hunter

# 2. Create a branch
git checkout -b feat/your-contribution

# 3. Make your changes, run tests
pytest tests/

# 4. Commit
git commit -m "feat: short description of what and why"

# 5. Push and open PR
git push origin feat/your-contribution
```

## Commit Message Format

```
feat: new capability
fix: bug fix
docs: documentation only
test: adding or fixing tests
chore: maintenance (deps, CI, cleanup)
```

## PR Checklist

- [ ] Tests pass (`pytest tests/`)
- [ ] No hardcoded targets, API keys, or real domain names in code
- [ ] Scanner additions use `[CONFIRMED]` / `[POSSIBLE]` / `[INFORMATIONAL]` confidence states
- [ ] Methodology changes are backed by a real finding or public write-up

## Questions?

Open a [GitHub Discussion](https://github.com/Awarexone/Agentic-Bug-Hunter/discussions) or reach out at [hello@awarexone.com](mailto:hello@awarexone.com).
8 changes: 8 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Sponsor BugHunter — helps fund new features and keeps the free standalone mode running.
# Powered by AwareXone.com — https://awarexone.com
# Native GitHub Sponsors button → https://github.com/sponsors/awarexone

github: [awarexone]
custom:
Bitcoin (BTC) 1GXwGqmLcnbZWgVNskUAZyw2cmqenkUFNY
Solana (SOL) 4ArkPu1E7tkrt3d5X84grWzF1xjuLpScgGEy12Bp2cmE
40 changes: 40 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
---
name: Bug Report
about: Something in the toolkit isn't working correctly
title: "[BUG] "
labels: bug
assignees: shuvonsec
---

## What happened?

<!-- A clear description of the bug -->

## Steps to Reproduce

```bash
# Paste the exact command(s) that triggered the bug
```

## Expected Behavior

<!-- What should have happened? -->

## Actual Behavior

<!-- What did happen? Paste the error output here -->

```
error output here
```

## Environment

- **OS:** (macOS / Ubuntu / Kali / other)
- **Python version:** (`python3 --version`)
- **Tool version / commit:** (`git rev-parse HEAD`)
- **External tools installed:** (subfinder / httpx / nuclei / etc.)

## Additional Context

<!-- Any other details — target type, program platform, etc. (no real target names) -->
27 changes: 27 additions & 0 deletions .github/ISSUE_TEMPLATE/false_positive.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
name: False Positive Report
about: The scanner flagged something that came back N/A or is not a real vulnerability
title: "[FP] "
labels: false-positive
assignees: shuvonsec
---

## What was flagged?

<!-- Scanner output line — paste the [CONFIRMED] / [POSSIBLE] finding -->

```
[POSSIBLE] XSS found at ...
```

## Why is it a false positive?

<!-- What made this come back N/A? CSP blocked it? Own data only? DNS-only SSRF? -->

## Program / Context

<!-- Bug bounty platform (H1, Bugcrowd, etc.) — no real target names needed -->

## Kill Signal

<!-- What observable signal should we add to the kill-signal table to prevent this in future? -->
27 changes: 27 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
name: Feature Request
about: Suggest a new capability or improvement
title: "[FEAT] "
labels: enhancement
assignees: shuvonsec
---

## What do you want?

<!-- One-sentence summary of the feature -->

## Why does this matter?

<!-- What does it enable? What bug class does it catch? Is it backed by a real finding? -->

## Proposed Approach

<!-- How would you implement it? Which file(s) would change? -->

## Alternatives Considered

<!-- What else did you consider? Why is your approach better? -->

## References

<!-- Writeups, CVEs, HackerOne disclosed reports, or other evidence this technique works -->
29 changes: 29 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
## Summary

<!-- What does this PR do? One to three bullet points. -->

-
-

## Type

- [ ] Bug fix
- [ ] New feature / scanner module
- [ ] Methodology improvement
- [ ] Documentation
- [ ] False positive reduction

## Test Plan

- [ ] `pytest tests/` passes locally
- [ ] No hardcoded targets, API keys, or real domain names
- [ ] Scanner additions use `[CONFIRMED]` / `[POSSIBLE]` / `[INFORMATIONAL]` confidence states
- [ ] New functionality has at least one regression test

## Related Issue

Closes #

## Evidence (for methodology changes)

<!-- Link to a write-up, CVE, or disclosed report that backs this technique -->
42 changes: 42 additions & 0 deletions .github/SECURITY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Security Policy

## Supported Versions

| Version | Supported |
|:---|:---|
| v5.x (latest) | Yes |
| v4.x | Critical fixes only |
| < v4.0 | No |

## Reporting a Vulnerability

If you find a security issue in this toolkit itself (not a bug bounty finding on a third-party target), please **do not open a public GitHub issue**.

**Email:** [shuvon@awarexone.com](mailto:shuvon@awarexone.com)
**CC / general:** [hello@awarexone.com](mailto:hello@awarexone.com)
**Subject line:** `[SECURITY] Brief description`

Include:
- Description of the vulnerability
- Steps to reproduce
- Potential impact
- Your suggested fix (optional)

You will receive a response within **72 hours**. Critical issues are patched and released within 7 days.

## Scope

This policy covers vulnerabilities in:
- `tools/` — Python and shell scanner scripts
- `memory/` — hunt memory system
- `install.sh` / `install_tools.sh` — installer scripts
- `demo/` — local demo server

**Out of scope:** Third-party programs you test using this toolkit. Those belong in their respective bug bounty programs.

## Responsible Disclosure

We follow coordinated disclosure. We will:
- Acknowledge your report within 72 hours
- Keep you updated on the fix timeline
- Credit you in the release notes (unless you prefer anonymity)
40 changes: 40 additions & 0 deletions .github/workflows/tests.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
name: tests

on:
push:
branches: [main]
pull_request:
workflow_dispatch:

permissions:
contents: read

concurrency:
group: tests-${{ github.ref }}
cancel-in-progress: true

jobs:
pytest:
name: pytest (py${{ matrix.python-version }})
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
python-version: ["3.10", "3.11", "3.12"]

steps:
- uses: actions/checkout@v4

- name: Set up Python ${{ matrix.python-version }}
uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python-version }}
cache: pip

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt

- name: Run test suite
run: pytest -q
Loading