Skip to main content

Workspace basics

A workspace contains the repositories, members, teams, practice catalog, integrations, and feature settings for one group. A Hephaestus deployment can host more than one workspace, and a person can belong to several.

Use the workspace switcher at the top of the sidebar to move between the workspaces you can access.

Create a workspace​

Who can create workspaces depends on the deployment. The default policy limits creation to instance admins.

When creation is available:

  • GitHub: install the Hephaestus GitHub App on an organisation. Hephaestus creates the workspace from the installation.
  • GitLab: connect a supported GitLab instance with an access token, choose a group, and finish the creation wizard.

If Create workspace is not available to you, ask an instance admin.

Repositories​

How repository access is managed depends on the connection:

  • For a GitHub App workspace, change repository access in the app installation on GitHub. Hephaestus mirrors the repositories granted to the app.
  • For a token-managed workspace, a workspace admin can open Admin → Integrations, enter a repository as owner/name, and select Add. Removing a monitored repository permanently deletes the data Hephaestus mirrored from it; the upstream repository is not changed.

Initial sync time depends on the size and history of the connected repositories. Later changes are picked up by webhooks and scheduled reconciliation.

Members and teams​

Members and teams are scoped to one workspace.

  • GitHub App workspaces mirror organisation members, teams, and repository access from GitHub.
  • GitLab workspaces mirror the connected group and its projects.
  • Workspace admins can review membership and role information in Admin.

If source-managed membership is wrong, correct it in GitHub or GitLab and wait for the next sync.

Practices and AI​

Workspace admins choose:

  • which engineering practices are active
  • whether practice reviews run automatically or can be triggered manually
  • whether Heph is available
  • which connected AI model powers practice reviews and Heph
  • the monthly AI spending cap

These settings apply only to that workspace.

Optional features​

Workspace admins can separately enable achievements, the leaderboard, progression, leagues, and Slack. A feature that is off does not appear in the member navigation.

Troubleshooting​

  • Workspace missing? Confirm that you are signed in with an identity linked to a workspace member.
  • Repository missing? Check the GitHub App installation or the monitored repository list, depending on the connection type.
  • Team missing? Confirm that the team exists in the connected source platform and has synced.
  • Feature missing? Ask a workspace admin whether it is enabled and whether your account has access.