Chapter 20 — Quick Reference (Cheat Sheet)
A single printable page. Every CLI flag, environment variable, file path, default port, and shortcut consolidated. The rest of the guide explains why; this chapter tells you what to type.
Tip: press Ctrl+P in your browser to print just this page. The tables below render cleanly to A4 / Letter.
Command-line flags
Pass these when you launch AidaIDE from a terminal.
| Flag | What it does | See |
|---|---|---|
--safe-mode |
Skip plugins, default theme, default settings. Use to isolate whether a bug is in core or in third-party code. | Ch. 18 §Safe mode |
--log-level=DEBUG |
Verbose logging to ~/.aidaide/logs/aidaide.log. Use for one reproduction; revert (the log gets large). |
Ch. 18 §Verbose / debug log mode |
--no-splash |
Skip the 4-second $_ reveal. Same effect as AIDA_SPLASH=off. |
Ch. 1 §Splash screen |
--workspace <path> |
Open AidaIDE pre-loading a saved workspace JSON. | Ch. 16 §Opening a workspace |
--project <path> |
Open AidaIDE with the given folder as the project root. | Ch. 3 §Opening files and projects |
--reset-vault |
Force the vault reset prompt on launch (equivalent to Forgot password? Reset vault). Destructive — every stored secret is wiped. | Ch. 1 §Unlocking the vault |
Launch from a terminal so you can see startup errors. On Windows the executable is "C:\Program Files\AidaIDE\aidaide.exe"; on macOS/Linux the binary is aidaide.
Environment variables
| Variable | Values | Effect |
|---|---|---|
AIDA_SPLASH |
lite (default), full, off |
Splash animation mode. full enables the 1,400-glyph code rain; off skips the splash. |
ANTHROPIC_API_KEY |
a long random string | Used by Claude Agent Manager if no key is set in the vault. The vault always wins when both are present. |
OPENAI_API_KEY |
a long random string | Same as above, for OpenAI provider. |
AIDA_LOG_DIR |
absolute path | Overrides the default ~/.aidaide/logs/ location. |
AIDA_NO_TELEMETRY |
1 |
Disables anonymous usage telemetry. Same as Settings → General → Telemetry → Off. |
AIDA_THEME |
theme name | Forces a theme on launch, overriding the saved preference. |
AIDA_DISABLE_PLUGINS |
1 |
Equivalent to --safe-mode. Useful when you cannot pass CLI flags (e.g. launched by a desktop shortcut). |
Environment variables apply per shell session. To set them permanently: PowerShell profile ($PROFILE), bash ~/.bashrc, zsh ~/.zshrc, or System Properties → Environment Variables on Windows.
File and directory paths
All locations are under the AidaIDE user-data directory. On Windows this is %APPDATA%\AidaIDE\; on Linux/macOS it is ~/.aidaide/ (and ~/Library/Application Support/AidaIDE/ on macOS for some auxiliary data).
| Path | Contents |
|---|---|
vault.enc |
The encrypted secret store. Back this up. |
salt |
Per-install salt for the master password KDF. Back up with vault.enc. |
config.json |
Top-level settings: theme, splash mode, telemetry, startup behaviour. |
keybindings.json |
Your custom keyboard shortcut overrides (only differences from defaults). |
keybindings/presets/ |
Bundled binding presets: Vim, Emacs, default. |
workspaces/ |
Saved workspace JSONs (per File → Save Workspace As…). |
builder_drafts/ |
Hierarchy Builder autosaves — one JSON per SoC under edit. |
lcot_user_commands.json |
Your custom LCOT commands. |
layouts/ |
Saved layout presets (per View → Layout Presets). |
recent_files.json |
Last 20 files (local or remote). |
recent_connections.json |
Last 10 SSH hosts you connected to. |
logs/aidaide.log |
Main application log. Rotates at 10 MB. |
logs/ssh.log |
Per-connection SSH transcripts. |
audit.log |
Append-only security-event log (vault unlocks, license activations, PKI cert ops). |
bug_reports/ |
Bundles staged for upload when offline. Auto-flushed on next successful launch. |
plugins/ |
Installed .plugin directories. |
widgets/ |
Installed widget directories. |
workflows/ |
AI Workflow YAML/JSON files. |
cache/ |
Disposable. Safe to delete; AidaIDE re-creates. |
The user-data directory is not touched by the uninstaller. Back it up before reinstalling if you want to preserve state. See Ch. 18 §~/.aidaide/.
Default ports and endpoints
| What | Port / URL |
|---|---|
| SSH (override per-host in Connection Manager) | 22 |
| SFTP | rides on SSH; same port |
| MySQL / MariaDB | 3306 |
| PostgreSQL | 5432 |
| MongoDB | 27017 |
| Redis | 6379 |
| HTTP MJPEG (cameras) | 80 / 8080 |
| RTSP (cameras) | 554 |
| ONVIF WS-Discovery | UDP 3702 (multicast) |
| Fleet Web Dashboard | http://localhost:5001/fleet |
| OTA manifest endpoint | https://updates.aidaide.app/manifest.json |
| Modbus TCP | 502 |
| OPC UA | 4840 |
| Siemens S7 | 102 |
If a connection is failing, the most common single cause is the wrong port. AidaIDE has historically had a few callsites that hardcode 22 for SSH — see Ch. 2 §Ports and the port-22 trap.
Default keyboard shortcuts (full table)
A single consolidated table of every default binding. The same data is in Chapter 14 split by category; here it is one alphabetical lookup. Customise any of these via File → Keyboard Shortcuts… (Ctrl+K, Ctrl+S). On macOS substitute Cmd for Ctrl unless noted.
| Shortcut | Action |
|---|---|
Alt+Click |
Add a cursor at the click point (multi-cursor) |
Alt+F4 (Win) / Cmd+Q (Mac) |
Exit AidaIDE |
Alt+Shift+drag |
Column / box selection in the editor |
Ctrl+, |
Open Settings |
Ctrl+/ |
Toggle line comment |
Ctrl+A |
Select all (in editor) |
Ctrl+Alt+L |
Load Chat Session |
Ctrl+Alt+M |
Marketplace Store |
Ctrl+Alt+P |
Plugin & Widget Manager |
Ctrl+Alt+S |
Save Workspace As… |
Ctrl+F |
Find in current file |
Ctrl+F2 |
Bookmark current line |
Ctrl+G |
Go to Line (42:10 puts cursor at col 10 of line 42) |
Ctrl+H |
Replace in current file |
Ctrl+K, Ctrl+S |
Keyboard Shortcuts editor (two-key chord) |
Ctrl+O |
Open File |
Ctrl+R |
Refresh syntax (editor context) — avoid double-binding |
Ctrl+S |
Save current file |
Ctrl+Shift+A |
AI Chat |
Ctrl+Shift+Alt+S |
Save Chat Session |
Ctrl+Shift+D |
Debug Console |
Ctrl+Shift+F |
Find in Files |
Ctrl+Shift+H |
Agent Hierarchy Builder (label may say "Replace in Files" in some builds — Hierarchy Builder is the actual behaviour) |
Ctrl+Shift+I |
Toggle AI Sidebar |
Ctrl+Shift+J |
Live Coding Agents |
Ctrl+Shift+K |
Create New Plugin/Widget |
Ctrl+Shift+M |
Claude Agent Manager |
Ctrl+Shift+N |
New Project from Template |
Ctrl+Shift+O |
Open Project Folder |
Ctrl+Shift+P |
Command Palette |
Ctrl+Shift+W |
Protocol Wizard |
Ctrl+Shift+Z |
Redo (alternate) |
Ctrl+T |
New Connection Tab |
Ctrl+Y |
Redo |
Ctrl+Z |
Undo |
Ctrl+→ / Ctrl+← |
Move cursor by word |
Ctrl+scroll (editor) |
Zoom font |
Ctrl+scroll (canvas) |
Zoom Hierarchy Builder canvas |
End |
Cursor to end of line |
Esc (Command Palette) |
Close palette |
F2 |
Jump to next bookmark |
F3 |
Find Next |
F5 |
Run current file (F5 in connection-tab editors can double-fire if you bind a second action; tracked) |
F8 |
Run selection (Query Editor) |
F9 |
Toggle breakpoint |
Home |
Cursor to start of line (twice = column 1) |
Middle-click (tab bar) |
Close tab |
Shift+F2 |
Jump to previous bookmark |
Shift+F3 |
Find Previous |
Tab / Shift+Tab |
Indent / Outdent selection |
Command Palette prefixes:
>filter to actions only (skip settings)@jump to a symbol in the current editor file:jump to a line number in the current editor file
See Ch. 14 §Customising shortcuts for the full editor.
Top "how do I…?" — one-line answers
| Question | One-line answer |
|---|---|
| Open a new SSH connection | Toolbar + → pick host (or Connection Manager to add one). Ch. 2 |
| Set a non-22 SSH port | Connection Manager → host → Port field. Ch. 2 §Ports |
| Generate an SSH key | ssh-keygen -t ed25519 -C "you@example.com" then ssh-copy-id user@host. Ch. 2 §SSH key pair setup |
| Run a Python file on the remote box | Open in editor, click ▶ in the editor toolbar. Ch. 3 §Running files |
| Find text across the whole project | Ctrl+Shift+F. Ch. 3 §Find and Find in Files |
| Diff a remote file vs. a local file | Open both, Tools → Git → Diff Viewer → Two files. Ch. 3 §Diff Viewer |
| Add my own one-click command | LCOT panel → + Add Command. Ch. 4 §Adding your own command |
| Push a binary to a Raspberry Pi | Fleet → Deploy Lite (or toolbar ⚡). Ch. 5 §Deploy Lite |
| Scan the LAN for cameras | Network → Cameras → Scan for Cameras. Ch. 10 §Scanning for cameras |
| Connect to MySQL | Preview → Database → Database Manager → Add MySQL. Ch. 11 §Database Manager |
| Open the Command Palette | Ctrl+Shift+P. Ch. 14 §Command Palette |
| Switch themes | View → Theme. Ch. 13 §Themes and appearance |
| Re-run the first-run wizard | Help → Setup Wizard. Ch. 1 §First-run wizards |
| Enter my license key | Help → Enter License Key. Ch. 17 §Activating your license |
| Save my current layout for later | Toolbar floppy icon next to the layout combo. Ch. 16 §Saving and switching layouts |
| File a bug report | Help → Report a Bug. Ch. 18 §Filing a useful bug report |
| Make the splash go away | AIDA_SPLASH=off. Ch. 1 §Splash screen |
| Launch without plugins | aidaide --safe-mode. Ch. 18 §Safe mode |
| Find a feature when I forget the menu | Toolbar magnifier → Feature Browser. Ch. 14 §Feature Browser |
| Drop into the Hierarchy Builder | AI → Agent Hierarchy Builder (or Ctrl+Shift+H). Ch. 9 |
Platform-specific notes
Most of AidaIDE works identically across Windows, macOS, and Linux. The quirks that bite:
Windows
- Master password modifier keys:
Ctrl, notCmd. The Smart Login window respects the system IME — if typing into the password field shows nothing, swap input method withWin+Space. - User-data path is
%APPDATA%\AidaIDE\(typicallyC:\Users\<you>\AppData\Roaming\AidaIDE\). - Packet Capture needs Npcap installed in WinPcap-compatible mode. The first capture-tab open will prompt if missing.
- OpenSSH Server for local testing: Settings → Apps → Optional Features → Add → OpenSSH Server, then start the OpenSSH SSH Server service. Ch. 2 §SSH setup paths
- Private key file permissions: Windows OpenSSH checks them. Right-click key → Properties → Security → Advanced → Disable inheritance → remove all users except your own.
- Path separators in workspace JSONs are
\\(escaped). Hand-editing requires care.
macOS
- All
Ctrlshortcuts above areCmdon macOS. The Settings shortcut isCmd+,(system convention). - User-data path has two locations:
~/.aidaide/for the bulk of state, and~/Library/Application Support/AidaIDE/for some auxiliary files. - Packet Capture requires the
bpfdevice to be readable by your user. Recent macOS releases shipChmodBPFfrom the Wireshark installer; install Wireshark for the helper, then close it. - Camera USB access: macOS will prompt for camera permission the first time the IDE accesses one. Accept; otherwise the feed stays black.
- Vault keychain integration is opt-in under Settings → Security → macOS Keychain — when enabled, your master password is also stored in the Keychain so the vault unlocks transparently per session.
Linux
Ctrl+Alt+Smay be eaten by your window manager (Cinnamon, KDE) for "screenshot." Re-bind in the shortcuts editor if so.- Packet Capture needs
cap_net_raw,cap_net_admin=eipon the Python interpreter:sudo setcap cap_net_raw,cap_net_admin=eip $(which python3). Or run AidaIDE withsudo(not recommended). - Camera USB access needs your user in the
videogroup:sudo usermod -aG video $USERthen log out / back in. - Wayland:
Alt+Clickmulti-cursor depends on your compositor's modifier-key handling. Most distros work; some KDE configs do not. Use right-click → Add Cursor Here as a fallback. - systemd integration under Sysadmin → Service Manager assumes a working
systemctl— works on Ubuntu, Debian, Fedora, RHEL, openSUSE, Arch. Alpine / Void / Gentoo may need OpenRC adapters.
Pricing tiers at a glance
| Plan | Monthly | Yearly | Devices | AI Hierarchy |
|---|---|---|---|---|
| Free | $0 | $0 | unlimited connections | — |
| Pro | $19 | $190 | 3 (fingerprint-bound) | Included |
| Teams Pro | $70 | $700 | 999 | Included |
Aida-lite is licensed per-device and lives on fleet members, separate from the desktop tier. See Ch. 17 §Buying a license for the current canonical list.
Recurring traps to be aware of
Engineering shorthand for bug classes that have shipped more than once. Mentioned across the guide; consolidated here so you can scan for symptoms:
- Port-22 hardcoded — non-22 SSH port mysteriously fails. Ch. 2 §Ports
- Silent SFTP-to-local fallback — remote save appears to succeed but the file did not change. Ch. 18 §Save did not persist
- UTF-8 mismatch — non-ASCII filenames or content show mojibake. Ch. 18 §Mojibake
- Fabricated demo data presented as real — Host Discovery, Service Detection, Threat Intel, certificate inventory. Ch. 18 §"Demo mode" vs real data
- HTML escape missed on exports — XSS in security reports. Ch. 18 §Security tools
- Hierarchy Builder shortcut label lies —
Ctrl+Shift+Hopens Hierarchy Builder despite some declarations naming itedit.replaceInFiles. Ch. 14 §Recurring binding traps - Decrypt-failure-returns-empty-string — password field mysteriously blanks. Ch. 18 §A password field mysteriously goes blank
If you suspect a recurring trap, note it in your bug report — the engineering team will check the relevant tracker.
Where to go from here
- Forgot a term? → Chapter 19 — Glossary
- Need to find a UI label by name? → Keyword Index
- Something is broken? → Chapter 18 — Troubleshooting & FAQ
- Brand-new user? → Chapter 1 — Getting Started then Chapter 2 — SSH Devices
- Master of everything? → File feedback via Help → Report a Bug — the dialog accepts documentation suggestions too.