Overview

cookiepal is the single entry point. Run it with no arguments to open an interactive menu, or pass a subcommand to go straight to work.

Subcommands

• cookiepal crawl <url> — crawl a site and inventory cookies.
• cookiepal dashboard — launch the local React UI and HTTP API.
• cookiepal build — package the banner as a drop-in script, or render the config as TypeScript with --format=config.

Where state lives

Every subcommand reads and writes one SQLite file — crawl populates what dashboard edits and what build ships. The file lives in a user-global location resolved with env-paths:

• Linux: ~/.config/cookiepal/db.sqlite
• macOS: ~/Library/Preferences/cookiepal/db.sqlite
• Windows: %APPDATA%\cookiepal\Config\db.sqlite

Override by setting $COOKIEPAL_DB before invoking any subcommand.