Feature · Crew

Governance

See the board, the advisors and who holds a stake.

Last changed

Generated from commit 41b15e5 ·

How it works

Offices and roles

An office is a seat on Governance. It is separate from the member role. The owner role stays the top role for work. The person who made the organization is the first director and the chair. Until a director seat exists, the owners act as the board.

Who decides what

  • A director decides owner-reserved questions and votes on board requests.
  • The chair gets owner-reserved questions first. Only the chair moves the chair.
  • An advisor reads and comments on approvals and questions. An advisor never decides.
  • A shareholder holds a stake. A stake gives money and reports, not a vote.

The board quorum

Set governance.boardQuorum on Settings. With 2, two different directors must approve each owner-reserved request and each hire. One vote leaves the request open. A second vote from the same director counts one time. The person who asks never votes. Only an owner or a director changes this setting.

The stake register

Owners and directors record a grant, a vest, a transfer or a cancel. A person, an AI employee or an outside organization can hold a stake. Equity and options together stay at or below 100%. A transfer moves vested shares only. Other people see their own holdings and the totals.

From the help article Governance: the board, advisors and stakes, checked against the product on .

What you can do

The operations this feature's screens call. Each one is POST /api/<name>, and the badge says who may call it.

  • getGovernance

    Viewer

    The board (directors and the chair), the advisors and the shareholders. Only owners and directors see every shareholder.

    Types: Record<string, never> returns GovernanceViewDto

  • getStakeRegister

    Viewer

    The stake register. Owners and directors see every holding; others see their own holdings and the totals per class.

    Types: Record<string, never> returns StakeRegisterDto

  • setBoardChair

    ViewerNo API tokens

    Moves the chair to another director. Only the chair, or an owner when the board has no chair.

    Types: { seatId: string } returns GovernanceViewDto

  • endGovernanceSeat

    ViewerNo API tokens

    End governance seat.

    Types: { seatId: string } returns GovernanceViewDto

  • listMembers

    Viewer

    Lists members.

    Types: EmptyRequest returns ListMembersResponse

  • listWorkers

    Viewer

    Lists workers.

    Types: ListWorkersRequest returns ListResponse<WorkerSummary>

  • appointGovernanceSeat

    ViewerNo API tokens

    Gives a person a director, advisor or shareholder seat, or a worker or an organization a shareholder seat. Owners and directors only.

    Types: AppointGovernanceSeatRequest returns GovernanceViewDto

  • recordStakeEvent

    ViewerNo API tokens

    Appends a grant, vest, transfer or cancel to the stake ledger. Owners and directors only.

    Types: RecordStakeEventRequest returns StakeRegisterDto

Screens

What it records

The feature writes these events to the audit log, the permanent record of what happened.

  • Account security changed
  • API token created
  • API token revoked
  • Decision comment added
  • Governance seat changed
  • Member added
  • Member role changed
  • Org created
  • Stake ledger recorded
  • User signed in

Generated from code at commit 41b15e5 ·

Turn the numbers into shipped work.

Crewshal runs these choices for you: a persistent AI worker with memory and rules, on your Claude and Codex subscriptions.