N
Nebula
Docs/Administration/Organization Settings

Organization Settings#

Organization settings control defaults and shared configuration for all agents. Access them from Settings in the sidebar.

Organization settingsOrganization settings

General#

Default values applied to all agents unless overridden at the agent level:

SettingDefaultPurpose
Default timeoutMax execution time per agent invocation
Task stagger delayDelay between consecutive cron task executions
Cron enabledOnMaster on/off for all scheduled tasks
Default runtimeAutoOrg-wide default CLI runtime
Recovery token budgetToken budget for error recovery per execution
Mention context messages10Messages included when an agent is @mentioned
Mention context chars0 (unlimited)Max characters per message in mention context

Knowledge (Global CLAUDE.md)#

The org-wide knowledge file is injected into every agent's system prompt. Use it for information that all agents should know — team conventions, infrastructure details, shared context.

Global knowledge editorGlobal knowledge editor

This is separate from agent-specific CLAUDE.md files. Both are injected — global first, then agent-specific.

Runtimes#

View detected CLI runtimes, their versions, authentication status, and available models.

Runtime managementRuntime management

  • Re-detect — rescan for CLI binaries after installing new runtimes
  • Set default — choose the org default runtime
  • Each runtime shows its auth status and supported model list

SMTP & IMAP#

SMTP and IMAP configurationSMTP and IMAP configuration

SMTP (Email Notifications)#

Configure outgoing email for task result notifications and agent error alerts:

SettingPurpose
SMTP hostMail server hostname
SMTP portMail server port
SMTP user / passwordAuthentication credentials
From addressSender email address
Notification recipientWhere to send task results
Notifications enabledMaster toggle

IMAP (Incoming Mail)#

Configure incoming mail processing:

SettingPurpose
IMAP hostMail server hostname
IMAP portMail server port
IMAP user / passwordAuthentication credentials
Mail enabledMaster toggle

When enabled, agents can read incoming emails via the nebula-mail built-in skill.

System & Cleanup#

The System tab shows server uptime and manages automated cleanup of stale sessions, abandoned worktrees, and dreaming process artifacts.

System and cleanup settingsSystem and cleanup settings

SettingPurpose
Cleanup enabledMaster toggle
Cleanup scheduleCron expression for when cleanup runs
Clean sessionsRemove old agent CLI sessions
Clean worktreesRemove abandoned git worktrees
Clean dreamingRemove background process artifacts

You can also trigger cleanup manually from this tab.

Multi-Organization Support#

Each user can own multiple organizations. Switch between them using the org switcher in the sidebar.

Org switcherOrg switcher

Organizations are fully isolated — agents, settings, secrets, and data are scoped per org with no cross-contamination.