Docs

Settings

All settings are per-project, except Global which applies to all projects. Access via the Settings icon in the sidebar or the /settings slash command.

Note:Settings are stored in .agenties/config.json inside your project folder (per-project) or in the Agenties app data directory (global). They sync to the Agenties cloud backend when sync is enabled.

General

Project nameDisplay name for the project. Does not affect the folder path.
Project pathThe folder on disk that Agenties manages. Changing this moves the .agenties/ directory.
Danger zoneRemove the project from Agenties. This does not delete any files — it only removes the project from the app.

Claude Code

Dangerous permissionsSkip permission prompts for all tool calls. Use carefully — agents can modify or delete files without asking.
Autonomous hiringAllow the orchestrator to hire new team members automatically based on the task. When enabled, describe what you need in chat and the right roles are created for you.
Default agent modelFallback model used when a team member has no model explicitly set.
Orchestrator model overrideForce the orchestrator to use a specific model, regardless of per-session selection.

Permissions

The Permissions section shows two things:

Auto-allowed tools list
Tools that have been permanently approved from past "Always allow" decisions. You can remove entries here to stop auto-approving a tool.
Permission history
Full log of every permission decision with filters by tool name, agent, and outcome. Useful for auditing what agents have been allowed to do.

See the Permissions page for a full explanation of the permission model.

Integrations

Obsidian

Vault pathAbsolute path to your Obsidian vault folder on disk.
Project subfolderSubfolder inside the vault where this project's notes are stored. Defaults to the project name.
Enable/disableToggle Obsidian memory on or off for this project.

NotebookLM

Login stateShows whether Agenties is authenticated with your NotebookLM account.
Active notebookThe NotebookLM notebook used for this project's memory.
Keepalive statusWhether the background keepalive process is running to maintain the NotebookLM session.

GitHub

Linked repo URLThe GitHub repository associated with this project.
AuthorizationConnect or disconnect your GitHub account for this project.

MCP

Tunnel enable/disableTurn the MCP tunnel on or off. When enabled, a public HTTPS URL is generated.
Tunnel URLThe current public URL for your MCP tunnel. Share with external services.
Tunnel statusRunning, Stopped, or Reconnecting.
MCP server portLocal port the MCP server listens on. Change if there is a conflict with another service.

See the MCP Tunnel page for full setup instructions.

Voice

Whisper modelSpeech-to-text model used for voice input. Options: base (fast, smaller), small (slower, more accurate). Shows download status.
Voice mode toggleEnable or disable text-to-speech for agent responses.
Voice selectionChoose the TTS voice for agent speech output.
Push-to-talk keyThe key to hold while speaking. Click to rebind.
VAD conversational modeHands-free voice loop that detects speech start/end, submits turns automatically, and can interrupt spoken responses. Available as an MVP.

See the Voice Chat page for full setup instructions.

Global settings

Global settings apply to all projects. Access them from the bottom of the Settings sidebar.

Default model for new projectsModel applied when creating a new project, before any per-project override.
ThemeUI theme. Dark only for now — light theme is on the roadmap.
AccountShows your email address, current plan, and a logout button.