Organizations

An organization is the top-level grouping in WarmHub. It owns repositories, holds members, and controls access.

Organizations List

When you’re signed in, the organizations page displays a grid of cards — one for each organization you belong to. Each card shows the organization’s display name and description, and a Create Organization button sits at the top to add a new one.

If you aren’t signed in, private deployments show an in-app welcome card with a Sign in button on this route (rather than an automatic redirect). Some deployments allow public browsing; on those, this page shows an empty grid (you only see organizations you belong to) but you can still open a specific org’s detail page if you have its URL.

Organization Detail

Click any organization card to open its detail page. The layout is split into two areas.

Main Content

• Repository list — Repositories in the organization, displayed in a paginated list. Members see all repos; non-members see only public repos. (Signed-out visitors only reach this page on public-browsing deployments — see above.) If there are more repositories than fit on one page, click Load More to fetch the next batch.
• Create Repository — A button that opens a dialog for adding a new repository. Visible to org owners and admins. (See the authentication documentation for what each role can do.)

Right Sidebar

• About section — Shows the organization description and creation date. Users with org:settings permission (admins and above) see a pencil icon next to the “About” heading — click it to edit the description in a markdown editor dialog.
• Members and roles — Signed-in members can see who is in the org and each member’s role. The Manage members controls (people icon + role editing dialog) are limited to owners and admins.

Member Management

Users with org:manage_members permission (admins and above) see a people icon button in the page header (labeled “Manage members” for screen readers). Click it to open a dialog where you can add new members or change existing roles.

For more on how permissions and authentication work, see the authentication documentation.

Live Flow

Each organization has a Live Flow link that opens the real-time flow visualization. Live Flow is members-only — only members of the org can open it. See Live Flow for details on what this view offers.

CLI Equivalents

Many organization tasks can also be performed from the terminal:

• wh org list — list organizations you belong to.
• wh org create — create a new organization.
• wh org view <name> — inspect a specific organization.
• wh org member list <org> — list members and roles for an organization.
• wh org member add <org> <email> --role <role> — invite a member with a role.
• wh org member set-role <org> <email> --role <role> — update a member’s role.
• wh org member remove <org> <email> — remove a member from an organization.

See the CLI documentation for the full command reference.