https://github.com/lordbuffcloud/ck42x-pl-arch
https://github.com/lordbuffcloud/ck42x-pl-arch
Last synced: 17 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/lordbuffcloud/ck42x-pl-arch
- Owner: lordbuffcloud
- Created: 2026-05-29T20:17:38.000Z (19 days ago)
- Default Branch: main
- Last Pushed: 2026-05-29T21:08:15.000Z (19 days ago)
- Last Synced: 2026-05-29T22:10:03.153Z (19 days ago)
- Language: Python
- Size: 35.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ck42x-pl-arch
**CK42X Payload Lab Architect** — a cross-platform TUI for authorized Flipper Zero training labs.
Source: https://github.com/lordbuffcloud/ck42x-pl-arch
Forge mission bundles:
| Artifact | Use |
|----------|-----|
| `launch-.txt` | Flipper BadUSB / Payload Bay inject |
| `agent-.ps1` | Windows host agent |
| `agent--linux.sh` | Linux host agent |
| `agent--mac.sh` | macOS host agent |
| `manifest.json` | Metadata + reviewer notes |
## Install (website one-liner)
**Linux / macOS**
```bash
curl -fsSL https://www.ck42x.com/install/ck42x-pl-arch.sh | bash
```
**Windows (PowerShell)**
```powershell
irm https://www.ck42x.com/install/ck42x-pl-arch.ps1 | iex
```
## Run
```bash
ck42x # interactive TUI (alias: ck42x-pl-arch)
ck42x forge --title "repo-check" --goal "Safe git health snapshot" --deploy
ck42x deploy --slug repo-check # flash last bundle to Flipper
```
### Deploy to Flipper (USB serial)
After forging a Windows handoff mission, `ck42x` can:
1. Upload `launch-.txt` to `/ext/ck42x-payloads/` (Flipper BadUSB payload).
2. Place `agent-.ps1` on the PAYLOADBAY Exfil Disk under `scripts/` — either by copying to an already-mounted `PAYLOADBAY` volume, or by patching `payloadbay.img` and uploading it to `/ext/apps_data/mass_storage/payloadbay.img`.
Requirements: Flipper on the normal desktop (not USB Storage mode), qFlipper closed, Python deps installed (`pyserial`, `pyfatfs`). Set `flipper_port` to `COM10` (or your port) in `~/.config/ck42x-pl-arch/config.json` if auto-detect fails.
## Config
`~/.config/ck42x-pl-arch/config.json`
- `DEEPSEEK_API_KEY` env var is also read when forging with AI agents
- Output default: `~/Documents/CK42X-PL-Arch/missions/`
## Dev
```bash
cd ck42x-pl-arch
python3 -m venv .venv && .venv/bin/pip install -e .
.venv/bin/ck42x-pl-arch
```
## Safety
Authorized lab systems only. No keys in generated payloads. Review all artifacts before inject.