Settings & Preferences

NimbleBrain organizes settings by scope — what each setting affects:

• You — your personal profile (theme, display name, timezone). Lives outside /settings; reach it via the avatar menu in the bottom-left of the sidebar.
• This Workspace — settings for the workspace you’re currently active in (its name, members, instructions, app config, usage). Visible to all workspace members; admin-only writes for most.
• Organization — admin-only settings that affect every workspace (model defaults, user management, the workspace catalog).

Open settings from the workspace selector dropdown in the sidebar — click your workspace name, then select Settings — or directly via /settings.

Your profile (/profile)

Your profile is reachable any time from the avatar menu at the bottom-left of the sidebar. Click your avatar → Profile settings.

• Display Name — How your name appears to teammates in shared conversations.
• Email — Your login email (read-only).
• Role — Your org-level role (read-only).
• Timezone — Used for scheduling and time-related responses.
• Theme — System (follows your OS), Light, or Dark.

Click Save after making changes.

The avatar menu also has a Sign out action.

This Workspace

This section reflects the workspace you’re currently active in. Switch workspaces via the workspace selector at the top of the sidebar; the This Workspace section updates immediately.

General (/settings/workspace/general)

• Workspace name — what shows up in the switcher and shared conversations.
• MCP Connection — your workspace ID, copyable. Use this as the X-Workspace-Id header when connecting external MCP clients (Claude Desktop, VS Code, Cursor, etc.). See Connecting External Clients for setup.
• Workspace Instructions — custom instructions injected into every conversation in this workspace, on top of organization-wide policies. Markdown editor with an 8 KB cap. Workspace admins (or org admins/owners) can edit; everyone else can read.

Tip

Workspace instructions are great for team conventions: tone of voice for shared documents, default priorities for triage, citation policies for engineering. The agent picks them up on every turn — no need to repeat them in chat.

Members (/settings/workspace/members)

Read-only list of who belongs to this workspace and their role (admin / member). To add or remove members, organization admins manage workspace membership from the Organization → Workspaces view.

Usage (/settings/workspace/usage)

Per-workspace usage analytics:

• Cost over time — daily, weekly, or monthly spending.
• Token breakdown — input, output, cache reads, cache creation.
• Model usage — which models the agent is using and what each costs.
• Activity stats — LLM calls, average response time, conversation count.

Period selector (Day / Week / Month / All) adjusts the time range.

Apps (/settings/workspace/apps)

Per-bundle settings for the apps installed in this workspace. Apps appear here only when their author has registered a settings panel — otherwise the bundle has no settings UI to surface.

Some apps support custom instructions of their own — saved guidance the agent picks up whenever you’re using that app. Whether an app supports this is up to the app author. When supported, the editor appears inside that app’s settings panel; storage and validation are owned by the app, but the platform reads the saved text on every conversation turn and includes it in the agent’s system prompt — same way bundle-author docs describe it from the other side.

Organization (admin only)

Visible only to organization admins and owners. Hidden from regular members.

Model (/settings/org/model)

Choose which AI models the agent uses across every workspace:

• Default model — primary model for chat.
• Fast model — cheaper / faster model for quick auxiliary tasks.
• Reasoning model — most capable model for complex analysis.

Plus runtime limits — max iterations, max input/output tokens.

Caution

Model configuration is platform-wide. Changes affect every workspace and every user immediately. Restrict to org admins/owners.

Workspaces (/settings/org/workspaces)

Org-wide workspace catalog. Click into any workspace to manage its members, view its bundles, and see metadata. Workspace creation, deletion, and member management for any workspace lives here.

To edit a specific workspace’s name or instructions, switch into that workspace via the workspace selector and use This Workspace → General.

Users (/settings/org/users)

Manage user accounts at the organization level — invite, remove, or change someone’s org role.

Sidebar layout

The sidebar collapses with the small toggle on the right edge of the sidebar (or ⌘B / Ctrl-B). Collapsing hides labels but keeps icons; expanding restores the full nav.

The bottom of the sidebar shows your avatar and name (the avatar menu); clicking opens a popover with Profile settings and Sign out.