Who uses the Console
| Role | Typical use |
|---|---|
| Workspace admin | Configures the workspace, integrations, repositories, credentials, connectors, webhooks, API Keys, members, and review policies. |
| Billing Manager | Tracks workspace billing, wallet, invoices, trial, and spend caps. |
| Maintainer | Tracks workspace information, repositories, and review operations. |
| Member | Views the workspace and review information available to them. |
The interface shows only the menus allowed for your role and the selected workspace.
Console navigation
The left navigation lists the areas you can open in the selected workspace.| Menu | Purpose |
|---|---|
| Overview | View overall workspace state, the setup checklist, quick actions, and the inbound webhook card. |
| Billing | Manage trial, wallet, usage, invoices, top-ups, and spend caps. |
| Connected Apps | Install and manage OAuth integrations or official provider apps. |
| Repositories | Connect repositories and configure review, branch rules, project management links, VCS webhooks, and architecture bootstrap. |
| Credentials | Register manual provider credentials when a Connected App is not used. |
| Connectors | Configure local connectors that reach private or self-hosted VCS providers. |
| API Keys | Create keys for programmatic use of the Acrity public API. |
| Webhooks | Send workspace events to external systems. |
| Workspace Members | Invite people, change roles, and remove workspace access. |
| Docs | Open the Acrity documentation. |
| Policy Engine | Configure workspace-level review policies. |
| Audit Trail | View technical and administrative event history, diagnostics, and audit details for the workspace. |
Adjacent destinations
Two related areas are reached from outside the left navigation:| Destination | How you reach it | What it is for |
|---|---|---|
| Ops dashboard | Open it from the Console system switcher. | Track review status, decisions, findings, and operational follow-up. |
| Workspace settings | Open it from the Overview dashboard or the Workspaces list. | Review and edit the settings of the selected workspace, such as name, language, and allowed domains. |
The Overview dashboard
Overview is the first screen you see for a workspace. It orients you and surfaces the next action.
First-time setup checklist
For a new workspace, the dashboard shows a setup checklist that walks you through the minimum needed to receive reviews:Configure VCS access
Install a Connected App, or register a manual credential or local connector, so Acrity can reach your Git provider.
Quick actions
Quick actions are shortcuts to the tasks you run most often, such as connecting a repository, inviting a member, opening the Policy Engine, or jumping to Billing. They target the same areas as the left navigation, so you never have to hunt for the starting point.Status tiles
Status tiles summarize the workspace at a glance and highlight anything that needs attention, including:- connected repositories and how many are ready for review;
- Connected Apps, credentials, and connectors, with any that need reauthorization or revalidation;
- recent review activity;
- billing state, including trial, wallet balance, and spend cap.
Inbound webhook and review triggers
The dashboard shows an inbound webhook card with the endpoint URL and a signing secret. This is how your Git provider tells Acrity that a pull or merge request needs a review.- When you use a Connected App, this webhook is registered for you.
- When you use a manual credential or a local connector, copy the URL and signing secret into your provider’s webhook settings.
Explore the Console
Repositories
Connect repositories and set review, branch rules, and architecture bootstrap.
Connected Apps
Install OAuth integrations and official provider apps.
Credentials
Register manual provider credentials when a Connected App is not used.
Connectors
Reach private or self-hosted VCS providers with local connectors.
Policy Engine
Configure workspace-level review policies.
Workspace Members
Invite people, change roles, and manage access.
Webhooks
Send workspace events to external systems.
API Keys
Create keys for the Acrity public API.
Billing
Manage trial, wallet, usage, invoices, and spend caps.
Audit Trail
Review technical and administrative event history.
Recommended setup flow
Select the workspace
Use the workspace selector. Confirm name, description, language, and allowed domains where visible.
Invite workspace admins
Go to
Console > Workspace Members and add the people responsible for repositories, integrations, and billing.Connect providers
Use
Console > Connected Apps for OAuth integrations or official apps. Use Console > Credentials when a manual credential is required.Connect repositories
Go to
Console > Repositories > Connect repository, choose the source, and review initial settings.Adjust review policies
Use
Console > Policy Engine for workspace defaults and Console > Repositories > Repository detail > Review for repository-level exceptions.Configure outbound integrations
Use
Console > Webhooks and Console > API Keys when external systems need to receive events or query the public API.Attention indicators
The Console highlights menus with alerts when there are pending actions, such as:- credentials that are invalid, pending, or need validation;
- repositories not yet ready for review;
- Connected Apps that require reauthorization;
- connectors that are offline or whose last revalidation failed;
- suspended billing, an ended trial, insufficient wallet, or a reached spend cap.
Where to configure each area
| I need to configure… | Go to… |
|---|---|
| Workspace name, language, or domains | Workspace settings (from the Workspaces list) |
| People and roles | Console > Workspace Members |
| GitHub, GitLab, Bitbucket, Azure DevOps, Jira, Linear, or ClickUp app | Console > Connected Apps |
| Manual provider token | Console > Credentials |
| Private or self-hosted VCS | Console > Connectors |
| Repositories and branch rules | Console > Repositories |
| Default review policy | Console > Policy Engine |
| Repository-level review exception | Console > Repositories > Detail > Review |
| Review tracking and outcomes | Ops dashboard |
| Events for external systems | Console > Webhooks |
| Programmatic access | Console > API Keys |
| Trial, wallet, usage, and invoices | Console > Billing |
| Technical event history and diagnostics | Console > Audit Trail |