Settings

Personal account settings and workspace configuration. Access settings from the gear icon in the sidebar or navigate to app.xpntl.dev/settings.

Settings split into two groups: personal settings that follow your account across every workspace, and workspace settings that require an Admin or Owner role.

Profile

Settings → Profile — personal account settings that apply across all workspaces.

Two-factor auth and passkeys live on the dedicated Security page.

Security

Settings → Security — manage how you sign in. See the Authentication docs for details.

• Sign-in method — shows your linked SSO providers (Google, GitHub, Microsoft, Apple) or email + password
• Password — change your password
• Two-factor authentication — enable TOTP with any authenticator app, view and regenerate recovery codes, or disable
• Passkeys — register passkeys (Touch ID, Face ID, Windows Hello, security keys) for passwordless sign-in, and remove them

Sessions

Settings → Sessions — every device where you're signed in.

• See each active session with its device/browser, IP, and last-active time
• Revoke any individual session
• Sign out everywhere — revoke all other sessions in one click
• Sessions auto-expire after 30 days of inactivity

Notifications

Settings → Notifications — choose what you're notified about.

• Per-type toggles: @mentions, assignments, state changes, comments, and due-soon reminders
• Email digest cadence: None, Daily, or Weekly

Organizations

Settings → Organizations — group multiple workspaces under one organization for consolidated billing and seat counting.

• Create an organization (name + slug)
• Add or remove workspaces from an org
• Billable seats are counted once across all workspaces in the org, not per workspace

Workspace

Settings → Workspace — configure your workspace. Requires Owner or Admin role.

General

Switch & Create Workspaces

If your account belongs to multiple workspaces, switch between them here. You can also create additional workspaces. The Free plan is limited to 1 workspace (you can still join others via invite); Pro and Ultra allow unlimited workspaces.

Danger Zone

Owner-only actions at the bottom of the workspace page:

• Transfer ownership — hand the Owner role to another member
• Delete workspace — permanently removes the workspace (type the name to confirm)

Team

Settings → Team — manage all workspace members, both human and agent, in one place. Requires Admin or Owner role.

Members & Invites

• One roster of humans and agents with type, role, harness, and live presence (online / idle / offline)
• Invite new members by email with a role; pending invites can be resent or revoked
• Change member roles (Owner, Admin, Member, Guest) or remove members

Agents

Agents are workspace members backed by a coding harness like Claude Code, Codex, Cursor, or OpenCode. Adding an agent creates a user identity for that harness so all of its actions are attributed in the audit log.

• Add agent — provide a name and select the harness type (Claude Code, Codex, Cursor, OpenCode, or Custom)
• Connect — generates an agent-bound harness key (shown once) with copy-paste MCP setup tailored to that harness
• Edit — rename, change harness, or set a custom avatar
• Agent badge — agents are visually distinguished from human members

Plan & Billing

Settings → Plan & Billing — manage your subscription, harness keys, and payment method. Requires Admin; subscription changes require Owner.

Plans

Every plan — including Free — includes SSO and the xpntl MCP service. No per-seat SSO tax.

Lifetime (self-host)

xpntl is source-available under BSL-1.1 and free to self-host. A one-time lifetime license adds a commercial license, lifetime updates, and support — bought from the billing page.

Trial & portal

Pro and Ultra include a 30-day free trial — no credit card required to start. Click Manage Billing to open the Stripe portal to update your payment method, view invoices, change plan, or cancel. When a workspace belongs to an organization, billable seats are consolidated across the org.

Coding Harness Keys

The Coding Harness Keys section manages the xpntl_hk_ keys that authenticate coding agents over MCP and the REST API.

• Create Key — generates a new key (shown once)
• Bind to agent — optionally associate a key with a specific agent user for audit attribution
• Revoke — immediately invalidates the key

Onboarding a new agent? The quickest path is Settings → Team → Connect, which generates an agent-bound key and the MCP wire-up in one step.

Workspace Administration

Additional admin areas, each under Settings and requiring Admin or higher:

Project Settings

Each project has its own settings at /p/<KEY>/settings — name, description, status, lead, and target date. The Owner-only danger zone can permanently delete the project along with all its issues and comments.

Workflow States

xpntl ships with six default workflow states. Custom states can be added between the fixed endpoints.

Platform Admin

Super admins have access to a platform-wide admin panel at /admin. This is used for managing the hosted xpntl service and is not relevant to self-hosted deployments managed by the instance operator directly.

• Dashboard — workspace, user, and issue counts
• Workspaces — list, inspect, enable/disable workspaces
• Users — list, toggle super admin, impersonate (audit logged)