Skip to main content

Settings

Settings is where organization admins configure how your org behaves on X4RGE — name and invites, access rules, budgets, teams, active sessions, and who owns the org.

This is not where you write code or start agent runs. It is the policy and account hygiene hub that works alongside Members, Model control, and Usage. Everyone can manage their own profile and personal sessions; most org-wide controls need admin or super admin.

What this page is for

You want to…Settings helps you…
Control who can invite and joinDefault roles, admin invite rules, project gates
Protect connectors and CI keysIntegration approval, personal API key policy
Manage spend guardrailsMonthly budget (same as Usage)
Organize larger teamsTeams linked to projects and optional team budgets
Respond to security eventsReview and revoke active sessions
Settings vs Console

Settings governs your organization on X4RGE. Included plan allowance and commercial limits are set in the Console by operators — not here. See Contracts & capacity if Usage does not match your agreement.

Who can change what

AreaTypical access
Organization name, access rules, budgetAdmin or super admin
Transfer ownership, delete orgSuper admin only
Teams (create, members, team budget)Admin; team admins for their team
Revoke your sessionAny member
Revoke someone else's sessionAdmin (follow your security runbook)
Profile and personal preferencesAny member

If you cannot see a Settings page, your role may be member only — ask an admin to adjust access in Members.

Why settings matter

Without clear org settingsWith Settings
Everyone invites everyoneDefault roles and who can invite
Agents run before onboardingOptional project assignment gate
Connectors go live uncheckedIntegration approval for GitHub and others
Stale laptops stay signed inSession review and revoke
Squads share one flat orgTeams for budget and model policy by group

Settings works with Members, Model control, and Usage & billing — configure people and caps here, then tune models and spend in those modules.

How settings fits together

Think of Settings as the outer boundary; other dashboard modules fill in the details:

ModuleWhat you configure thereTied to Settings
MembersInvites, roles, removalsDefault invite role, who can invite
UsageSpend views and trendsManage budget (same dialog)
Model controlWhich models are allowedOrg-wide; optional per-team overrides
IntegrationsGitHub, keys, connectorsIntegration approval, personal API keys
ProjectsWork groupingRequire project assignment gate

Changes in Settings often appear in the org audit log — useful when policy "worked yesterday" and does not today.

In practice

Match your goal to the right Settings area or linked module.

You want to…Do this
Rename the org or fix invite linksSettings → Organization — name and slug
New hires start as members, not adminsSet default role for invites
Block agents until someone is on a projectTurn on require project assignment
Let admins invite without super adminEnable admins can invite
Approve GitHub before it goes liveIntegration approval required
Set the monthly spend capManage budget (same as Usage)
Sign out a lost laptopSettings → Sessions → Revoke
Group platform vs product squadsSettings → Teams
Allow CI keys for automationAllow personal API keys + Headless CLI
Hand off org ownershipTransfer ownership (super admin only)

Organization settings

Open Settings → Organization for org-wide controls. These apply to everyone in the org unless a team-specific override exists.

Identity and membership

ControlWhat it does
Organization name & slugHow the org appears and how invite URLs look
Default role for invitesNew people join as member or admin
Admins can inviteDelegates invites without super admin
Transfer ownershipMove org to another member (super admin only)
Delete organizationPermanent — see warning below

When your plan includes SSO (SAML, SCIM, domain enforcement), extra identity options appear here after your identity provider is connected.

Access and governance

ControlWhat it does
Require project assignmentMembers can't run agents until they're on a project
Admins can create projectsWhether admins create projects without super admin
Integration approval requiredNew connectors need admin sign-off before use
Restrict templatesLimit who can apply org project templates
Allow personal API keysLets members create keys for CLI headless and CI
Manage budgetMonthly cap and warn / stop behavior — see Usage
New enterprise rollout

Many admins start with: require project assignment on, integration approval on, personal API keys off until CI is ready, and budget on warn before hard stop.

Sessions

Settings → Sessions (or Security) lists active desktop sign-ins — device, last active, and surface. Use this when offboarding someone or investigating an unknown device.

  1. Review active sessions

    Look for unknown devices or logins that should have expired (lost laptop, contractor offboarded).

  2. Revoke if needed

    Choose Revoke on a row. That device signs out immediately. A local run in progress may fail on the next credential check.

  3. Follow your security runbook

    For compromised accounts: revoke sessions, remove the member in Members, and rotate API keys in Integrations.

Revocations are recorded in the org audit log.

Teams

Teams group members for larger orgs — useful for budgets, model policy, and project ownership. Smaller orgs may skip teams and use one flat org until squads need separate caps or model rules.

  1. Create a team

    Settings → Teams → New team. Name by function (Platform, Payments) or product line.

  2. Add members and a lead

    Assign a team admin for membership; members contribute; viewers get read-only visibility where your plan allows.

  3. Link projects

    Connect teams to projects so policy and usage roll up correctly.

  4. Optional team budget

    On plans with team budgets, allocate a slice of the org cap on the team panel.

Teams are the operating unit inside your org; Organization settings are the outer boundary that applies to everyone.

Integrations and keys

GitHub, Slack, Linear, and other connectors live in the Integrations module — Settings links here for org-wide rules that affect connectors.

User API keys (for CLI and automation) respect Allow personal API keys in Organization settings. When enabled, members create keys in Integrations; admins rotate after offboarding by revoking keys and updating CI secrets.

See Headless CLI for CI authentication patterns and GitHub for the primary production integration today.

Ownership and destructive actions

ActionWhoReversible?
Transfer ownershipSuper adminYes — transfer again
Revoke sessionAdmin or userYes — user can sign in again
Remove memberAdminYes — re-invite
Delete organizationSuper adminNo — permanent data loss
Destructive actions

Deleting an organization or revoking sessions cannot be undone from the UI. Before deleting, export audit and usage reports if compliance requires retention.

Questions about settings?

QuestionAnswer
I can't see Organization settingsYou may need admin — ask in Members
Where is the monthly spend cap?Manage budget here or on Usage — same dialog
Why can't someone run agents?Check require project assignment and project membership
Why is GitHub pending?Integration approval required may be on — admin must approve
Can members create API keys?Only if Allow personal API keys is enabled
Who changed a policy?Org audit log (admin) — see Governance context
Plan allowance wrong?Not in Settings — Contracts / Help