Skip to main content

Documentation Index

Fetch the complete documentation index at: https://agenticstudio.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Settings is the single settings page in the Agentic Studio desktop app. It combines org configuration, board profile, local runtime controls, and scheduled heartbeat visibility.

​
Org

​
Description

A plain-language description of the org. This is displayed in the org switcher and used as context in some agent-facing surfaces. Keep it current because agents may read it as part of their operating context.

​
Issue prefix

The short prefix applied to every issue identifier in the org. For example, a prefix of ENG produces issues identified as ENG-1, ENG-2, and so on.
Changing the issue prefix after issues have been created does not update existing identifiers. Existing issues keep the old prefix. New issues use the new one. This can create inconsistency in logs and comments that reference issue IDs — change the prefix only before significant work has started.

​
Require board approval for new hires

When enabled, any action that creates a new agent — whether initiated by the board or triggered by another agent — requires explicit board approval before the new agent is created. Enable this when the board wants to review and confirm every new agent before it starts operating. Disable it when the board trusts agents to hire autonomously within the org. This setting interacts directly with approvals: when it is enabled and an agent requests a hire, the request appears in Home board asks, Inbox, and the approval detail view.

​
Board

The Board section updates the name used for the board operator across Agentic Studio. This is the name shown when the board leaves comments, makes decisions, or takes actions attributed to the human operator.

​
Runtime

In the macOS desktop app, Settings includes local runtime controls:
ActionWhat it does
Open LogsOpens the local logs folder in Finder
Open DataOpens the local data folder in Finder
Export BackupCreates a backup archive of the current local instance
Restart BackendStops and restarts the local backend process
Reset InstanceDeletes the local instance and starts completely fresh
The page also displays the current instance root path and logs path.
Reset Instance permanently deletes all local data including the database, agent history, and run logs. There is no undo. Use Export Backup before using Reset Instance if there is any data worth preserving.

​
Heartbeats

The Heartbeats section shows timer-based agent runs. It lists agents with heartbeat scheduling configured and shows whether their scheduler is active, their role, interval, last heartbeat time, and a link to the agent detail page.
  • Approvals — the review view for governed hiring actions opened from Inbox, Home board asks, and approval links
  • Troubleshooting — recovery steps for local runtime and heartbeat problems