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, you are redirected to / automatically once the app finishes loading — the organizations page is not accessible to unauthenticated visitors.

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. 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 access reference for what each role can do.)

Right Sidebar

• About section — Shows the organization description and creation date. Users with org:configure 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 Invite button in the sidebar (limited to owners and admins) opens a dialog where you can add new members or change existing roles.

Member Management

Users with org:configure permission (admins and above) see an Invite button in the organization sidebar. Click it to open a dialog where you can add new members or change existing roles.

Each member has one role — viewer, editor, admin, or owner. For exactly what each role can and can’t do (and which scope a token needs for a given task), see the access reference. For sign-in and account setup, see Getting Access.

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.