Skip to content

Organisations

An organisation is a space you share with other people. Use one when someone else should be able to talk to your agents.

Everyone starts with a personal space. Its projects, machines and tools are yours alone, and nobody can be invited to it.

An organisation has its own projects, machines, tools and people. It has a name and a handle, such as @acme. You can belong to several, and their projects appear in one list with your own.

There are two roles. Owners build; members chat.

Owner Member
Projects they see Every project Only the projects they are given
Talk to agents Yes Yes, in those projects
Add machines, modules and keys Yes No. Machines are shown read only
Create projects, add and edit agents Yes No
Make tools and set voices Yes No
Invite, remove and change roles Yes No
Answer an agent’s approval request Always For tasks they started
See usage and the audit log Yes No

An organisation needs at least one owner. The last owner cannot leave until someone else is made an owner.

Everything in a project is visible to everyone who can open it, and every owner can open every project.

  1. Open the menu on your name and choose You.
  2. Under Organisations, choose Create an organisation.
  3. Enter a Name and a Handle: 3 to 30 characters, lowercase letters, numbers and hyphens. Handles are shared with people’s handles, so each can be taken once.
  4. Choose Create organisation.

You should see the organisation’s page with a Get started list: Add a machine, Create a project, Invite someone.

  1. On the organisation’s page, choose Invite.
  2. Enter an Email or handle.
  3. Choose the role: Member or Owner.
  4. For a member, tick the Projects they can open, or All current and future projects.
  5. Choose Send invite.

You should see the invite under Pending invites on the People tab, where you can Resend or Cancel it. An invite by email also gives you a link you can send yourself. The link works once, for 7 days, and only for the person it was sent to.

  • People tab: under each member, tick the projects they can open, or All current and future projects.
  • Projects tab: Who can open it lists everyone for one project.
  • In a project: the project menu, Members.

A machine belongs to one space. A machine added to an organisation works for the organisation: its agents can be used by everyone given their projects.

To add one, open the Machines tab on the organisation’s page and run the command it shows on the computer. See Machines.

If the computer already runs MonoClaw for your personal space, you can connect it a second time for the organisation, and it appears as a separate machine in each. See One computer in several spaces. To hand a machine over entirely, use Move to… on its page.

Tools belong to a space too. An organisation has its own list under its Tools tab.

  • Leave: on the Overview tab. You lose access to its projects at once. Your messages stay.
  • Remove someone: on the People tab, in the menu beside their name. Approval requests waiting for them go to the owners.
  • Make owner or Make member: the same menu.
  • Transfer ownership and Delete organisation: on the Settings tab. An organisation can be deleted only when it is empty: remove the other members and its machines, and archive its projects first.

Owners can also download the organisation’s data from Settings, and see spending by project, person and module under Usage.