Organizations
An organization is your company’s account in Ren. It holds your members, billing, labels, organization credentials, and channel connections like Slack and GitHub.
Ren creates an organization when you register without an invitation. If Ren recognizes a company email domain, it uses that domain to name the organization. Ren also creates a shared General space and a private Personal space. If you register through an invitation, you join the inviting organization instead.
Switch organizations
You can belong to several organizations, like your company’s and a client’s. Switching organizations changes which chats, spaces, and settings you see.
- Select your name at the bottom of the sidebar. The organization you’re in shows under your name.
- Select another organization to switch to it.
To add an organization, select Create organization, enter a name, and add a logo if you want.
ren org listren org switch <org-id>ren org create "Acme"ren org create switches your CLI profile to the new organization.
Organization settings
Only owners and admins can change organization settings.
| Setting | What it changes |
|---|---|
| Name and icon | How the organization appears in the sidebar and the organization menu. |
| Timezone | The default time zone for new schedules. |
| Default model | The model chats use when the space, the project, and the chat don’t pick one. |
| Instructions | Rules Ren follows in every chat in the organization. Space and project instructions also apply. See Instructions. |
- Open Settings → General.
- Edit the name, time zone, or default model. Each change saves automatically.
- Under Instructions, enter guidance for every chat, like your company’s writing style.
ren orgs update --instructions "Write dates as YYYY-MM-DD and use US English."Members
Every member has one of three roles:
- Member: uses Ren in the spaces they belong to, and creates their own spaces, projects, chats, and tasks.
- Admin: everything a member can do, plus the organization settings, members, billing, channel connections, and organization-wide storage and environments. An admin can also join any shared space in the organization.
- Owner: the same access as an admin, for the people responsible for the organization.
Invite a teammate
- Open Settings → Members.
- Select Add member.
- Enter one or more email addresses, separated by commas or new lines.
- Choose a Role, then select Send invite.
Each invitee gets an email with a link to join. When they join, they’re added to the General space and get their own personal space. They also join any shared spaces you added them to while the invitation was pending.
Manage invitations and members
The Invitations tab lists pending invitations. You can copy an invitation link, resend the invitation, or revoke it. Invitations expire after seven days.
On the Members tab, change someone’s role from the Role menu, or select Remove to take them out of the organization and all of its spaces.