wave-bridge

Bridge between Windows (Waveterm master) and Kali Linux (SSH slave) using Wave AI + SCP.

---

📋 Overview

wave-bridge automates file creation and transfer between a Windows host running Waveterm and a remote Kali Linux machine connected via SSH.

The workflow:

1. From Kali, request a file via wave-request.sh
2. Wave AI generates the file on Windows (D:\SCRIPT_WAVE\)
3. wave-send.ps1 detects the new file and pushes it to Kali via SCP automatically

┌─────────────────────────────────────────────────────┐
│                                                     │
│   Kali (slave)          Windows (master)            │
│                                                     │
│  wave-request.sh  ──►  Wave AI creates file         │
│                         wave-send.ps1 detects  ──►  │
│  ~/wave/ receives  ◄── SCP push                     │
│                                                     │
└─────────────────────────────────────────────────────┘

---

🖼️ Screenshots

1. Waveterm running with Groq AI configured

2. wave-send.ps1 running in Watch mode (Windows)

3. wave-request.sh full flow (Kali)

---

⚙️ Requirements

Side	Requirement
Windows	Waveterm, OpenSSH client, PowerShell
Kali	SSH access to Windows host, wsh in PATH
Both	SSH key auth configured (no password)

---

🚀 Quick Start

Windows side

1. Copy windows/wave-send.ps1 to D:\SCRIPT_WAVE\
2. Start the file watcher:

cd D:\SCRIPT_WAVE
.\wave-send.ps1 -Watch

Kali side

1. Copy kali/wave-request.sh to your preferred directory
2. Make it executable:

chmod +x wave-request.sh

3. Request a file:

./wave-request.sh "create a script that lists open ports" ports.sh
./wave-request.sh "python hello world" hola.py /home/noname/projects/

---

📁 Repository Structure

wave-bridge/
├── README.md                  ← You are here
├── README.es.md               ← Versión en español
├── windows/
│   ├── README.md              ← Windows setup guide
│   └── wave-send.ps1          ← File watcher + SCP push
├── kali/
│   ├── README.md              ← Kali setup guide
│   └── wave-request.sh        ← AI request + file receiver
└── scripts/
    ├── README.md              ← Index of generated scripts
    └── ports.sh               ← List open ports (Linux)

---

🔧 Wave AI Configuration

AI is configured in ~/.config/waveterm/waveai.json. This repo uses Groq (free tier):

{
  "groq-llama": {
    "display:name": "Groq / Llama 3.3 70B",
    "display:order": 1,
    "display:icon": "bolt",
    "ai:provider": "groq",
    "ai:model": "llama-3.3-70b-versatile",
    "ai:capabilities": ["tools"]
  }
}

Store your API key securely:

wsh secret set GROQ_KEY=gsk_xxxxxxxxxxxxxxxx
wsh setconfig waveai:defaultmode="groq-llama"

---

📄 License

MIT

---

🌐 Versión en Español

Ver README.es.md