Dashboard Settings

The Settings page at /dashboard/settings is organized into four tabs: Channels, Team, Policies, and General. Each tab manages a different aspect of your CodeSpar deployment.

Channels Tab

The Channels tab displays the status of all configured messaging channels and provides controls for managing connections.

Channel Cards

Each channel is displayed as a card with the following information:

┌────────────────────────────────────┐
│ Slack                   Connected  │
│ Bot: @codespar                     │
│ Workspace: Acme Corp               │
│ Connected: 14 days ago             │
│                                    │
│ [Reconnect]  [Disconnect]         │
└────────────────────────────────────┘

Actions

Channel Status Indicators

Channels that are not yet configured display a "Configure" button that links to the Setup page.

Team Tab

The Team tab manages team members and their roles using Clerk's organization membership system.

Member List

Each team member is displayed with:

Roles (RBAC)

CodeSpar uses role-based access control through Clerk Organizations:

Inviting Members

To invite a new team member:

1. Click the "Invite Member" button
2. Enter their email address
3. Select a role (Admin or Member)
4. Click "Send Invite"

The invitation is sent via Clerk's built-in email system. The invited user receives an email with a link to join the organization.

import { useOrganization } from "@clerk/nextjs";
 
function InviteForm() {
  const { organization } = useOrganization();
 
  async function handleInvite(email: string, role: string) {
    await organization.inviteMember({
      emailAddress: email,
      role,
    });
  }
}

Managing Roles

Organization Owners and Admins can change a member's role by clicking the role dropdown next to their name. Role changes take effect immediately.

Policies Tab

The Policies tab configures autonomy levels, risk thresholds, and approval requirements.

Autonomy Level Per Agent

A table lists each agent with its current autonomy level and a control to change it:

Changing the autonomy level sends a set_autonomy action to the backend and logs the change in the audit trail.

Risk Thresholds

Configure what risk levels require approval:

Approval Quorum

Configure how many approvals are needed before an action executes:

The quorum values can be adjusted using number inputs. The minimum quorum for production is 1 (cannot be set to 0).

Self-Approval Blocking

A toggle that controls whether the person who requested an action can also approve it:

• On (default): The requester cannot approve their own request
• Off: Any team member can approve, including the requester

This is a security feature to enforce separation of duties.

General Tab

The General tab contains project-level settings and notification preferences.

Project Settings

The project name is editable inline. The webhook URL is read-only but includes a "Copy" button.

Notification Preferences

Toggle switches for email and in-app notifications:

Danger Zone

At the bottom of the General tab, a "Danger Zone" section with destructive actions:

Both actions require typing the project name to confirm.

API Endpoints

The Settings page interacts with these endpoints:

Next Steps

• Setup — initial channel and project configuration
• Audit Trail — review all changes made in settings
• Multi-Tenant Guide — configure organizations