CLI Reference
CLI reference for Invoked — command-line flags, environment variables, and launch options for the MCP-native agent tooling desktop app.
Invoked is primarily a GUI application, but it accepts several command-line flags useful for development, automation, and debugging.
Launching Invoked
# Standard launch
open -a Invoked
# Launch with a specific workspace
/Applications/Invoked.app/Contents/MacOS/Invoked --workspace ~/my-project
# Launch with DevTools open
/Applications/Invoked.app/Contents/MacOS/Invoked --devtools
# Launch with verbose logging
/Applications/Invoked.app/Contents/MacOS/Invoked --log-level debugLaunch flags
| Flag | Description |
|---|---|
--workspace <path> | Open a specific workspace directory on launch |
--devtools | Open Electron DevTools immediately on start |
--log-level <level> | Set log verbosity: error, warn, info, debug |
--reset-db | Clear the local SQLite database (use with caution) |
Environment variables
These can be set in a .env file alongside the app or in your shell environment:
| Variable | Description |
|---|---|
VITE_KNOCK_PUBLIC_KEY | Knock public key for in-app notifications |
VITE_KNOCK_FEED_CHANNEL_ID | Knock feed channel ID |
VITE_TINYBIRD_URL | Tinybird API base URL |
VITE_TINYBIRD_INGEST_TOKEN | Tinybird write token for analytics |
Application logs
Logs are written to:
~/Library/Logs/Invoked/main.logMonitor in real time:
tail -f ~/Library/Logs/Invoked/main.logOr open Console.app, filter by process name Invoked.
Development (running from source)
git clone https://github.com/sonicbadger/invoked
cd invoked
npm install
npm run devDevTools are available via ⌘⌥I while running in dev mode.