Settings
Settings
How to open LoCrew settings and what every option in Profile, General, AI Providers, MCP Servers, Write access, Limits and About does.
LoCrew's settings live in one dialog with seven sections. Every field saves as soon as you change it (text fields when you leave them, switches and menus immediately). There is no Save button.
#Opening settings
| From | Opens |
|---|---|
| Your name at the bottom of the sidebar (Profile and settings) | Profile |
| Workspace menu (the LoCrew mark at the top of the sidebar) → Workspace settings | General |
| Workspace menu → AI providers / MCP servers / Your profile / About LoCrew | That section |
| The Write access on badge in the sidebar | Write access |
Settings can open on top of another dialog, such as Create agent, and return to it when you close them.
#Sections
| Section | What it controls |
|---|---|
| Profile | Your name and picture as agents and the sidebar see them. |
| General | Workspace name, default working directory, notifications, Flow step history, and the Getting started tools. |
| AI Providers | Hosted APIs, OpenAI-compatible servers and local model servers. |
| MCP Servers | Tool servers your agents may be granted. |
| Write access | Temporary work sessions that let an Ask first agent write without asking. |
| Limits | The safety rails on hand-offs, queues, run time and spend. |
| About | Version, licences of bundled projects, and the data folder. |
#Profile
How you appear in the sidebar, on your messages and to the agents you talk to.
| Setting | Values | Notes |
|---|---|---|
| Photo | PNG, JPEG, WebP or GIF, up to 20 MB | Click the avatar, Upload photo, or drop an image. It is cropped to a square, scaled to 256 px and re-encoded, which strips metadata. Stored on this computer only. Remove photo clears it. |
| Your name | 1 to 64 characters | Shown in the sidebar and on your messages. Defaults to your operating-system user name, or You. |
| Or choose a portrait | A bundled portrait, or Aa for initials | Replaces the photo. |
| Colour behind your initials | A colour swatch | Switches to initials. |
#General
| Setting | Values | Default | Effect |
|---|---|---|---|
| Workspace name | Up to 64 characters | LoCrew | Shown at the top of the sidebar. Leaving it blank saves LoCrew. |
| Default working directory | A folder (type it or press Browse) | Your Documents folder | Pre-fills the working directory when you create a Claude Code or Codex agent. |
| Notify when an agent replies | On / off | Off | Shows an in-app toast, Agent replied, for every completed agent turn. |
| Notify when a limit stops a chain | On / off | On | Shows an in-app toast, Execution limit reached, with the reason. The Stopped here notice in the conversation appears either way. |
| Developer mode | On / off | Off | Described as keeping raw runtime events visible. In this version no part of the app reads it, so it has no visible effect. |
Notifications are toasts inside the LoCrew window, not operating-system notifications.
#Flow step history
What each Flow step received and produced is kept on this computer so you can inspect runs. It can contain anything your prompts, agents and APIs handled. Values that look like keys and passwords are masked before they are stored, but automatic detection cannot catch every secret.
| Setting | Values | Default | Effect |
|---|---|---|---|
| What to keep | Inputs and outputs (masked and size-capped), or Only which steps ran, how data moved, and sizes | Inputs and outputs | Controls what the Run inspector can show for new runs. |
| Keep stored inputs and outputs for (days) | 0 to 3650; 0 keeps them until you delete the flow | 30 | Inputs and outputs of finished runs older than this are cleared. Run status and timing are always kept. The clean-up runs when LoCrew starts, so a change applies at the next launch. |
#Getting started
Show tips (on by default) shows a one-time hint the first time you open a channel, the Flow Builder, a run, an agent's settings or an HTTP step. Open the checklist, Take the tour and Restart setup reopen the onboarding tools. Restarting keeps every agent, conversation and flow.
#About
About shows the LoCrew version, links to the source code and to report a bug, and Built with: the third-party projects LoCrew ships, each under its own licence. This installation lists the Electron, Chromium and Node.js versions, the platform and the Data folder. Copy versions copies the versions (not the folder path) for a bug report.
Note
A build made from the main branch always reports version 0.1.1, whatever it contains. Tagged snapshots carry real version numbers.
#What you will not find
This version has no settings for theme or dark mode, language, font size, operating-system notifications, automatic updates, telemetry, a proxy, moving the data folder, or exporting and resetting data.