hartle-tech/medusa
1
0
Fork 0
Code Issues 12 Pull requests Projects Releases Packages Wiki Activity Actions
ESP32-S3 microcontroller pentest research, in a phone case. Companion to NearTrace, sibling to Nosferato. A HARTLE.TECH research project. https://hartle.tech
13 commits 1 branch 0 tags 692 KiB
  • JavaScript 54.8%
  • Shell 45.2%
Find a file
Exact
hartle-tech a1251f6cd2
 fix(k8s S01E37): drop broken single-line log block in in-pod Caddyfile 
Caddyfile syntax requires newlines after `{` — single-line semicolon-
separated `log { output stdout; format console; level WARN }` fails
with: adapting config using caddyfile: Unexpected next token after
'{' on same line, at /etc/caddy/Caddyfile:12

Caddy default log behavior is fine; drop the block entirely.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-17 00:19:55 +01:00
.claude feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00
.github feat(k8s S01E37): containerize docs + landing for k3s migration 2026-05-16 23:24:04 +01:00
assets/brand feat(brand S01E37 #15): v2 dark venom-snake palette across docs + wiki + landing 2026-05-16 18:55:05 +01:00
docs fix(k8s S01E37): drop broken single-line log block in in-pod Caddyfile 2026-05-17 00:19:55 +01:00
.gitignore feat(docs): VitePress site for medusa.hartle.tech (/docs + /wiki + landing) 2026-05-16 11:36:44 +01:00
.mcp.json feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00
CLAUDE.md feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00
LICENSE feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00
MISSION.md feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00
NOTICE feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00
README.md feat(seed S01E37): bootstrap medusa — ESP32-S3 pentest phone case research project 2026-05-16 04:18:41 +01:00

README.md

🐍 Medusa

Embedded wireless-recon research, paired with a phone for the UI.

Medusa is a HARTLE.TECH research project: an ESP32-S3 microcontroller inside a phone case, talking to a companion mobile app over BLE/USB. The MCU does the radio work (WiFi monitor mode, BLE scanning, ESP-NOW); the phone gives you the screen, buttons, and human factors. Together: a pocketable, low-power, defensive-network-posture analysis tool.

Sibling to Nosferato (single-board-computer lane, Pi Zero 2 W) and NearTrace (Android BLE scanner / planned UI). Part of the broader phone-as-UI hacking-case-kit arc.

Status

🚧 Bootstrap. Repo seeded 2026-05-16. Hardware BOM + firmware scaffold + project-board issues are the next visible milestones. Star/watch the repo if you want to follow along.

What it does (and doesn't)

Medusa is for lawful use on networks you own, administer, or have written authorization to test. Specifically built for:

  • Security researchers auditing their own infrastructure
  • Network operators looking for rogue devices and policy violations
  • Educators and CTF participants
  • Curious humans who want to understand what their phone, watch, and laptop are actually broadcasting

It is not packaged or supported for unauthorized network intrusion. HARTLE.TECH does not document offensive utility against third parties. The lawful-use statement in NOTICE is binding for any fork or derivative.

Hardware

  • MCU: ESP32-S3 (WROOM-1 module recommended for case fit)
  • Power: USB-C passthrough + small lipo (running BOM TBD)
  • Form factor: phone-case shaped, slimline

Full BOM + schematic sketch in hardware/.

Companion

The intended UI is a phone app — NearTrace today, possibly a dedicated Medusa app later. The MCU exposes a small JSON protocol over BLE; the app renders. See design/api-spec.md.

Project layout

medusa/
  hardware/         # BOM, schematic sketches, power budget, form factor
  design/           # architecture, threat model, API spec
  research/         # ecosystem survey, legal frame, companion design
  assets/brand/     # mascot, brand_tokens, brief
  firmware/         # ESP32-S3 source (PlatformIO project, future)
  docs/external/    # public VitePress site (medusa.hartle.tech, future)
  MISSION.md        # project mission + non-negotiables
  CLAUDE.md         # house rules for Claude Code sessions

License

Apache 2.0 — see LICENSE and NOTICE for the attribution requirement (Medusa — © HARTLE.TECH must travel with any fork / repackaging).

Contact

contact@hartle.tech — HARTLE.TECH (NIPC 518241327, Porto, Portugal).