🎀 Caesar Bundle 🎀

A cute but lethal toolkit for AI-assisted OSINT, stealth web research, and async media harvesting ✨

[!TIP]
Haii, welcome to my secret diary! ✨ This is a cozy, self-contained toolkit designed specifically for AI-assisted cyber sleuthing. We are doing serious OSINT, but keeping it aesthetic and organized 💅🏻. Everything runs on a stealthy patched qutebrowser. 🌸

🍰 The Cute Little Toolbox 🍰

You thought it was just a simple script? Oh honey, no! 💅🏻 This bundle is a massive interconnected ecosystem. Click below to peek inside! 👀

🎀 1. qb (The Ultimate Command Bridge)
This isn't just a simple bridge; it's the control center for your browser. It uses JSON envelopes, CDP, and IPC to talk to qutebrowser.

qb CLI: The main executable that sends commands.
qb-mcp-server.py: A dedicated Model Context Protocol (MCP) server so your AI can directly command the browser. 🤖
qb_cdp_smoke & qb_cdp_smoke2: Cute little automated smoke tests to ensure your CDP connection is flawlessly working.
qb-skill: A skill library installer that imports and indexes your agent skills.

🧠 2. caesar-osint-skill (The Brains of the Operation)
This is where the magic methodology lives. Drop this into Claude Code, and your AI instantly becomes a master investigator.

SKILL.md: The doctrinal rulebook featuring a rigorous 12-phase OSINT methodology.
references/: 14 detailed reference documents acting as the AI's knowledge base.
workflows/: 4 automated JS workflows for specific intel gathering scenarios.
caesar-vision/: A specialized multimodal sub-skill designed exclusively to review and categorize thumbnails from the porn-harvester catalog! 📸

📓 3. caesar-suite (Your Personal Detective Notebook)
The absolute best way to manage your cases. It organizes everything into a DuckDB database so you never lose a single finding.

bin/caesar: The main CLI tool to manage cases, entities, edges, and events.
misc/caesar-mcp-server.py: An MCP server so your AI can read and write directly to your case files.
misc/caesar-url-handler: Handles custom caesar:// URLs right from your browser!
src/ & docs/: The complete Python library (caesar_lib) backing the whole suite, complete with beautiful Excalidraw mindmap export capabilities. 🎨

✨ 4. qute-caesar (The Star of the Show)
We couldn't just use a normal browser. We took qutebrowser v3.7.0 and made it stealthy and powerful.

patches/: A massive series of custom patches applied to the browser source. It unlocks an in-tab terminal, RPC over Unix sockets, advanced stealth modes, and lightning-fast FTS5 history search.
bin/qute-caesar: The custom launcher with CDP auto-fallback.
bin/qute-tor: A specialized launcher that routes all your traffic quietly through Tor (perfect for when you need to be a ghost 👻).

🎬 5. porn-harvester (The Async Archiver)
A highly specialized, asynchronous multi-tube video archiver. It runs totally independently of the OSINT suite but perfectly complements it.

porn_harvester/: The core application, utilizing arq workers and a Redis queue.
Adapters: 13 custom tube adapters to safely scrape and harvest media.
seeds.example.toml: Your cute little template for setting up seed queries.
DuckDB Catalog: All harvested metadata is stored neatly in DuckDB, which the caesar-vision skill uses to perform AI thumbnail reviews. 🍒

💌 How the Magic Connects 💌

Here is the absolute tea on how the architecture flows! ☕️

[!NOTE]
The 🌸 Claude Code Agent is the mastermind here, controlling both the browser and the database through MCP protocols!

graph TD
    %% 🧠 AI Intelligence Layer
    subgraph LayerAI [🧠 AI Intelligence Layer]
        A[🌸 Claude Code Agent]
        SKILL[📜 caesar-osint-skill]
        VISION[📸 caesar-vision]
        WORKFLOWS[⚙️ Automated JS Workflows]
        
        A -.->|Loads| SKILL
        A -.->|Loads| VISION
        A -.->|Executes| WORKFLOWS
    end

    %% 🌉 Command & Control Bridge
    subgraph LayerBridge [🌉 Command & Control Bridge]
        MCP_QB[🔌 qb-mcp-server.py]
        MCP_CAESAR[🔌 caesar-mcp-server.py]
        QB[🎀 qb CLI]
        CAESAR_CLI[🎀 caesar CLI]
        
        A -->|MCP Protocol| MCP_QB
        A -->|MCP Protocol| MCP_CAESAR
        MCP_QB -->|Triggers| QB
        MCP_CAESAR -->|Triggers| CAESAR_CLI
    end

    %% 📓 OSINT & Case Management Layer
    subgraph LayerData [📓 Data & Case Management]
        SUITE[📓 caesar-suite Python Lib]
        DUCK_CASE[(🦆 Case DuckDB)]
        EXCALI[🎨 Excalidraw Mindmap]
        
        CAESAR_CLI -->|Calls| SUITE
        SUITE -->|Read and Write| DUCK_CASE
        SUITE -.->|Generates| EXCALI
    end

    %% 🌐 Browser & Stealth Layer
    subgraph LayerBrowser [🌐 Browser & Stealth Layer]
        QUTE[✨ qute-caesar Patched]
        TOR[👻 qute-tor Tor Routed]
        FTS[🔍 FTS5 History Index]
        
        QB -->|CDP and caesar-rpc| QUTE
        QB -->|CDP and caesar-rpc| TOR
        QUTE -->|Writes| FTS
        TOR -->|Writes| FTS
    end

    %% 🎬 Harvester Layer
    subgraph LayerHarvester [🎬 Video Harvesting Pipeline]
        PH[🎬 porn-harvester]
        ARQ[⚙️ arq Workers]
        REDIS[(🔴 Redis Queue)]
        DUCK_MEDIA[(🍒 Catalog DuckDB)]
        ADAPTERS[🔌 13 Tube Adapters]
        
        PH -->|Enqueues Tasks| REDIS
        REDIS -->|Dispatches| ARQ
        ARQ -->|Uses| ADAPTERS
        ADAPTERS -->|Saves Metadata| DUCK_MEDIA
    end

    %% ✨ Cross-layer Interactions
    VISION -.->|Queries Thumbnails| DUCK_MEDIA
    SKILL -.->|Defines Rules for| QUTE

qb controls the browser. It really shines and gets the super-fast caesar-rpc path when paired with qute-caesar.
caesar-suite keeps all your tea (findings, evidence, entities) neat and tidy in DuckDB.
caesar-osint skill is the brain. Drop it into your Claude Code skills directory! 👩🏻‍💻
qute-caesar is the stealthy browser.
porn-harvester is the independent async worker. Its catalog is reviewed by the caesar-vision skill! ✨

🛠️ Let's Set It Up! (Step-by-Step) 🛠️

Grab a coffee ☕️, open your terminal, and let's get everything installed!

Step 1: The Foundation: Browser First 🌐
Let's install the patched browser to unlock all the stealthy features.

cd qute-caesar
./install.sh ~/projects/qutebrowser-caesar
# Follow the build steps inside qute-caesar/README.md!
install -Dm755 bin/qute-caesar ~/.local/bin/qute-caesar

Step 2: The Bridge: qb CLI 🌉
Now we set up the tool that talks to the browser.

cd ../qb
install -Dm755 qb               ~/.local/bin/qb
install -Dm755 qb_cdp_smoke      ~/.local/bin/qb_cdp_smoke
install -Dm755 qb_cdp_smoke2     ~/.local/bin/qb_cdp_smoke2
install -Dm755 qb-mcp-server.py  ~/.local/bin/qb-mcp-server.py

# Verify it works! ✨
qb --help

Step 3: The Notebook: caesar-suite 📓
Time to organize our case files!

cd ../caesar-suite
ln -sf "$(pwd)/bin/caesar" ~/.local/bin/caesar
install -Dm755 misc/caesar-mcp-server.py ~/.local/bin/caesar-mcp-server.py
install -Dm755 misc/caesar-url-handler   ~/.local/bin/caesar-url-handler
install -Dm644 misc/caesar-handler.desktop ~/.local/share/applications/caesar-handler.desktop

# Update your desktop database softly~ 🌸
update-desktop-database ~/.local/share/applications/ 2>/dev/null || true

# Link the python library!
mkdir -p ~/.local/lib/python
ln -sf "$(pwd)/src/caesar_lib" ~/.local/lib/python/caesar_lib

Step 4: The Brains: AI Skills 🧠
Make your Claude Code super smart!

mkdir -p ~/.claude/skills/caesar-osint ~/.claude/skills/caesar-vision ~/.claude/workflows
cp -r caesar-osint-skill/SKILL.md caesar-osint-skill/references ~/.claude/skills/caesar-osint/
cp -r caesar-osint-skill/caesar-vision/* ~/.claude/skills/caesar-vision/
cp caesar-osint-skill/workflows/*.js ~/.claude/workflows/

Step 5: Optional: porn-harvester 🍒
Only if you need the video cataloging and vision pipeline!

cd ../porn-harvester
uv sync  # Install dependencies smoothly with uv ✨
cp seeds.example.toml seeds.toml  # Time to customize your seeds!
# Edit your seeds.toml, then start the worker!
make worker &

🧪 Smoke Test (Did it work?) 🧪

Let's do a quick vibe check to make sure everything is running perfectly!

# Launch the browser in the background!
qute-caesar --temp-basedir &

# Test the bridge
qb cdp-smoke
qb open https://example.com
qb dom-query h1
qb screenshot /tmp/test_cute.png 📸

# Start a cute little demo case!
caesar case new --slug demo --title "smoke test"
caesar entity add --case demo --type person --name "Test Subject"
caesar mindmap render --case demo --out /tmp/demo.excalidraw 🎨

🔒 Privacy & Security Check 🔒

[!WARNING]
We take OPSEC seriously, even when we make it look cute! 🛡️ Before this bundle was packaged, it went through a rigorous privacy review.

Here is what was sanitized before sharing:

🏡 Paths: All hardcoded home paths were replaced with safe Path.home() or ~.
🕵🏻‍♀️ Identities: Neutralized identity references in SKILL.md to just Operator.
🔑 Secrets: Absolutely zero .git history, DB files, env variables, or keys were shipped!
🍒 Harvester: No caches, logs, or media files are included. Only a sanitized seeds.example.toml template!
🤖 Attribution: Patch commits retain a cute neutral Co-Authored-By: Claude trailer.

If you ever want to strip out the Claude co-author tags, just run this:

cd qute-caesar/patches
sed -i '/^Co-Authored-By: Claude/d' *.patch

📜 Compatibility & Licenses 📜

Where does it run?

🐧 Linux (Tested on Arch / CachyOS, Kernel 7.x)
🐍 Python 3.10+ (for qb) and 3.11+ (for caesar-suite)
🌐 Works flawlessly on Linux and macOS! (Windows is untested, sorry babes 🥺).

Licenses:

qutebrowser patches -> GPL-3.0-or-later
qb -> GPLv3 spirit
caesar-suite -> Source-available
porn-harvester -> Source-available (Please verify local laws before running this one! ⚖️)

Have fun investigating, stay stealthy, and keep it cute! 💕✨

Made with 💕 by Queen Fiona & Caesar

caesar-bundle