KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

hackingtool

★ 78,992 Open GitHub ↗

해커를 위한 올인원 해킹 툴

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### 승인된 보안 테스트를 위한 AI 가이드 기반의 올인원 툴킷

**21 카테고리에 걸친 215개의 엄선된 툴** — recon, OSINT, web, wireless, phishing,
forensics, post-exploitation 등이 포함되어 있으며, **일상 영어를 적절한 툴과 정확한 명령어로 변환해 주는 AI 레이어**가 탑재되어 있습니다.

**대상 사용자:** penetration testers · red teamers · blue-team/SOC 및 DFIR analysts ·
OSINT researchers · bug-bounty hunters · CTF players · 보안 연구원 및
학생 — 모두 **법적으로, 자신이 소유하거나 테스트 권한을 부여받은 시스템에서 작업하는** 전문가를 위해 구축되었습니다.

[![License](https://img.shields.io/github/license/Z4nzu/hackingtool?style=flat-square&labelColor=0D1117&color=7B61FF)](https://raw.githubusercontent.com/Z4nzu/hackingtool/master/LICENSE) [![Python](https://img.shields.io/badge/Python-3.10+-0D1117?style=flat-square&labelColor=0D1117&logo=python&logoColor=7B61FF)](https://www.python.org/) [![Stars](https://img.shields.io/github/stars/Z4nzu/hackingtool?style=flat-square&labelColor=0D1117&color=7B61FF)](https://github.com/Z4nzu/hackingtool/stargazers) [![Forks](https://img.shields.io/github/forks/Z4nzu/hackingtool?style=flat-square&labelColor=0D1117&color=7B61FF)](https://github.com/Z4nzu/hackingtool/network/members) [![Issues](https://img.shields.io/github/issues/Z4nzu/hackingtool?style=flat-square&labelColor=0D1117&color=7B61FF)](https://github.com/Z4nzu/hackingtool/issues) [![Last Commit](https://img.shields.io/github/last-commit/Z4nzu/hackingtool?style=flat-square&labelColor=0D1117&color=7B61FF)](https://github.com/Z4nzu/hackingtool/commits/master) [![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-DB61A2?style=flat-square&labelColor=0D1117&logo=githubsponsors&logoColor=DB61A2)](https://raw.githubusercontent.com/Z4nzu/hackingtool/master/)

<br/>

![](https://img.shields.io/badge/21_Categories-7B61FF?style=for-the-badge&labelColor=0D1117) &nbsp;![](https://img.shields.io/badge/215_Tools-7B61FF?style=for-the-badge&labelColor=0D1117) &nbsp;![](https://img.shields.io/badge/63_Tags-7B61FF?style=for-the-badge&labelColor=0D1117) &nbsp;![](https://img.shields.io/badge/AI--Guided-7B61FF?style=for-the-badge&labelColor=0D1117&logo=openai&logoColor=white) &nbsp;![](https://img.shields.io/badge/Linux_%7C_Kali_%7C_Parrot_%7C_macOS-7B61FF?style=for-the-badge&labelColor=0D1117&logo=linux&logoColor=white)

<br/>

</div>

---

## Contents

- [Why hackingtool](#why-hackingtool)
- [Tool Categories](#tool-categories)
- [Installation](#installation)
  - [From source with pipx (recommended)](#from-source-with-pipx-recommended)
  - [For development](#for-development)
  - [Docker](#docker)
  - [Optional runtimes](#optional-runtimes)
- [Quick Commands](#quick-commands)
  - [Command reference](#command-reference)
- [Features](#features)
  - [🔎 `/find` — 아직 가지고 있지 않은 필요한 툴 찾기](#-find--a-tool-for-a-need-you-dont-have-yet)
  - [🎯 `/goal` — 목표 계획 및 단계별 실행](#-goal--plan-an-objective-run-it-one-step-at-a-time)
  - [🧠 Recommendations — 일상 영어로 원하는 작업 말하기](#-recommendations--say-what-you-want-in-plain-english)
  - [🏷 Tags and search](#-tags-and-search)
  - [▶ Background panes (tmux)](#-background-panes-tmux)
  - [⚙ Settings and the AI layer](#-settings-and-the-ai-layer)
  - [📋 Headless engagements](#-headless-engagements)
- [Documentation](#documentation)
- [Contributing](#contributing)
- [Support & Sponsor](#support--sponsor)
- [Social](#social)

---

## Why hackingtool

- **🧠 AI 가이드 워크플로우** — 원하는 내용을 설명하면 (예: "example.com의 서브도메인을 찾아줘") 의도를 적절한 툴에 매핑하고, 정확한 문서화된 명령어를 제공하며, 목표를 단계별로 계획한 뒤, 결과물을 요약하고 수행 보고서 초안을 작성합니다. 본인의 API 키를 사용하거나 로컬 모델을 실행할 수 있으며, 자동으로 실행되는 것이 없으며 조작된 내용도 없습니다.
- **🗂 215개의 엄선된 툴, 하나의 콘솔** — Git 리포지토리를 일일이 찾을 필요 없이 21개 카테고리에 걸쳐 툴을 설치하고 실행할 수 있습니다. 고정된 태그 분류 체계(63개 태그 사용) 덕분에 모든 툴을 쉽게 발견할 수 있습니다.
- **🔎 없는 툴을 찾아냅니다** — `/find`는 먼저 자체 카탈로그를 검색한 다음 GitHub API를 검색하여, 각 툴이 추천된 이유와 함께 실제 유지 관리되고 있는 프로젝트를 보여줍니다.
- **🛡 기본적으로 안전함** — 표준 설치 방식을 사용하며, **`curl | bash` 방식을 사용하지 않습니다**. 다운로드는 고정(pinned)되어 있으며 SHA-256 검증을 거칩니다. `subprocess`는 리스트 형태로 호출하며, 강제 `sudo`를 요구하지 않고 [SBOM이 포함된 서명된 릴리스](SECURITY.md#verifying-a-release)를 제공합니다.
- **🎯 모든 영역을 아우름** — red team, blue team, OSINT, bug bounty, CTF/THM, forensics/IR까지, 모두 **승인된 대상에 대해서만** 사용할 수 있습니다.

---

## Tool Categories

**21개 카테고리에 걸친 215개의 툴** — 링크와 태그가 포함된 전체 리스트는 **[docs/TOOLS.md](docs/TOOLS.md)**에서 확인하실 수 있습니다.

| # | 카테고리 | 툴 개수 | | # | 카테고리 | 툴 개수 |
|:---:|---|:---:|---|:---:|---|:---:|
| 1 | 🛡 [익명성 유지 툴](docs/TOOLS.md#-anonymously-hiding-tools) | 5 | | 12 | 🔁 [리버스 엔지니어링 툴](docs/TOOLS.md#-reverse-engineering-tools) | 10 |
| 2 | 🔍 [정보 수집 툴](docs/TOOLS.md#-information-gathering-tools) | 26 | | 13 | ⚡ [DDOS 공격 툴](docs/TOOLS.md#-ddos-attack-tools) | 7 |
| 3 | 📚 [워드리스트 생성기](docs/TOOLS.md#-wordlist-generator) | 8 | | 14 | 🖥 [원격 관리 툴 (RAT)](docs/TOOLS.md#-remote-administrator-tools-rat) | 4 |
| 4 | 📡 [무선 공격 툴](docs/TOOLS.md#-wireless-attack-tools) | 17 | | 15 | 🧪 [XSS 공격 툴](docs/TOOLS.md#-xss-attack-tools) | 6 |
| 5 | 💉 [SQL 인젝션 툴](docs/TOOLS.md#-sql-injection-tools) | 7 | | 16 | 🖼 [스테가노그래피 툴](docs/TOOLS.md#-steganography-tools) | 10 |
| 6 | 🎣 [피싱 공격 툴](docs/TOOLS.md#-phishing-attack-tools) | 13 | | 17 | 🏢 [Active Directory 툴](docs/TOOLS.md#-active-directory-tools) | 10 |
| 7 | 🌐 [웹 공격 툴](docs/TOOLS.md#-web-attack-tools) | 23 | | 18 | ☁ [클라우드 보안 툴](docs/TOOLS.md#-cloud-security-tools) | 7 |
| 8 | 🔧 [포스트 익스플로잇 툴](docs/TOOLS.md#-post-exploitation-tools) | 15 | | 19 | 📱 [모바일 보안 툴](docs/TOOLS.md#-mobile-security-tools) | 6 |
| 9 | 🕵 [포렌식 툴](docs/TOOLS.md#-forensic-tools) | 12 | | 20 | ✨ [기타 툴](docs/TOOLS.md#-other-tools) | 10 |
| 10 | 📦 [페이로드 생성 툴](docs/TOOLS.md#-payload-creation-tools) | 6 | | 21 | 🔑 [패스워드 / 해시 크래킹](docs/TOOLS.md#-password--hash-cracking) | 7 |
| 11 | 🧰 [익스플로잇 프레임워크](docs/TOOLS.md#-exploit-framework) | 6 | | | | |

</div>

<sub>추가로 59개의 항목이 보관(유지 관리되지 않거나 상위 프로젝트 중단) 처리되어 있으며, `/config`를 통해 `show_archived true`로 설정하지 않으면 숨겨집니다. 앱 내 헤더에 22개 카테고리 / 217개 툴로 표시되는 이유는 내장된 Update / Uninstall 메뉴가 포함되었기 때문입니다.</sub>

---

## Installation

**Linux 또는 macOS**(Kali, Parrot, Debian/Ubuntu, Arch, …)에서 **Python 3.10+**가 필요합니다. Windows는 지원되지 않으며, 앱 실행 시 이를 알리고 종료됩니다. `curl | bash` 방식은 사용하지 않습니다. 아래의 모든 경로는 표준적이고 검증 가능한 설치 방법입니다.

### From source with pipx (recommended)

[pipx](https://pipx.pypa.io)는 hackingtool을 격리된 자체 환경에 설치하고 `hackingtool` 명령어를 PATH에 추가하여, 어떤 디렉토리에서든 실행할 수 있게 합니다.

```bash
# 1 — 코드 가져오기
git clone https://github.com/Z4nzu/hackingtool.git
cd hackingtool

# 2 — PATH에 설치 (격리된 venv 사용, 시스템 Python에 영향 없음)
pipx install .

# 3 — 어디서나 실행
hackingtool
```

pipx가 아직 설치되어 있지 않나요?

```bash
# macOS
brew install pipx && pipx ensurepath

# Debian / Ubuntu / Kali
sudo apt install pipx && pipx ensurepath
```

`pipx ensurepath` 실행 후 새로운 셸을 열어야 PATH 변경 사항이 적용됩니다.
나중에 업데이트하려면: `git pull && pipx install . --force`. 삭제하려면: `pipx uninstall hackingtool`.

<details>
<summary>Alternative: <code>uv tool install .</code> (동일한 결과, pipx 대신 uv 사용)</summary>

```bash
git clone https://github.com/Z4nzu/hackingtool.git
cd hackingtool
uv tool install .        # PATH에 `hackingtool` 실행 파일 설치
hackingtool
```
</details>

<details>
<summary>Alternative: plain venv + pip (PATH 변경 없음)</summary>

```bash
git clone https://github.com/Z4nzu/hackingtool.git
cd hackingtool
python3 -m venv .venv && . .venv/bin/activate
pip install .            # 또는 편집 가능한 개발 설치를 위해 pip install -e . 사용
hackingtool
```

이 경우 해당 venv가 활성화된 동안에만 명령어를 사용할 수 있습니다.
</details>

### For development

[uv](https://docs.astral.sh/uv/)는 한 단계로 virtualenv를 생성하고 `pyproject.toml` / `uv.lock`의 모든 내용을 설치합니다.

```bash
git clone https://github.com/Z4nzu/hackingtool.git
cd hackingtool
uv sync
uv run hackingtool
```

uv가 아직 설치되어 있지 않나요? `pipx install uv` (또는 [uv 설치 문서](https://docs.astral.sh/uv/getting-started/installation/)를 참조하세요).

**기여하시나요?** `make setup`으로 pre-push 훅을 연결하고 `make check`로 전체 검증(lint + 테스트 + 카탈로그 검증)을 수행합니다. [CONTRIBUTING.md](CONTRIBUTING.md)를 참조하세요.

### Docker

게시된 이미지를 풀(pull)하여 실행하세요.

```bash
docker run -it --rm hardikzinzu/hackingtool:latest
```

또는 로컬에서 빌드하여 실행하세요.

```bash
git clone https://github.com/Z4nzu/hackingtool.git && cd hackingtool
docker build -t hackingtool .
docker run -it --rm hackingtool
```

### Optional runtimes

일부 개별 툴은 설치/실행을 위해 언어 런타임이 필요합니다. 핵심 앱 자체는 필요하지 않습니다.

| 의존성 | 버전 | 필요 툴 |
|---|---|---|
| Go | 1.21+ | nuclei, ffuf, amass, httpx, katana, dalfox, gobuster, subfinder |
| Ruby | any | haiti, evil-winrm |
| tmux | any | 백그라운드 패널 (`/run … &`, `/panes`, `/attach`) |
| Docker | any | Mythic, MobSF (선택 사항) |

---

## Quick Commands

`hackingtool`을 실행하고 입력하세요. 입력 방식은 다음 세 가지뿐입니다.

| 입력 | 의미 | 예시 |
|---|---|---|
| `/…` | 실행할 명령어 | `/search subdomain` |
| `@…` | 지정할 이름 | `@nmap`, `@tag:osint` |
| 그 외 | 일상 영어로 "하고 싶은 일" | `crack a wifi handshake` |

<div align="center">
<img src="images/screenshots/4.png" alt="typing @ in the hackingtool console completes tool names" width="900">
<br/>
<sub><code>@</code>는 툴 이름을, <code>@tag:</code>는 태그를, <code>/</code>는 명령어를 자동 완성합니다.</sub>
</div>

### Command reference

| 명령어 | 별칭 | 설명 |
|---|---|---|
| `/run <tool> [args] [&]` | `/open` | 툴 메뉴 열기; 끝에 `&`를 붙이면 백그라운드 tmux 패널에서 실행 (이때 `args`가 사용됨) |
| `/search <keyword>` | | 이름, 설명 또는 태그로 툴 검색 |
| `/tags` | | 모든 태그와 해당 툴 개수 목록 표시 |
| `/ai <goal>` | `/recommend`, `/r` | 목표에 적합한 툴 추천 |
| `/goal <objective>` | | AI가 목표를 계획하고 단계별로 실행하며, 각 단계마다 확인 절차 진행 |
| `/find <need>` | `/discover` | 필요한 툴 찾기 — 자체 카탈로그 먼저 검색 후 GitHub 검색 (제안만 수행) |
| `/panes` | `/jobs` | 백그라운드 패널 목록 표시 |
| `/attach` | | 백그라운드 세션에 연결 (`Ctrl-b` `d`로 복귀) |
| `/kill <label\|all>` | | 특정 백그라운드 패널 또는 전체 종료 |
| `/config [key value]` | | 설정 보기/변경; `/config test`로 AI 연결 확인, `/config github`로 GitHub 토큰 확인 |
| `/skill` | | 오퍼레이터 플레이북 표시 |
| `/update` · `/uninstall` | `/remove` | 시스템 패키지 또는 hackingtool 업데이트 · hackingtool 및 설치된 툴 삭제 |
| `/clear` | `/cls` | 화면 지우기 |
| `/back` | `/b` | 현재 툴에서 나가기 |
| `/help` | `/?`, `/h` | 빠른 참조 카드 표시 |
| `/quit` | `/q`, `/exit` | 종료 (또한 `q`, `Ctrl-C`, `Ctrl-D` 가능) |
| `@<tool>` | | 툴 열기 (대소문자 구분 없음, 퍼지 매칭 지원) |
| `@tag:<tag>` | | 해당 태그를 가진 툴 목록 표시 및 선택 |

카테고리 내부: `1–N` 툴 선택 · `97` 설치되지 않은 모든 툴 설치 · `98` 보관된 툴 · `99` 뒤로 가기.
툴 내부: `1` 설치 · `2` 실행 · `c` 목표에 맞는 정확한 명령어 요청 · `98` 프로젝트 페이지 · `99` 뒤로 가기.

<div align="center">
<img src="images/screenshots/5.png" alt="hackingtool /help quick reference card" width="900">
<br/>
<sub><code>/help</code> — 앱 내에서 확인할 수 있는 동일한 참조 카드입니다.</sub>
</div>

비대화형 터미널(또는 `prompt_toolkit`이 없는 환경)에서 hackingtool은 클래식 숫자 메뉴 방식으로 동작합니다. 여기서 `/` 또는 `s`는 검색, `t`는 태그 필터링, `r` 또는 `a`는 추천, `?`는 도움말, `q`는 종료입니다. `hackingtool --classic`으로 강제 실행할 수 있습니다.

> **처음 사용하시나요?** [docs/HOW-TO-USE.md](docs/HOW-TO-USE.md)에서 단계별 가이드를 통해 상세히 알아보세요.

---

## Features

### 🔎 `/find` — 아직 가지고 있지 않은 필요한 툴 찾기

먼저 215개의 엄선된 툴을 검색한 다음, GitHub 검색 API를 통해 결과를 찾고 그 이유를 설명하며 순위를 매깁니다. **제안 전용** 기능으로, 자동으로 클론, 설치 또는 실행하지 않으며 **모델 호출을 전혀 하지 않습니다**.

```
/find crack a wpa handshake

In your toolbox (vetted)
  • aircrack-ng (WiFi security suite)
  • Kismet (wireless detector / WIDS)
  • Reaver (WPS PIN attack)
  • WiGLE (wardriving map & API)
  • hashcat example hashes (WPA mode 22000)

Found on GitHub — NOT vetted by us

wifiphisher/wifiphisher  14713★  GPL-3.0
    The Rogue Access Point Framework
    14713★ · trusted author (ships in our catalog) · active · matches: security, wifi
    git clone https://github.com/wifiphisher/wifiphisher
  …
```

`a`를 눌러 결과를 유지하면 `~/.hackingtool/found.yaml`에 "Discovered tools" 항목으로 저장됩니다(제목, 태그, 설명, 링크 포함). **설치 또는 실행 명령어가 포함되지 않으므로**, 발견된 항목이 임의로 실행될 위험이 없습니다. 저장된 항목은 다음 실행 시 메뉴와 `/search`에 나타납니다.

범위를 벗어난 요청(재밍, DoS, 대량 타겟팅, 악성코드)은 **네트워크 호출 전**에 거부되며, 가능한 경우 승인된 대안을 제시합니다. 방어적/DFIR 관련 요청은 거부되지 않습니다.

GitHub 검색 API를 통해 분당 10회 익명 검색이 가능하며, **권한 없는(no-scope, no-permission)** 토큰을 설정하면 분당 30회로 늘어납니다. [`/config github`](docs/HOW-TO-USE.md#7-add-a-github-token-for-find-config-github)를 참조하세요.

### 🎯 `/goal` — 목표 계획 및 단계별 실행

```
/goal find live subdomains of example.com
```

hackingtool이 실제 명령어들로 구성된 간단한 계획(각 단계의 이유와 미설치 툴에 대한 설치 힌트 포함)을 작성합니다. 그 후 타겟 테스트에 대한 **권한(authorized)**이 있는지 확인을 요청하고, 단계를 진행합니다: `[y]` 실행 · `[s]` 건너뛰기 · `[e]` 수정 · `[q]` 중단. 모든 단계는 셸을 통하지 않고 리스트 형태로 실행되며, 각 목표는 `~/.hackingtool/goals/` 아래에 타임스탬프가 찍힌 워크스페이스(`plan.json`, UTC 타임스탬프가 찍힌 `run.log`, 각 단계의 원본 출력 결과 포함)를 생성합니다.

모델은 계획 수립 시 **단 한 번** 호출되며, 툴의 출력 결과가 모델로 다시 피드백되지 않습니다. 모델이 설정되지 않은 경우, `/goal`은 동일한 목표에 대한 툴 추천 기능으로 동작합니다.

### 🧠 Recommendations — 일상 영어로 원하는 작업 말하기

단순 텍스트(또는 `/ai`) 입력은 의도를 툴에 매핑합니다. 모델은 고정된 분류 체계의 태그만 반환할 수 있으며, 카탈로그가 태그를 툴로 해석하므로 툴이 임의로 "발명"될 수 없습니다. 모델에 연결할 수 없는 경우 표준 라이브러리 키워드 매칭 방식으로 응답합니다.

<div align="center">
<img src="images/screenshots/3.png" alt="hackingtool /ai — pick a common task or describe your own" width="900">
<br/>
<sub><code>/ai</code> — 일반적인 작업 중 하나를 선택하거나, 본인의 말로 작업을 입력하세요.</sub>
</div>

### 🏷 Tags and search

`/tags`는 사용 중인 모든 태그와 실시간 툴 개수를 출력합니다. `@tag:<name>`은 해당 태그를 가진 툴들을 열고, `/search <keyword>`는 이름, 설명 및 태그를 검색합니다.

<div align="center">
<img src="images/screenshots/2.png" alt="hackingtool /tags — every tag with its tool count" width="900">
<br/>
<sub><code>/tags</code> — 사용 중인 63개의 태그와 각 태그별 툴 개수입니다.</sub>
</div>

### ▶ Background panes (tmux)

시간이 오래 걸리는 스캔이 콘솔을 차단해서는 안 됩니다. tmux가 설치되어 있다면, `/run <tool> … &`를 통해 분리된 하나의 `hackingtool` 세션 내에 이름이 지정된 창을 열 수 있습니다.

```
/run nmap -sV -oA scan 10.0.0.5 &
▶ started 'nmap' in background — /attach to view
```

`/panes`로 목록을 확인하고, `/attach`로 관찰하며 (`Ctrl-b` `d`로 복귀), `/kill <label>` 또는 `/kill all`로 종료합니다. 프롬프트 아래 상태 줄에 `▶ N running`으로 표시됩니다. tmux가 없다면 안내 메시지와 함께 툴을 인라인으로 실행합니다. 이 기능을 완전히 끄려면 `/config background_runner off`를 설정하세요.

### ⚙ Settings and the AI layer

`/config`는 전체 화면 설정 편집기를 엽니다(`↑↓` 이동, `←→` 변경, `Enter` 편집, `t` 연결 테스트, `Esc` 닫기). `/config <key> <value>`를 통해 프롬프트에서 직접 설정을 변경할 수 있습니다. 설정은 `~/.hackingtool/config.json`에 저장됩니다.

AI 레이어는 **선택 사항(opt-in)이며 사용자가 직접 키를 제공(bring-your-own-key)**해야 합니다. `ai_base_url`과 API 키가 설정되면 OpenAI 호환 엔드포인트를 사용하고, 그렇지 않으면 로컬 [Ollama](https://ollama.com)를 사용하며, 둘 다 없다면 아무것도 사용하지 않습니다. 모든 기능은 추측 대신 결정론적인 오프라인 동작으로 대체됩니다. API 키는 `~/.hackingtool/.env`(모드 600)에만 기록되며, `config.json`에 저장되거나 화면에 출력되지 않습니다. `/config test`는 프로브 실패 시 실제 원인을 보고합니다.

### 📋 Headless engagements

동일한 카탈로그가 비대화형 오케스트레이터를 구동하여 툴 출력 결과를 하나의 `findings.json`으로 정규화합니다.

```bash
hackingtool --engagement acme --targets example.com --pipeline recon
hackingtool --engagement acme --report          # 결정론적인 Markdown 보고서
hackingtool --engagement acme --ai-summary      # 실제 발견 내용에 대한 선택적 분류 및 분석
hackingtool --engagement acme --ai-report       # 선택적 서술형 초안 작성 (report.draft.md)
```

범위를 벗어난 타겟은 실행 전 플래그가 지정되고 기록되며, AI 요약은 실제로 존재하는 발견 내용만을 요약합니다.

---

## Documentation

| 문서 | 내용 |
|---|---|
| [How to use hackingtool](docs/HOW-TO-USE.md) | 단계별 가이드: 첫 실행, `/find`, `/goal`, `/config`, 백그라운드 패널, 헤드리스 모드 |
| [Tool catalog](docs/TOOLS.md) | 카테고리별 모든 툴 리스트, 링크 및 태그 포함 |
| [Operator playbook](src/hackingtool/skill/OPERATOR.md) | AI 레이어가 따르는 헌장 및 기본 규칙 (또한 `/skill`로 확인 가능) |
| [SECURITY.md](SECURITY.md) | 취약점 제보 정책, 릴리스 검증, 위협 모델 |
| [CONTRIBUTING.md](CONTRIBUTING.md) | 카탈로그 우선 툴 추가 방법 및 PR 통과 기준 |

---

## Contributing

새로운 툴, 수정 사항, 문서 기여를 환영합니다 — 단, **승인된 보안 테스트** 용도로만 사용하십시오.

> **쉬운 방법:** 대부분의 툴은 `src/hackingtool/catalog/`에 **YAML 항목 하나**만 추가하면 됩니다 — Python 코딩이 필요 없습니다. 태그는 고정된 분류 체계에서 가져오므로, 추가한 툴을 즉시 발견하고 검색할 수 있습니다.

| 원하는 작업 | 방법 |
|---|---|
| 💡 툴 제안 | [Tool Request](.github/ISSUE_TEMPLATE/tool_request.md) 이슈 생성 |
| ➕ 툴 추가 | 카탈로그 항목 추가 (또는 커스텀 설치/실행 로직을 위한 클래스 작성) 후 [템플릿](.github/PULL_REQUEST_TEMPLATE.md)에 맞춰 PR 생성 |
| 🐛 버그 보고 | [Bug report](.github/ISSUE_TEMPLATE/bug_report.md) 이슈 생성 |
| 🔒 취약점 보고 | **비공개로** 보고하십시오. 공개 이슈를 생성하지 말고 [SECURITY.md](SECURITY.md)를 참조하세요. |

PR을 생성하기 전에 **`make check`**(lint + 테스트 + 카탈로그 검증)를 실행하고, 제목 형식을 `[New Tool] Name — Category`로 작성해 주세요. 보안 규칙과 카탈로그 추가 가이드가 포함된 전체 안내서는 **[CONTRIBUTING.md](CONTRIBUTING.md)**에 있습니다.

<sub>📄 [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md) · [Code of Conduct](CODE_OF_CONDUCT.md)</sub>

---

## Support & Sponsor

hackingtool은 무료 오픈 소스 프로젝트입니다. 이 툴이 여러분의 업무 시간을 줄여주거나 학습에 도움이 되었다면, 스폰서를 고려해 주세요. 후원금은 툴 큐레이션, AI 레이어 발전, 그리고 안전하고 최신 상태의 설치 환경 유지에 사용됩니다.

⭐ 리포지토리에 별을 달아주시는 것만으로도 다른 사람들이 이 프로젝트를 발견하는 데 큰 도움이 됩니다.

## Social

[![Twitter](https://img.shields.io/badge/Twitter-Follow-1DA1F2?style=for-the-badge&logo=twitter&logoColor=white)](https://twitter.com/_Zinzu07) [![GitHub](https://img.shields.io/badge/GitHub-Follow-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/Z4nzu/)

> **승인된 보안 테스트 전용입니다.**
> hackingtool에 포함된 모든 툴의 원작자분들께 감사드립니다.

즐겨 찾는 툴이 목록에 없나요? [여기에서 제안해 주세요](https://github.com/Z4nzu/hackingtool/issues/new?template=tool_request.md)

hackingtool

Was this content helpful?

Recent Feedback

Download README