Settings and Privacy
Every Settings section: agent defaults, appearance, usage, notifications, AI accounts, local tools, editor, command approval, privacy and reset.
Open Settings
| Where | How |
|---|---|
| Inside a project | Cmd+, (Windows/Linux: Ctrl+,). Settings opens as an editor tab; it is also in the Add tab menu |
| Agent layout | The gear at the bottom of the Threads sidebar, next to your name |
| Home screen | The gear in the title bar |
Type in Search settings... to filter sections by name or keyword (for example "yolo", "font", "kicad").
Sections, grouped as in the sidebar:
| Group | Section | Desktop | Browser |
|---|---|---|---|
| Personal | General, Profile, Appearance, Usage & billing, Notifications | Yes | Yes |
| Integrations | AI Accounts | Yes | Yes |
| Local tools | Yes | No | |
| Coding | Editor | Yes | Yes |
| Command Approval | Yes | No | |
| System & Privacy | Privacy, About | Yes | Yes |
General
Permissions & Automation
| Setting | Effect |
|---|---|
| Enable Chat Checkpoints | Snapshot the project before each message you send, so you can use Restore checkpoint and edit message in chat |
| Auto-Generate Datasheet Names | Name processed datasheets after the component instead of the file |
| Follow Agent | Switch tabs and panels to what the agent is doing (for example the Output after a compile). Also in the composer's preferences menu |
General: Auto Save (save when the editor loses focus) and Indentation (2, 4 or 8 spaces).
Profile
- Display Name: your author name in chats and project metadata. Edit and click Save.
- Email Address: the account you are signed in with.
- Sign Out: signs out of Embedr on this device.
Appearance
- Color Theme: light, dark, or system.
- Typography Preset: compact, default or spacious, applied to every panel at once.
- Component Typography: separate sizes (8 to 24 px) for Code Editor, AI Copilot Chat, Embedded Terminal and Build Output & Serial. Cmd/Ctrl+= and Cmd/Ctrl+- change the editor size from the keyboard.
Usage & billing
| Block | Shows |
|---|---|
| Active Plan | Your plan (Free, Hobby, Pro or Embedr Access) with Upgrade Plan or Manage Subscription |
| Usage limits | Monthly plan limit, the percentage remaining and when it resets |
| Included in plan / Extra usage | What your plan includes, and pay-as-you-go usage billed at the end of the cycle ("Not enabled on Free tier" on Free) |
| Prepaid balance | Shown when you have prepaid credit |
| Billing & Invoices | Stripe Portal to change payment methods and download invoices |
The usage meter in the chat composer (View usage) shows the same remaining allowance without leaving the chat. Which models each plan includes is on Models.
Notifications
System Alerts
| Setting | Default | Effect |
|---|---|---|
| System Notifications | On | Native notifications when Embedr is in the background or another app is focused. In the browser it shows the permission state (Permission: granted, denied…) |
| Notification Sound | On | Play the system chime with each alert |
| Email Notifications | Browser only. Emails your verified address when the agent finishes, fails or needs you, so you can close the tab. "Available once your account email is verified." otherwise |
Agent Triggers
| Setting | Default | Notifies when |
|---|---|---|
| Action Required | On | The agent waits for an answer, a tool approval or a confirmation |
| Agent Completed | On | A run finishes |
| Agent Errors | On | A run stops because of an error |
You are not notified about the thread you are looking at. If macOS shows nothing, allow Embedr in System Settings → Notifications; if a browser blocks notifications, allow them in its site settings or use email.
AI Accounts
Connect your own subscriptions to use their models; details on Models.
| Account | Steps |
|---|---|
| OpenAI → ChatGPT Plus / Pro | Connect, Copy code, Open ChatGPT, enter the code. Refresh to re-check, Sign out to disconnect |
| OpenCode → OpenCode API Key | Paste the key (sk-...) and Save Key, or Get Key to create one. Zen and Go models draw from your OpenCode balance |
Local tools (desktop)
Runtime Integration → KiCad CLI shows whether a compatible KiCad 10 is installed and where. Click Check after installing or updating KiCad. Without KiCad 10 the status reads "KiCad 10 is required for local board operations."
Where tools run decides, per tool, whether work runs on this machine or in the cloud:
| Tool | Runs |
|---|---|
| KiCad | Board edits, checks, exports and routing |
| SPICE simulation | Simulations, with ngspice |
| Choice | Effect |
|---|---|
| Local when available (default) | Uses the local install when it is present and compatible, otherwise the cloud |
| Always cloud | Always runs in the cloud, even if the tool is installed |
With KiCad on Always cloud, the KiCad CLI row notes "Not used for board work while KiCad is set to Always cloud." Opening files in the KiCad app and importing KiCad designs always use your local install. If the KiCad choice is locked to Always cloud and greyed out, an environment variable on this machine forces cloud mode.
See Board and KiCad and Simulation.
Editor
| Setting | Effect |
|---|---|
| Word Wrap | Wrap long lines to the pane width |
| Show Minimap | Code overview on the right edge |
| Tab Indentation | 2, 4 or 8 spaces per tab stop |
| Auto Save on Focus Loss | Save changed files when you switch window or panel |
Command Approval (desktop)
Controls which terminal commands the agent runs without asking. The composer's Terminal approvals presets (see Embedr Agent) set these same switches.
Automatic Approvals
| Setting | Default | Allows without asking |
|---|---|---|
| Auto-approve Safe Commands | On | Read-only commands such as ls, cat, pwd, find |
| Auto-approve Build Tools | On | Build commands such as arduino-cli, cmake, npm build |
| Auto-approve Version Control | On | Standard git commands such as git status, diff, log, commit |
| Auto-approve Low-Risk Actions | Off | Commands that do not modify or delete files |
Safety & Guardrails
| Setting | Default | Effect |
|---|---|---|
| Show Risk Analysis | On | Show the risk reasons in approval prompts |
| Confirm Destructive Actions | On | Always ask before commands that delete or overwrite files |
| YOLO Mode | Off | Disables every command approval prompt. Same as Full access in the composer |
Commands judged high-risk (recursive deletes, elevated privileges, system or home directories) are never auto-approved by the category switches; only YOLO Mode skips them. Some actions always ask regardless of these settings: PCB Auto Place and Auto Layout, PCB artifact export, and the agent typing into your terminal sessions.
In the browser the agent's commands run in a cloud sandbox without prompts, so this section is not shown.
Privacy
Telemetry & Diagnostics
| Setting | Default | What it shares |
|---|---|---|
| Product Analytics | On | Anonymous feature usage, workflows and performance metrics |
| Session Recording | On | Masked interaction replays used to diagnose interface issues. Code editors, input fields and local paths are masked |
| Crash Reporting | On | Sanitized error stack traces and crash diagnostics |
| AI Trace Recording | Depends on plan | Sanitized prompts, responses and tool telemetry; credential fields are removed before capture |
AI Trace Recording by plan:
| Plan | Behaviour |
|---|---|
| Free | Required: always captured under Free plan terms |
| Hobby, Pro, Embedr Access | Off by default. Turn on the switch to share traces and help improve Embedr; turn off anytime. The switch needs Product Analytics on, and turning analytics off stops trace sharing |
Your choice is saved to your account, so it follows you to other devices. If the change cannot be saved, the switch stays as it was and an error appears.
About
- Embedr Version and Runtime Environment (Electron Native or Web Browser), useful when reporting a problem.
- Reset All Settings → Reset All restores typography, notification and approval preferences to their defaults.
Updates
The desktop app checks for updates on its own and downloads them in the background. A card at the bottom left shows the version and release notes; when the download is done, click Restart and update. If the agent is still working, Embedr warns that restarting will stop it. See Install and account.
