Nestr help documentation

Importing Data from Peerdom

Nestr can import your organisational structure from Peerdom. Circles, roles, accountabilities, domains, projects and users are all brought across so you can continue where you left off.

To get started, create a new workspace or head into an existing one. Navigate to the workspace settings page.

Screenshot of the Peerdom import settings in Nestr
As a workspace admin, navigate to the workspace settings.

Once there, navigate to the 'Integrations' tab and enable the Peerdom integration.

Screenshot enabling the Peerdom integration in Nestr
Open the "Integrations" app and enable the Peerdom integration.

You will need your Peerdom API key.

To get your API key, log into Peerdom and navigate to your organisation settings. Copy the API key.

After entering both values in Nestr, you can choose your import options:

  • Import users from Peerdom: imports user profiles and role assignments into Nestr without sending invitations.
  • Invite imported users to Nestr: sends email invitations to the imported users so they can start using Nestr immediately.

Click Synchronize to start the import. Depending on the size of your organisation, this may take a few seconds to several minutes. You can let it run in the background.

To update your data after changes in Peerdom, simply click the Synchronize button again and Nestr will import the latest changes.

After importing: what to expect and what to set up manually

After importing your data from GlassFrog, Holaspirit, or Peerdom, there are a few things to check and set up to make sure everything is working as expected.

What transfers during import

  • All Circles, Roles and their accountabilities and domains
  • Policies
  • Projects andtasks
  • Users (if you select this)
  • User assignments to roles and projects
  • Role/circle notes
  • OKRs if the source platform supports it

What does NOT transfer

  • Chat messages and feed posts
  • Feedback records
  • Meeting records
  • Custom integrations or settings

Common issues after import

Missing role fillers

Role assignments won't come through if you opted not to import the users. In that case, manually add them and assign the right user to roles:

  1. Find the grey roles in the circle/role structure or go to Structure → Roles in each circle.
  2. Review which roles are unfilled.
  3. Manually assign the correct people.
Assign people to your unfilled roles
Assign people to your unfilled roles

Roles in the wrong circle

Occasionally you might want to take the oppertunity to make some changes during your transfer of data and move roles/circles around. In that case:

  • Check the circle structure matches your source platform.
  • Move roles to the correct circle via governance proposals or use the ... in the right top of the role and select 'Move item...' which will allow you to move the role to another circle (if you have admin rights).

What to set up manually

After a successful import, complete your setup:

  1. Invite users — if the import didn't include user invitations, you can run the import again with the invite setting enabled or you can invite your team manually via Workspace settings → Users.
  2. Assign role fillers — make sure every role has the right person assigned.
  3. Enable apps — turn on features like Meetings, Projects, Feedback in Workspace settings → Applications.
  4. Set up meetings — your meeting history doesn't transfer, so schedule your first meeting in Nestr.
  5. Do a sanity check — verify that the import is correct by checking a few circles/roles/projects for completeness. It sometimes happens that other tools change their API leading to some missing information. In that case, contact us and we'll make sure to resolve it for you.

Re-syncing data

The GlassFrog, Holaspirit, and Peerdom integrations all support re-sync. Click the sync button in Workspace settings → Integrations to pull in the latest changes from your source platform. This is useful if you're running both tools in parallel during a transition period.

Importing from another tool

If you have your records in excel or another format contact the Nestr team and we'll import it manually for you. We can even import a hand drawn picture with some circles on it.

Files & attachments in Nestr

Nestr allows you to attach files and documents to various items throughout your workspace, keeping information connected to the work it relates to.

Where you can upload files

Files can be attached to:

  • Projects — attach documents, spreadsheets, or images related to a project.
  • Meeting agenda items — attach supporting material for discussion.
  • Roles and circles — attach reference documents, guidelines, or policies.
  • Notes — embed files within rich text notes.
  • Comments — attach files to conversation threads.

How to upload a file

  1. Open the item you want to attach a file to (project, agenda item, role, etc.).
  2. Drag the file onto the project, agenda item, role etc. and drop.
  3. The file uploads and appears as an attachment.
Simply drag your files onto any item in Nestr and it will be attached.
Simply drag your files onto any item in Nestr and it will be attached.

You can also use the context menu to attach files which will open your file explorer.

From the item context menu you can select 'Upload a file'
From the item context menu you can select 'Upload a file'

Viewing uploaded files

Uploaded files appear as clickable icons. Depending on the file type:

  • Images display inline as previews.
  • PDFs can often be previewed in the browser.
  • Other file types download when clicked.
Attachments show up on your item directly and can be downloaded/viewed by clicking them.
Attachments show up on your item directly and can be downloaded/viewed by clicking them.

Linking to external documents

For documents stored in external systems (SharePoint, Google Drive, Notion, etc.), you can paste links directly into descriptions, comments, or notes. The link will be clickable for anyone with access to the external document.

Tip: Use a consistent approach for your team — either upload files directly to Nestr for centralised storage, or link to external documents for single-source-of-truth workflows.

File size and types

Nestr supports common file types including documents (PDF, DOCX, XLSX), images (PNG, JPG, GIF), and presentations (PPTX). There are file size limits per upload — for very large files, consider linking to an external storage service instead.

Managing your profile & account settings

Your Nestr profile is visible to colleagues across all your workspaces. Keep it up to date so your team knows who you are.

Updating your profile

  1. Click your avatar or profile icon in the top right corner.
  2. Select Profile or Settings.
  3. Update your details:
    • Profile photo — click the avatar to upload a new image.
    • Name — update your first and last name.
    • Bio — add a short description about yourself.
Update your profile picture, name and bio.
Update your profile picture, name and bio.

Changing your email address

  1. Go to your profile settings.
  2. Update your email address.
  3. You'll receive a verification code at the new address.
  4. Enter the code to confirm the change.

Not receiving the verification code? Check your spam/junk folder. If it still doesn't arrive, try using a different email provider or contact support.

Setting your language

Nestr is available in multiple languages. To change your interface language:

  1. Go to your profile settings.
  2. Look for the language selector.
  3. Choose your preferred language. We currently support English, Spanish, Portughese, German, Italian, Fernch, Polish, Danish and Dutch.

The interface will update immediately. Note that user-generated content (role names, project titles, etc.) stays in whatever language it was written in.

Edit your emails, language and password on your settings page.

Creating and revoking API keys

At the bottom of your setting page you can also create new personal API keys and review all API access granted to other tools. For example if you have enabled AI bots access to your account. You can manually create a new key to use or you can revoke access of tools you wish to no longer have access to your account (note that this will result in these integrations failing if they are still active).

Integrating Nestr with other tools

Nestr can connect with the tools you already use. This guide provides an overview of integration options, from no-code platforms to custom API development.

Supported integrations

Built-in integrations

These integrations are configured directly in Workspace settings → Integrations:

[SCREENSHOT #1]

No-code integrations (Zapier / Make)

Use Nestr's API with Zapier or Make (formerly Integromat) to create automated workflows:

  • When a new project is created in Nestr, post to Slack
  • When a user is added to your CRM, invite them to Nestr
  • Sync task completion between Nestr and other project tools

To set up, you'll need your API key (see Using the Nestr API) and the Nestr API endpoints from our API documentation.

Common integration questions

Does Nestr integrate with Google Calendar?

Nestr does not currently have a direct Google Calendar integration. Meetings in Nestr are managed within the platform. You can manually create calendar events and link to your Nestr meeting.

Can I connect Microsoft Teams / Planner?

There is no direct Microsoft Teams integration. You can use the API via Make or Zapier to bridge data between the platforms.

Can I import from Asana / Trello / other project tools?

For tools without a built-in integration, contact us and we'll help import your data, or use the API to build a custom sync.

Building custom integrations

Nestr's REST API gives you full programmatic access to your workspace. See Using the Nestr API for authentication details and the API documentation for available endpoints.

Pricing & plans: what you pay for and who counts as a user

Nestr's pricing is designed to be accessible to organisations of all sizes, from small teams experimenting with self-organisation to large enterprises.

What counts as a paid user?

Anyone with login access to your workspace counts as a user. This includes:

  • Active members who fill roles and participate in meetings
  • Users who have accepted their invitation

Users who have been invited but haven't yet accepted ("silent" users) or who have been suspended do not count toward your user total.

View-only access

If you want stakeholders to see your organisational structure without participating, consider using the Published Workspace feature instead. This makes your circle and role structure publicly viewable without requiring a Nestr account, at no additional cost. Enable it in Workspace settings → Applications.

The free trial

Every new workspace starts with a free trial period. During the trial, you have access to all features. When the trial ends, you can choose a plan that fits your needs or contact us to discuss options.

Nonprofit and social impact pricing

Nestr offers special pricing for nonprofits, NGOs, cooperatives, and social impact organisations. Contact us to learn about discounted plans tailored to purpose-driven organisations. Nestr operates with a pay-what-you-can approach for qualifying organisations. We believe everyone should have access to tools for effective self-organisation, regardless of budget. Reach out to discuss what works for your situation.

Multiple workspaces

Pricing is per workspace, not per user across all workspaces. If you have multiple workspaces, each has its own plan and user count. A person who is a member of multiple workspaces counts as one user in each workspace.

Managing your subscription

  1. Go to Workspace settings → Plan & Billing.
  2. Here you can view your current plan, update payment details, and manage your subscription.
Choose the plan that best suits your needs.
Choose the plan that best suits your needs.

For billing questions or invoice requests, contact our team.

Configuring your workspace: settings, features & visibility

Once your workspace is created, you can configure it to match exactly how your organisation works. Nestr doesn’t force a single way of working on your team — instead, the Applications tab lets you pick and choose the features that make sense for you. Whether you practise Holacracy, Sociocracy, or your own flavour of self-management, you enable only what you need and leave the rest off.

This guide covers the key workspace settings, with a focus on the Applications tab.

Accessing workspace settings

  1. Navigate to your workspace.
  2. Click the settings icon (gear) in the left sidebar.
  3. The settings panel opens with tabs on the left.

Only workspace admins and owners can access most settings.

Settings tabs overview

  • Users — Invite, manage, and remove workspace members
  • Workspace details — Title, purpose, icon, and description
  • Plan & Billing — Subscription plan and payment
  • User Permissions & Domains — Auto-join domains and approval settings
  • Labels, Fields & Tabs — Custom labels, fields, and tab configuration
  • Applications — Enable or disable workspace features (see below)
  • Integrations — External tool connections (API, SCIM, SAML, etc.)
Customize what apps are available to suit your organisational needs.
Customize what apps are available to suit your organisational needs.

Applications: customise Nestr to your way of working

Every organisation is different. Some teams run full Holacracy with tactical meetings, governance proposals, and metrics. Others just need a simple project board and a few notes. The Applications tab is where you make Nestr yours — toggle features on or off so the interface shows only what your team actually uses, with no clutter from features you don’t need.

Each application has a simple on/off switch. Some apps reveal additional configuration options when enabled. You can change these settings at any time — enabling an app makes it available across your workspace, and disabling it hides it without deleting any data.

Available applications

  • Self Organisation — The foundation for structured self-management. Choose between Custom, Holacracy, or Sociocracy mode to match your governance framework. Enabling this unlocks several sub-apps listed below.
  • Default Circle Roles — Define template roles (Circle Lead, Facilitator, Secretary, Rep Link) that are automatically added when new circles are created. You can also add your own custom role templates.
  • Domains & Policies — Let circles and roles define the properties they own (domains) and the rules for how others may interact with them (policies).
  • Circle Meetings — Run structured tactical and governance meetings with built-in agenda processing, tension rounds, and optional auto-closing of governance proposals.
  • Checklists — Track recurring tasks and responsibilities for each role, reviewed during tactical meetings.
  • Metrics — Define measurable indicators for each role to monitor the health of a circle over time.
  • Projects & Todos — Capture and track projects and action items across your workspace with board and list views.
  • Objectives & Key Results (OKRs) — Set strategic objectives for circles and teams and track the key results needed to achieve them. (Pro plan)
  • Notes — Add documentation pages to circles, teams, and roles so your team can capture and share relevant information.
  • Feed — Add a communication feed to circles and roles, giving your team configurable channels for updates and discussions.
  • Insights — Gain analytics into your organisation’s health — track contributions, governance activity, and operational performance per circle and per user.
  • Feedback — Enable peer feedback so your team can give and receive personal and role-based feedback using built-in or custom feedback forms. (Pro plan)

Sub-apps under Self Organisation

Some of the applications above are grouped under Self Organisation. When you enable Self Organisation, it unlocks access to Default Circle Roles, Domains & Policies, Circle Meetings, Checklists, Metrics, and Insights. You can then toggle each sub-app independently — for example, you might use Circle Meetings and Metrics but leave Checklists off.

Integrations tab

The Integrations tab contains apps that connect Nestr to external tools and services, such as API access, SCIM user provisioning, SAML single sign-on, and more.

Managing multiple workspaces

You can be a member of multiple workspaces. Switch between them using the workspace selector in the left sidebar. Each workspace operates independently with its own settings, members, and governance structure.

To create a new workspace, click Add workspace in the workspace selector.

Deleting a workspace

Only the workspace owner can delete a workspace:

  1. Go to Workspace settings → Workspace details.
  2. Scroll to the bottom.
  3. Click Delete workspace.
  4. Confirm the deletion.

Warning: This action is irreversible. All workspace data, including roles, circles, projects, meetings, and governance records, will be permanently deleted.

Managing users, invitations & permissions

Managing who has access to your workspace and what they can do is essential for effective collaboration. This guide covers inviting users, setting permissions, and managing your team in Nestr.

Inviting users to your workspace

Only workspace admins can invite new users. There are three ways to invite people:

Method 1: Invite by email

  1. Navigate to Workspace settings → Users.
  2. Click Invite users.
  3. In the dialog, enter one or more email addresses in the "Add emails" field.
  4. Click Invite users.
Inviting users into your workspace
Inviting users into your workspace

Each invitee receives an email with a link to join your workspace. There is a daily limit on invitations (typically 20 per day - contact us if you need this to be higher).

Method 2: Share an invite link

In the same invite dialog, you'll find a shareable invite link. Copy and share this link with anyone you'd like to invite. If admin approval is required, new users will need to be accepted before they gain access.

Permission levels

Nestr has three standard permission levels for workspace members:

  1. Owner: Full control - transfer ownership, assign/revoke admin, delete workspace, manage billing information, all admin
  2. Admin: Invite/remove users, manage settings, access all configuration, grant admin to others
  3. Member: View workspace content, fill roles, participate in meetings, manage their own work

Members can be grated admin/assigner rights for a specific circle either manually or by assigning them to a role that has those rights. On a Pro workspaces, you can also setup new rights groups to suit your specific needs. Please contact us to enable this on your account.

Changing permissions

  1. Go to Workspace settings → Users.
  2. Find the user in the list.
  3. Click on the user to assign/revoke rights.
Add/remove rights to a user
Add/remove rights to a user

Transferring workspace ownership

Only the current owner (or a super-admin) can transfer ownership:

  1. Go to Workspace settings → Users.
  2. The target user must already be an admin.
  3. Click Designate owner next to their name.
  4. Confirm the transfer in the dialog.

After transfer, the previous owner retains admin rights but loses owner-level control.

Removing a user

  1. Go to Workspace settings → Users.
  2. Click Remove next to the user you want to remove.
  3. Confirm the removal.

The user is suspended from the workspace and unassigned from all active roles, projects, and tasks. They can be re-invited later if needed.

Leaving a workspace

Any member can leave a workspace voluntarily:

  1. Go to Workspace settings → Users.
  2. Click Leave workspace next to your own name.
  3. Confirm: you'll lose access and be unassigned from all items.

Troubleshooting invitations

User doesn't receive the invitation email

  • Check their spam/junk folder.
  • Verify the email address was entered correctly.
  • Use the (Re)send invite option next to silent users in the Users tab.

"Email is already registered" error when creating a use through the API

When you create new users through the API, the person may already have a Nestr account with that email. Ask them to log in with their existing credentials, then invite them to your workspace by email.

"Only members can view this content"

The invitation may not have been accepted yet, or the user may be in a suspended state. Check the Users tab for their status and resend the invite if needed.

Domain-based access

For organisations with a company email domain, you can configure automatic access:

  1. Go to Workspace settings → User Permissions & Domains.
  2. Add your company's email domain.
  3. Choose whether users from that domain can join automatically or require admin approval.
Associate your organisational domains with your nestr workspace
Associate your organisational domains with your nestr workspace

Tensions & governance proposals: from tension to decision

New to self-organisation in Nestr? Start with Structure & Governance in Nestr to understand roles, circles, and governance basics.

An agenda-item or tension is a gap between how things are and how they could be. In Nestr, tensions are the engine that drives organisational evolution. They can surface operational needs ("I need help with this project") or structural ones ("We need a new role for this work").

Tensions vs agenda items

In Nestr these are the same, depending on your workspace settigns we'll change the wording to better align with the organisational norms. If you use Holacracy, Nestr will speak about tensions where for all other forms of Role-based work, we asddress them as agenda items. They are designed to help you move from a sensed issue or opportunity to a desired outcome, even if the outcome.

Creating a tension/agenda item

  1. Click the + Create button in the left sidebar.
  2. Select Create tension/agenda item.
  3. In the dialog:
    • Enter a title - this is just a placeholder for you to remember what it is about. Keep it short.
    • Select the raising role (the role sensing the tension) or select the circle where you sense the tension personally (this defaults to the circle/role open on the page).
    • Optionally describe what you observe (Situation, data & fact).
    • Optionally, if you already know, select the type of output you want to capture. Operational or governance.
    • Optionally, under advanced, set this agenda item/tension to private if it contains sensitive information.
  4. Click Create.
Create a new agenda item/tension from the + Create button or from your circle's meetings tab
Create a new agenda item/tension from the + Create button or from your circle's meetings tab

Once created, the new agenda item/tension will open. There you can:

Capturing output

  1. Optionally share your Personal feeling. This helps to differentiate between how you feel and what is required so that our personal feelings have a place, but do not hijack organisational decisions.
  2. Optionally share what your Needs are. This is a textual way to describe the outcome you would like to achieve.
  3. Then you can describe the outcome that will resolve the tension/agenda item. It the resolution is operational, assign an outcome. If the resolution is a structural change to your organisational governance add/change/remove a role/circle/policy, click add a governance proposal part (below we'll elaborate that process)
    1. From the drop down, select the type of outcome: Project, Todo or a Decision.
    2. In the Outcome field describe the exact deliverable.
    3. Select the role accountable for delivering the outcome
    4. Select the person in that role to take on the work
    5. Click Add outcome.
    6. Repeat these steps if your tension/agenda item require multiple outcomes to be resolved.
  4. You can choose to save the tension/agenda item for the next circle meeting, or request the work. If saved for a meeting it will show up as a prepared tension/agenda item to be processed in the next meeting. If you request, the role fillers from whom you requested work will be notified and the can accept or amend the request. You optionally can use the comments section to dicuss any further clarifications.
Capture your feelings, needs and outcome and request the work from your peers.
Capture your feelings, needs and outcome and request the work from your peers.

Creating a governance proposal

Governance proposals let you change your organisation's structure: create, modify, or remove roles, circles, accountabilities, domains, and policies. Create the tension/agenda item just as mentioned above. But rather then creating it as an oporational tension or capturing output, select the governance option:

  1. Use the + Create button or navigate to a circle's Work → Meetings tab.
  2. Click Add agenda item/tension.
  3. Choose type: Governance tension.
  4. In the proposal, click one of the action buttons:
    • New role — propose creating a new role
    • New circle — propose creating a new circle
    • New policy — propose a new policy
    • Hold election — propose electing someone to a governance role
  5. Or select an existing role/circle/policy to propose modifications or to remove.
Governance proposals contain of one or more parts to add/update/remove roles, circles, policies or hold elections
Governance proposals contain of one or more parts to add/update/remove roles, circles, policies or hold elections

Creating or editing a role or circle

When creating or editing a role or circle, the role/circle we show completely editable. Set the title, purpose, accountabilities and domains to what they need to be. It does not need to be perfect, if the proposal get's you one step closer to resolving your tension/agenda item, it is ready for proposing.

Not that for roles, there is an "Apply template" drop down in the right top which allows you to apply any defined role template to your proposal. These are role templates defined in the workspace settings. The same drop down also allows you to copy any existing role in your organisation or create a Cross-link from another circle into this circle.

Update your new or existing role or circle to suit your tension/agenda item.
Update your new or existing role or circle to suit your tension/agenda item.

In the right top for each proposal part you can toggle between the edit and differences views so that you and your peers can review the actual changes made in the proposal parts.

Toggle between the edit and differences views for the individual proposal parts.
Toggle between the edit and differences views for the individual proposal parts.

Hold an election

Role elections are also part of the governance process. You can hold an election for any role that is marked as electable (set under advanced settings in the role proposal or set under 'item settings' if you are an admin for the workspace or circle).

  1. Click the Hold election button on the new proposal part.
  2. Select the electable role you wish to elect a member for.
  3. Select the user elected through your own election process run asynchronously or in your meeting. The current circle members are available in the drop down and use the search inthe field to find users currently not in your circle to elect external members into this role.
  4. Select the term for the election.
Elect a user into a role using the election proposal.
Elect a user into a role using the election proposal.

Propose your proposal

When your proposal is complete, you can save if for the next governance/structure meeting, or you can propose it asynchronously. When you propose asynchronously, all circle members will get an email to invite them to respond. By default they will be presented with the differences view to draw their attention to only what you changed. They can ask questions and share reactions in the comments and click 'Escalate to meeting' or 'No objection' to consent. By default, if a user does not respond, it will be auto consented in 5 days. Once all members have consented or after the 5 day period has passed, the proposal will be adopted and your proposal will become part of your organisational governance.

Deleting a tension

To delete a tension you've raised:

  1. Navigate to the tension detail page.
  2. Click the ... on the tension page and select 'Delete item'
  3. Confirm the deletion in the dialog: "Are you sure that you want to delete this tension?"

Deleted tensions are soft-deleted and can be recovered from the activity stream in the circle.

Tips

  • Start with tensions, not solutions — describe the gap you're experiencing before jumping to a governance proposal.
  • Use async governance — for straightforward changes, async consent saves meeting time.
  • Check the diff view — always review what a proposal will actually change before voting.
  • Prepare tensions before meetings — add agenda items in advance so the facilitator can plan the meeting effectively.

Projects & todos: creating, tracking and managing work

In Nestr, work lives under roles. Projects track multi-step outcomes, while todos capture individual next actions. This keeps everything transparent: anyone can see what's happening without asking.

Creating a project

From My Projects

  1. Click My projects in the left sidebar.
  2. Click the New project button in the header.
  3. In the dialog that appears:
    • Enter a project title.
    • Select the role this project belongs to (required — projects must be linked to a role or circle).
    • Optionally add a description and due date.
  4. Click Create project.
Creating a new project from 'My projects'
Fill in the project details in the new project pop-up

From the + Create button

You can always create a new project using the '+ Create' button.

  1. Click the '+ create' button
  2. Choose the 'Project' option
  3. In the popup, we will by default select the role/circle you are viewing as the role for the project. Re-assign to the appropriate role if needed.
Search for and select the apprpriate circle/role for the project
Search for and select the apprpriate circle/role for the project

From a role or circle

  1. Navigate to the role or circle.
  2. Click the Work tab, then Projects.
  3. Hover over any of the columns and click the + to create a new project
  4. Type the name of your project + enter and your project is created.
You can add a project directly in any of the boards of your roles and circles
You can add a project directly in any of the boards of your roles and circles

Important: Projects must be associated with a role. If you can't create a project, make sure you're assigned to a role first.

The kanban board

By default, Projects are displayed on a kanban board with a swim-lane per role and four columns representing project status:

  1. Future: Planned projects, not yet started
  2. Current: Active, in-progress projects (default status for new projects)
  3. Waiting: Blocked or on hold — a "Waiting for" field appears where you can describe what you're waiting on
  4. Done: Completed projects

Drag and drop project cards between columns to update their status. You can also click into any project card to see full details.

Switching views

Both, My Projects and the circle project board is fully customisable. You can change the grouping (swim-lanes) to group

  • By role — group projects by the role they belong to
  • By assignee — group projects by the assigned person
  • By due date — group by when projects are due
  • By labels — group by custom labels you've applied
  • By OKR (if enabled) — group by custom labels you've applied
  • None — no grouping placing all projects on one board
Group your project board into swim-lanes that suit your needs
Group your project board into swim-lanes that suit your needs

You can also choose one of the following view options to suit your needs

  • Project status columns — the default kanban view using project status columns
  • List view — A simple list of projects
  • Completed column — A column for open and completed
Choose your preferred column/list view
Choose your preferred column/list view

Changing the project status columns

If you have admin rights, you can change the available columns on the project board. the simplest way is to click the settings icon on the group options.

Edit the columns on your project board
Edit the columns on your project board

This will open the circles 'Labels, Fields & Tabs' settings where you can change the project status options for the circle (and sub-circles). You can add/remove the columns and reorder to suit your needs.

Customize the project board columns to suit your needs
Customize the project board columns to suit your needs

Creating a todo

  1. Click My todos in the left sidebar.
  2. Click the New todo button in the header.
  3. In the dialog:
    • Enter a todo title.
    • Select a parent (role, project, or circle).
    • Optionally add a description and due date.
  4. Click Create todo.
Capture a new todo for your role

Similair to projects, you can also create todos from the '+ Create' button in the navigation and from the circle/role Todos pages.

Creating a todo within a project

If you want to capture a todo as part of a project, the easiest is to open the project and find the 'Add new todo' section, click it and type the todo you want to capture and it will be created.

Adding todos within a project
Adding todos within a project

The daily plan

At the top of your My todos view, you'll find the Daily plan section. This is your personal focus list for today:

  • Drag todos from your list into the daily plan to prioritise them.
  • A counter shows your progress: "(2/5)" means 2 of 5 daily items completed.
  • Create todos directly in your daily plan by clicking the new button within the section.
Simply drag projects or todos onto your daily plan to add them
Simply drag projects or todos onto your daily plan to add them

Setting due dates

Both projects and todos support due dates. You can:

  • Set a due date when creating the item.
  • Edit the due date anytime from the item's detail view.
  • Group or sort your items by due date to see what's coming up.

The completed filter

At the top of your page you will find a completed filter which let's you set how long you would like to see completed work for across Nestr. By default this is set to one week meaning you'll see completed work for one week after which it will be removed from your views. You can change this to a day, a month or turn it off completely so you can see all completed work.

This filter applies to work, OKRs and asynchronous proposals.

Filter out your completed work.
Filter out your completed work.

Viewing work across your workspace

My projects shows all projects assigned to you across every role and workspace. You can group them by:

  • Workspace, role, circle, due date, labels, or project status.

My todos works the same way, showing all your todos with grouping options:

  • By role (default), by project, by due date, by labels, or by completion.

You can sort todos by manual order, title, creation date, due date, or last updated.

Why projects or todos might not appear in My Todos

A common question: "I created todos but they don't show in My Todos." This usually happens because:

  • The todo isn't assigned to you — check that you are listed as an assignee.
  • The todo is completed — toggle the view to include completed items (see above on the completed filter).
  • The todo was created under a different workspace — check all your workspaces.

Building your org structure: roles, circles & governance roles

Nestr structures your organisation around purpose using roles and circles rather than traditional job titles and departments. Each role has a clear purpose, accountabilities, and domains. Circles are self-governing teams that contain roles and can nest within each other.

This guide walks you through building and managing your organisational structure step by step.

Creating a role

There are two ways to create a role:

From the circle's Structure tab

  1. Navigate to the circle where the role should live.
  2. Click the Structure tab, then select About.
  3. Click Add role.
  4. In the dialog that appears:
    • Enter a role name.
    • Optionally select a parent circle (defaults to the current circle).
    • Optionally provide accountabilities the role is responsible for
    • Optionally provide domains the role controls (as a general rule it is advisable to be conservative with adding domains)
    • Optionally assign users to the role immediately.
  5. Click Create role.
Click the Add role button in your circle of choice
Click the Add role button in your circle of choice
Craft your role by setting the Name, Purpose, Accountabilities and Domains.

From the sidebar

  1. Click the + Create button in the left sidebar.
  2. Select Create role.
  3. Fill in the same dialog fields and click Create role.

Note: In workspaces with governance enabled, non-admin users may see Create proposal instead of Create role. This routes the role creation through the governance consent process so circle members can review it.

Creating a sub-circle

Circles are teams within your organisation that contain their own roles. To create a sub-circle:

  1. Navigate to the parent circle.
  2. Click the Structure tab, then About.
  3. Click Add sub-circle.
  4. In the dialog:
    • Enter a circle name.
    • Choose the parent circle.
    • Add accountabilities — click "Add an accountability" for each one.
    • Add domains — click "Add a domain" for each one.
    • Optionally assign users.
  5. Click Create circle.
Creating a circle is much like creating a role

When a new circle is created, Nestr automatically generates four core governance roles inside it (hese core roles can be changed under Workspace Settings -> Applications -> Core roles):

  • Circle lead — has circle admin rights
  • Facilitator — runs meetings (electable)
  • Secretary — manages governance records, has circle admin rights (electable)
  • Rep link — represents the circle in its parent circle (electable)

Assigning people to roles

  1. Navigate to the circle containing the role.
  2. Click the Structure tab, then Roles.
  3. Find the role in the list and click it to open the detail panel.
  4. In the user section at the top, click to add or manage assignments.
Assign users to a role

You can also hover over any user's avatar in the role fillers widget on the left side of the Roles tab.

Removing someone from a role

  1. Navigate to the role via Structure → Roles.
  2. Click the role to open the detail panel.
  3. Click the assigned user's avatar or name.
  4. Click the Unassign to remove them from the role
Hover over the user avatar and click Unassign to remove a user from a role
Hover over the user avatar and click Unassign to remove a user from a role

Alternatively you can also click the User icon in the top right and click the X in the pop-up and save to remove the user from the role.

Managing the users from the assignee list pop-up
Managing the users from the assignee list pop-up

Moving a role to another circle

To move a role from one circle to another, you can change the role's parent circle. If you have admin rights, you can:

  1. Click the ... in the right top of the role
  2. Click the 'Move item' option
  3. Search for and select the circle you wish to move the role to.
Moving a role when you have admin rights.
Moving a role when you have admin rights.

More appropriate is to use proposals so that all circle members can consent to the proposed move. through proposals you can only move a role up or down in the circle hierarchy one step at a time. To do this:

  1. If you want to move the role into a sub-circle, click the edit button (pencil icon in the top right) on the sub-circle you wish to move the circle into.
  2. This opens a proposal to edit the circle.
  3. At the bottom of the proposal, open the advanced settings and toggle 'Restructure circle'
  4. Select the roles and policies you wish to move in/out of the circle.
Edit the circle you wish to move the role into/out of.
Move roles and policies in and out of circles using a restructure.
Move roles and policies in and out of circles using a restructure.

Core governance roles

Every circle automatically comes with four core governance roles. These roles have special properties:

RolePurposeCircle admin?Electable?

  • Circle lead: Holds overall accountability for the circle's purpose (assigned by parent circle)
  • Facilitator: Facilitates circle and governance meetings
  • Secretary: Manages governance records and meeting logistics
  • Rep link: Represents circle's needs in the parent circle

These are reasonable defaults you can change to suit your needs at Workspace Settings -> Applications -> Core roles. (requires admin rights)

Create as many template roles you need.
Create as many template roles you need.

To assign someone to a core governance role, navigate to the circle's Structure → About tab where these roles are listed, and assign users just like any other role.

Domains and policies

Each role and circle can have domains (areas of exclusive control) and policies (rules granting or restricting access to domains):

  1. Navigate to the circle.
  2. Click Structure → Domains & Policies.
  3. Add domains or policies as needed.
You can create domains and policies for each role/circle.
You can create domains and policies for each role/circle.

In governed workspaces, changes to domains and policies go through the governance proposal process.

Circle membership

In Nestr, circle membership is determined by role assignment. When someone is assigned to any role within a circle, they automatically become a member of that circle. There is no separate "add member" action — membership flows from role assignment.

This means everyone in a circle has a clear reason for being there: they fill at least one role that contributes to the circle's purpose.

Running meetings in Nestr

Meetings are the heartbeat of self-organising teams. In Nestr, structured meetings help your team coordinate work, process tensions, and evolve your governance — all in a focused, time-boxed format.

This guide covers everything you need to run effective meetings in Nestr: circle (tactical) meetings, governance meetings, and role meetings.

Types of meetings

Nestr supports three types of meetings:

  • Circle meetings (also called tactical meetings) — for operational coordination: project updates, checklist reviews, metrics, and processing tensions into concrete next actions.
  • Governance meetings — for evolving your organisational structure: creating or modifying roles, circles, accountabilities, domains, and policies.
  • Role meetings — for processing work within a specific role. This meeting type is optional and must be enabled by a workspace admin (see below).

How to start a meeting

Starting a circle or governance meeting

  1. Navigate to the circle where you want to hold the meeting.
  2. Click the Work tab, then select the Meetings sub-tab.
  3. Click New circle meeting or New governance meeting from the actions menu.
  4. A dialog will appear with a title field and an optional due date.
  5. Click Start meeting to begin immediately.
Start a meeting from the circle's 'Work -> Meetings' tab

It is also possible to start a meeting using the '+ Create' button in your navigatiuon bar on the left.

  1. Click the '+ Create' button
  2. Click the Meeting option.
  3. On the pop-up, select/change the circle you want to run the meeting in.
  4. Select the type of meeting (structure/circle) you wish to start.
  5. Click Start meeting.
Create a new meeting.

If your workspace has both circle and governance meetings enabled, you may see a meeting type selector with radio buttons to choose between them.

Scheduling a meeting for the future

Instead of starting a meeting immediately, you can schedule it for later:

  1. In the new meeting dialog, set the due date to a future date and time.
  2. The button label will change from "Start meeting" to Schedule meeting.
  3. Click Schedule meeting to save it.

Scheduled meetings appear in your Meetings tab with a countdown showing "Meeting starts in..." and a Start meeting now link if you want to begin early. Team members can add agenda items to a scheduled meeting before it starts.

Starting a role meeting

Role meetings are not enabled by default. A workspace admin can enable them by navigating to Workspace settings → Applications and toggling on role meetings. Once enabled:

  1. Navigate to the role.
  2. Click the Work tab, then Role meetings.
  3. Click New role meeting.

Preparing agenda items before a meeting

You don't have to wait until the meeting starts to add agenda items. Nestr lets you prepare tensions (agenda items) in advance:

  1. Navigate to the circle.
  2. Click the Work tab, then the Meetings sub-tab.
  3. Click Add agenda item from the actions menu.
  4. In the dialog that appears:
    • Give your agenda item a short title in the "Name your agenda item in just a few words" field.
    • Optionally add detail in the "Describe your agenda item" field.
    • Choose the type: Circle meeting tension or Governance tension.
    • Select which role is sensing this tension.
  5. Click Create agenda item.
Create a prepared agenda item.
Create a prepared agenda item.

Prepared tensions appear in a Prepared tensions list section below the agenda during an open meeting. You can add them to the active meeting by clicking Add to agenda, or remove them with Remove from agenda.

The meeting flow

Once a meeting is started, Nestr guides you through a structured set of tabs. Here's what each step covers:

Circle (tactical) meeting steps

  1. Check-in: A round-robin where each participant shares how they're arriving. Click a person's name to mark them present or absent.
  2. Checklists (if app enabled): Review recurring responsibilities tied to roles. Each role holder confirms whether checklist items were completed.
  3. Metrics (if app enabled): Review key performance indicators owned by specific roles in the circle.4
  4. Projects: Review project status across the circle's roles. See what's current, waiting, or done.5
  5. Process agenda: Process agenda items one by one. For each tension, capture outcomes: actions, projects, or governance proposals assigned to specific roles and people.6
  6. Reflect: A closing round where participants share reflections on the meeting.7
  7. Close meeting: Finalise the meeting. A report is saved and emailed to all participants.
Circle meeting page showing agenda, meeting steps and agenda processing.
Circle meeting page showing agenda, meeting steps and agenda processing.

Governance meeting steps

Governance meetings follow a similar structure but with a different processing step:

  1. Check-in: Same as circle meetings.
  2. Process agenda: Process governance proposals: create or modify roles, circles, accountabilities, domains, and policies or hold elections for electable roles. Includes clarifying questions, reactions, objections, and integration.
  3. Reflect: Closing round for reflections.
  4. Close meeting: Finalise and send the governance meeting report.
During a structure/governance meeting you can make changes to your roles/circles/policies
During a structure/governance meeting you can make changes to your roles/circles/policies

Adding agenda items

Anyone in the meeting can add agenda items to the meeting simply by typing in the 'Add an agenda item...' section in the left top. It will auto assign it to the user adding the agenda item. If there are prepared agenda items, you can simply drag them from the prepared list, onto the agenda to add them to the meeting. You can also open them from the prepared list, edit them if needed, and use the 'Add to agenda' button at the bottom to add them to the meeting agenda.

Assigning agenda items

If you are capturing for someone else (if you are the Secretary for example), you can simply use @name... in the agenda item to assign it to another user. You can also use the ... when you hover over the agenda item and choose the Assign

Assign an agenda item to any user by typing the @UserName... in the agenda item
Assign an agenda item to any user by typing the @UserName... in the agenda item

Removing agenda items

You can remove an agenda item simply by backspacing the title of the agenda item and remove it from the meeting or you can use the context menu found under the ... on the item to remove it.

Use the agenda item menu items to (re-assign) or remove agenda items.
Use the agenda item menu items to (re-assign) or remove agenda items.

Reordering agenda items

You can always drag the agenda items around to change the order in which they will be processed.

Processing agenda items during a meeting

The Process agenda tab is where the real work happens. For each agenda item:

  1. The facilitator opens the tension.
  2. The tension owner explains what they need.
  3. Depending on your meeting process (Sociocratic, Holocratic or other) the agenda item isprocessed into operational or structural outcomes..
  4. Use the Add outcome button to capture each outcome:
    • Choose a type: Action, Project, or a governance proposal type.
    • Assign it to a role (or select "Individual action" for personal actions).
    • Assign it to a specific user using the "Select User" dropdown.
    • Describe the outcome in the text field.
  5. Move to the next agenda item. The agenda header will show your progress: "(X done, Y to go)".

Closing a meeting

When all agenda items are processed, click the Close meeting tab to finalise:

  • A meeting report is automatically saved with all agenda items and their outcomes.
  • An email summary is sent to all circle members.
  • Unprocessed agenda items can be discarded or moved back to the prepared agenda items for the next meeting.

Note: If a meeting is left open for more than 8 hours without activity, Nestr will automatically close it and send the email report.

Elections

Elections for governance roles (circle lead, facilitator, secretary, rep link) are handled as part of governance proposals. During a governance meeting, you can create a proposal with the election label to nominate and elect someone into a governance role. The election follows your workspace's configured governance process (Holacracy IDM, Sociocracy consent, etc.).

Meeting process customisation

You can change the available steps for your meeting by navigating to your Workspace settings -> Labels, fields & tabs. There you can select the Circle or Governance meeting label and change what tabs are visible or add custom tabs.

Customise your meeting to suit your needs. Here we enabled the OKR tab in a circle meeting.
Cusomize your meeting to suit your needs. Here we enabled the OKR tab in a circle meeting.

Tips for effective meetings

  • Prepare tensions in advance — Encourage your team to add agenda items before the meeting so everyone can see what's coming.
  • Use the facilitator flow — The step-by-step tabs keep meetings structured and prevent tangents.
  • Capture outcomes immediately — Assign every action or project to a specific role and person during the meeting, not after.
  • Review checklists and metrics regularly — These recurring items build accountability over time.
  • Keep it time-boxed — The tension review is designed to process items quickly. Each item should result in a clear next step.

MCP - Connect AI assistants to your workspace

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect directly to the tools and data they need. Think of it as a universal plug that lets any AI assistant — like Claude, ChatGPT, Cursor, or GitHub Copilot — talk to Nestr on your behalf.

Instead of copy-pasting information between your AI assistant and Nestr, MCP creates a live connection. Your AI assistant can read your governance structure, create projects, process tensions, manage your inbox, and much more — all while respecting your permissions and role authority.

What can you do with it?

Once connected, your AI assistant can help you with virtually everything you do in Nestr:

  • Navigate your organisation — Ask your AI about your roles, circles, accountabilities, and who is responsible for what.
  • Manage work — Create and update projects, tasks, and track progress across your roles.
  • Process tensions — Capture tensions, create governance proposals, and run asynchronous consent processes.
  • Plan your day — Review your inbox, build your daily plan, and prioritise work across all your workspaces.
  • Propose governance changes — Draft new roles, update accountabilities, and submit proposals for consent — all from your AI assistant.
  • Set up new workspaces — Let your AI guide you through creating a new workspace with circles, roles, and governance structure.

Who is it for?

The Nestr MCP serves two distinct use cases:

AI-assisted self-organisation — You fill roles in your organisation and want an AI assistant to help you navigate governance, process tensions, manage projects, and stay on top of your work. The AI acts as your co-pilot, helping you be more effective in your roles.

Agentic work — AI agents can fill roles directly in your organisation. They energize roles, own accountabilities, process tensions autonomously, and communicate with other roles (human or AI) through Nestr's tension system. This makes agentic work scalable, auditable, and governed by the same rules as human work.

How to connect

Connecting is simple. Most MCP-compatible AI clients handle the setup automatically.

For Claude Desktop, Cursor, VS Code, and other MCP clients:

  1. Add the Nestr MCP server URL to your client's MCP configuration: https://mcp.nestr.io/mcp
  2. When prompted, authenticate with your Nestr account
  3. Start asking your AI assistant about your organisation

For developers and custom integrations:

You can also connect using a workspace API key or a personal API key for programmatic access. See the authentication options on the MCP server page.

Connect your AI assistant to Nestr →

Getting started

Once connected, try asking your AI assistant:

  • "What roles do I fill?"
  • "Show me my active projects"
  • "What's in my inbox?"
  • "Help me propose a new role for our marketing circle"
  • "What tensions are waiting for my consent?"

Your AI assistant will use the MCP connection to fetch live data from your Nestr workspace and help you take action — all within the authority of your roles.

The Nestr MCP is free to use for all Nestr users. Simply connect and start working smarter with AI.

Get started at mcp.nestr.io →

Linking your DAO to Nestr

One of the coolest new features of Nestr allows Decentralized Autonomous Organizations to link their existing DAO software to a Workspace, so you can track the DAO Proposals and use all the power of Nestr to manage them, like bind them to Projects, Tasks Circles or Roles, allowing one to track where the funds are being used and their status more clearly.

For now the types of DAO currently supported are: Aragon, DAOHaus and HyphaDHO.

You can start by creating a new Workspace, and selecting DAO:

Screenshot of workspace settings for DAO integration in Nestr

If you already have an existing workspace you wish to integrate with your DAO, you will need to enable the DAO app by going to your workspace settings page by clicking the settings icon on the right top of your workspace.

Screenshot of DAO workspace settings in Nestr

On the workspace settings page go to the 'Applications' tab and enable the DAO app.

Then, after finishing the Workspace wizard or enabling the DAO app, your workspace is ready for DAO integration.

Screenshot of workspace ready for DAO integration in Nestr

Next step is adding the DAO type, network and address, on the About tab:

Screenshot of the About tab in DAO workspace in Nestr

For ethereum based DAOs (Aragon, DAOHaus) you can use the 0x based DAO contract address, for Hypha DHO you should use the 12 character DAO account shortname that is usually on the DAO URL address.

After a few minutes, the DAO scrapper will scan the existing DAO proposals and show them on the Proposals tab:

Screenshot of the Proposals tab in DAO workspace in Nestr

If you click on a Proposal you can see all blockchain details for them, like requested tokens, assignee, number of votes, etc. And you can also click the link the visit the original proposal on the DAO:

Screenshot of original proposal on the DAO in Nestr

Now you can click on any Proposal and move them inside an existing Role or Project, like this:

Screenshot of a role or project linked to a DAO proposal in Nestr

Then your proposal will show like this:

Screenshot of a DAO proposal linked in Nestr

You can also see the proposal attached to the Project if you click inside it:

Screenshot of a project with DAO proposal details in Nestr

This allows you to track the usage of the DAO resources tied to a Project or Role, to give more clarity and accountability!

Nestr Discord integration

Nestr has a Discord bot integration that allows you to post messages to a Discord channel from within Nestr. Here's how you do it:

  1. Navigate to your workspace settings
  2. Select Integrations
  3. Toggle on the Discord integration
  4. Click the 'Add to Discord' button to connect your Discord
  5. Select the Discord server you want to connect
  6. Once you're connected you can select which Discord channel to post to
Screenshot of the Discord integration setup in Nestr

Once connected, you can post to a Discord channel from within Nestr by clicking the three dots on any nest, selecting the Discord option and selecting the Discord channel you want to post to.

SCIM user provisioning

Chances are that you already have a central database with all your employees like Google Workspace, Microsoft Azure or an HR database. If this system supports SCIM (System for Cross-domain Identity Management) you can automatically add/remove uses from Nestr when you add remove them there.

All you need to do is go to your workspace settings:

Screenshot of workspace settings page in Nestr

There, if you have not already, go to 'User Permissions' and select 'Allow email users from certain domains to join this workspace' and enter all domains, you use when provisioning users. Note that once added, we'll do a manual verification on our end to ensure claimed domains actually match the workspace. Once verified (usually within an hour), the domain will show with a 'verified' tick.

Screenshot of verified domain settings in Nestr

Once your domains are verified, enable the SCIM integration on your integrations page on your workspace settings:

Screenshot of SCIM integration settings in Nestr

For the rest of this article we'll use Azure as the example SCIM provider but the basics are the same for other providers.

In your Azure portal go to 'Enterprise applications' and click '+ New application'

Screenshot of Azure portal new application setup for SCIM

When creating an application click '+ Create your own application', give it a name (eg. Nestr.io) and choose the option 'Integrate any other application you don't find in the gallery (Non-gallery)'.

When created assign the correct users and/or groups to your new Enterprise application and under 'Manage' to to 'provisioning'. Select 'Automatic' as the provisioning mode. Go back to Nestr and copy the SCIM API Url and paste it into the Tenant URL field under 'Admin Credentials'. Copy the API key from Nestr and paste it in the 'Secret Token' field. Click 'Test connection' to see if the configuration works. If it does, click 'Save'.

Screenshot of SCIM provisioning configuration in Azure

On the same page, open the 'Mappings' segment and click 'Provision Microsoft Entra ID Users'

Screenshot of SCIM user provisioning with Microsoft Entra ID

There you can setup what information will be send across to Nestr. You can remove most fields and only leave the following mappings (note that userName may also be mapped to userPrincipalName). Click Save, close the settings window.

Screenshot of SCIM settings after configuration in Nestr

Now click 'Start provisioning' and all your users will be added to Nestr. Any user added to the users configured for access to the Enterprise application in Azure, will automatically be added to Nestr and any user removed, will be removed from Nestr. Note that this provisioning setup seamlessly works with our Google, Microsoft and SAML login methods as well.

Screenshot of SCIM with SAML login methods configured in Nestr

SAML authentication for Nestr

Note that though Nestr supports SAML, in most cases newer authentication methods like OAuth and OpenID allow most of the benefits of SAML, don't need any configuration to use and offer a more seamless user experience.

SAML (Security Assertion Markup Language) is an authentication protocol to allow an organisation to centrally administer who within your organisation has access to what apps using an Identity Provider (IDP). If your organisation requires the use of SAML, here is how you can configure it.

Configure your Identity Provider

Depending on your Identity Provider (eg. Azure) there might be some small differences in how the different fields are named. You should find where you can configure Single-sign-on (SSO) and configure SAML to use the following fields.

Identifier (Entity ID) https://app.nestr.io

Reply URL (Assertion Consumer Service URL) - Replace the domain.com with your registered domain: https://app.nestr.io/saml/consume/domain.com

Under Attributes & Claims please use the following setup

Claim name: Value
givenname: user.givenname
surname: user.surname
emailaddress: user.mail
Unique User Identifier: user.mail

Configure Nestr

Navigate to your workspace settings and go to the "Integrations" tab.

Screenshot of SAML SSO configuration settings in Nestr
Screenshot of SAML attribute mapping settings in Nestr

In your Identity Provider, find the correct values for the following fields and paste them into the configuration fields as shown above.

Identity Provider Entity ID

This is an ID specific to your app configuration within the Identity Provider. For Azure this looks something like: https://sts.windows.net/xx....xx/

Identity Provider SSO endpoint

This is the login URL Nestr will point users to wanting to login to a workspace using SAML. For Azure this looks something like https://login.microsoftonline.com/xx....xx/saml2

Identity Signing Certificate

This is a certificate used to ensure the login requests come from the correct IDP and you can download this from your IDP. Open it in a text editor and paste it into the field. It should start with -----BEGIN CERTIFICATE----- and end with -----END CERTIFICATE-----

Finally, to make this setup work flawlessly, we recommend you to add all the email domains you use within your organisation. Navigate to "User permissions" and check "Allow email users from certain domains to join this workspace". There you can add all domains you control (we'll take you through a verification process) so that when people try to login with those email addresses, they will be redirected to your required SAML authentication.

Using the Nestr API

Generate a Nestr API key

The Nestr api allows manipulation of nests from outside the Nestr application. The api can be used to create an integration with other applications, or to easily add nests from anywhere.

To get started, go to your workspace settings where you will find a tab called Integrations

Screenshot of the API integrations tab in Nestr workspace settings

There you will find the Workspace API access integration. Click configure and create a new API key.

Screenshot of creating a new API key in Nestr

You can optionally name the API key and give a description. If you have multiple integrations, it pays to setup a key for each one and name them accordingly. Once you have named your API key, click Create API key. This will generate and store the key for you. We will only show you the key once, so make sure you copy it and store it securely in a password manager.

Use your Nestr API key

The Nestr API key is a Bearer token. You can find the full API documentation and examples on our API documentation page.

Importing Data from Glassfrog

Nestr can import your data from Glassfrog. It will import pretty much everything straight into your Nestr account.

In order to use that feature, you may want to start by creating a new Workspace, clicking the [+Create] button on "My Workspaces". After you create the workspace, head into it and navigate to the workspace settings page.

Screenshot of Glassfrog import settings in Nestr workspace settings

Once there, navigate to the 'Integrations' tab and enable the Glassfrog integration.

Screenshot enabling the Glassfrog integration in Nestr

In there you have to fill the Glassfrog API key. You can create an API key in your Glassfrog account when you go into your organisation and go to "Your profile and settings" page and navigate to the "API" tab. There you can create a new API key. Do this and copy it across into the "Glassfrog API key" field in Nestr.

Check the box if you want to import users, if you would like to invite them directly into Nestr and hit the "Synchronise" button.

Depending on the size of your account this can take a few seconds to up to an hour. You can simply let it run in the background and see the circles and roles appear as they come in.

If you wish to update the latest changes from your Glassfrog account into Nestr, simply click the "Synchronize" button again and we'll import the changes for you.

Happy Nestring!

Importing Data from Holaspirit

Nestr can import data from Holaspirit. Simply go to your workspace or create a new one.

Screenshot of the Holaspirit import page in Nestr

After you created the workspace, head into it and navigate to the workspace settings page:

Screenshot of Holaspirit import settings in Nestr workspace settings

Once there, navigate to the 'Integrations' tab and enable the Holaspirit integration.

Screenshot enabling the Holaspirit integration in Nestr

In there you have to fill the Holaspirit API key and Holaspirit Org ID.

In order to get your API key you will need to contact Holaspirit support (it's only available on the Scale plan and up) Please include the "api:" part of the given string.

To get your Holaspirit Org ID, you have to login into Holaspirit and copy the URL where you connect, to extract the ID, something like:

https://app.holaspirit.com/o/xxxxxxxxxxxxxxxxxxxxxxxx/

Copy the number and letters from the URL, after "/o/" and before the final slash.

After you have copied this into Workspace details, you can choose options before starting the import

  • Import users from Holaspirit: this defines if you want to also import Holaspirit users and attributions into Nestr, but this will not actually invite the users.
  • Invite imported users to Nestr: this will actually send an email invitation to these users to start using Nestr.

Once you click Synchronize, you will see the importing steps going one by one. It could take some time for larger organizations.

You can re-run the import by clicking the Synchronize button whenever anything change on Holaspirit.

Importing and exporting your data with Nestr

At nestr we believe you should be able to use the tools that best suits you. We try to make integrations and migrations as seamless as possible.

Importing data into Nestr

If you are using another tool for your self-organisation today we can import and sync the data from that tool into Nestr. This is a great way to try Nestr out using your actual data.

Importing from Holaspirit, Glassfrog, or Peerdom

Once you have created a workspace you can navigate to the workspace settings.

Screenshot of the data import and export settings in Nestr

There you will find an integrations tab. There are integrations for Holaspirit, Glassfrog, and Peerdom you can enable. Enable your tool of choice and run the import as described in these help articles:

Screenshot of importing data from Peerdom into Nestr

These integrations will allow you to import pretty much all your data across. And you can simply run the sync again a few days/weeks later to update the data in Nestr.

Import using the API

If you know how to use an API, Nestr has a full-fledged API that will allow you to import and sync all your data.

Importing from other tools

If you currently use another tool or have your data stored in excel/sheets/csv. Please contact us and we'd be more than happy to import this data for you.

Exporting data from Nestr

Your data is always yours and you have full access to it at all times.

Export to csv/excel

Everything you see in Nestr you can directly export to csv/excel. The main search has an export button right in the search controls.

Screenshot of the export feature in Nestr search controls

And most tabs offer an export button in the view controls.

Screenshot of the export button in the Nestr view controls

Export using the API

If you know how to use an API, Nestr has a full-fledged API that will allow you to export and sync all your data.

Automate your business processes with Nestr

One mantra we try to live by at Nestr is that we don't pretend to know how to best run your organisation. We are here to support any and all experimentation in persuit of your organisational purpose.

In that light, we offer our Automations app. It allows you to automate many different business processes relieving you of the manual work. Here are a few examples on how you can use it:

How to set it up

At current, only workspace admins can configure automations. You can enable it on 'Applications' tab of your workspace. Once enabled, you can create new automations to your workspace. You will see the following screen to start with

Screenshot of the automation settings screen in Nestr

Let's run trough the automation options:

Define what the Automation should do

Once you have configured what the automation will target, how it is triggered and who the audience is, you can define what it should do in the 'Steps' section. Click the '+ Add an automation step', give the step an initial name and hit enter.

When you created your first step, click on it to open it. There you will have one drop down to set the step action with the following options:

Available template options

When sending out an email, posting a message or creating new items, you may use the following template variables. Nestr will replace these before emailing, posting or creating.

When the target is a circle, these template options are available as well:

When your automation has a target, the following template options are available as well.

When you tie it alltogether, a fully configured automation could look something like this:

Screenshot of a fully configured automation workflow in Nestr

Giving or requesting feedback in Nestr

If you are a member of a workspace where the feedback app is enabled, you can give your peers feedback or request them to give you feedback.

Feedback is crucial in any organisation and specifically in a selforganized or role based organization as there is less centralized control or management, relying on your peers becomes more important.

This document assumes your workspace administrator has already setup the feedback app within nestr for you. If you can't see the options highlighted here, ask them to enable them for you.

Giving feedback to your peers

There are a few ways to initiate feedback.

1) From "My feedback", click on "Give feedback"

Screenshot of the Give feedback button in My feedback in Nestr

2) From your circle's "Work" page under the "feedback" tab

Screenshot of the feedback tab on the circle Work page in Nestr

3) Hover over your collegues profile picture anywhere within Nestr and select "Give feedback" from the context window.

Screenshot of the Give feedback option in the context menu in Nestr

When you click give feedback, the feedback pop-up will show where you can select the user and role to give feedback to (if you used option three to initiate the feedback, these will be pre-filled with the user you selected). Here you can search for either a user or a role to give feedback to.

Screenshot of searching for a user or role to give feedback to in Nestr

It depends on how your organisation uses feedback if you will choose user or role feedback. We do advice role feedback in most cases as it will allow you to give specific and actionable feedback for one specific role at a time. A person might be great in their "Marketing role" and might need to grow in their "Facilitator" role.

Once you selected the user and their optional role, click next to give the actual feedback. If your organisation has setup multiple feedback forms to use, you will need to choose the type of feedback here too.

The specifics of the feedback forms is fully customizable per workspace. Here is an example of a simple Keep/Stop/Start feedback form. Note that when giving feedback to a user in a role, you can toggle the role open and closed by clicking on the name of the role in the header to help remind you what can be expected from your colleague in that specific role.

Screenshot of feedback form with role context in Nestr

When you are ready, you can click "Give feedback" which will notify your colleague that you have given them feedback. Optionally if you are not quite ready yet, you may "Save for later" so you can continue and submit at a later time.

Receiving feedback

Once the feedback is given, the receiver will get an email and an in-app notification that they have new feedback to review. You can also find this on your "My feedback" page. New feedback shows at the top under "My feedback to process"

Screenshot of the My feedback page showing new feedback in Nestr

Click the view button to open it.

Screenshot of the feedback view button in Nestr

Here you can see who gave you feedback, to what role and the actual feedback. Take a moment to absorb the feedback and identify next steps to help you integrate the learnings provided by your peers.

As a feedback receiver, you can choose to add the feedback to your profile privately or publically. When private, only you and the feedback provider can see it. When made public, everyone within your workspace can see the feedback given. Only the receiver can change this setting to ensure sensitive feedback can be integrated in a way that feels save to the receiver.

All your given, received and pending feedback can be found on "My feedback" as well as in the circles where it was received/given.

Requesting feedback

Requesting feedback works the same as giving feedback accept that the receiver initiates it. Just like giving feedback it can be started from your My feedback page, from the circle feedback page or by hovering over any profile picture of a user you wish to request feedback from.

Screenshot of requesting feedback by hovering over a user profile in Nestr

When you have selected one of your roles to request feedback on (or no role), you can add multiple people to request it from and give some context on the feedback you are after to help frame your request. They will receive the request in an email and in app notification to give you the feedback you are after.

Private projects, meetings, todos and notes

Though transparency is an important part of self-organisation, at times rules and regulations or personal privacy require information only to be shared with just a few roles or people.

In these cases Nestr offers you a way to make pretty much anything private. You can choose who to share it with. As soon as you are assigned to a project, todo, meeting or note, you can make it private. Simply click the three dots on the item you wish to make private and click 'Make private'.

Screenshot of the Make private option in the three dots menu in Nestr

It will make that item and any items and conversations under it private and visible to only those assigned. All private items will have a light yellow background color so you always know what is private and what is not.

Screenshot showing private items with yellow background in Nestr

This private setting can be applied to meetings, agenda items, projects, notes, todo's, boards and everything that is not governance.

The power of labels

You can customise Nestr to suit your needs in many different ways and Labels are at the center of this. You can add a label simply by typing #name_of_label in the name, description or purpose field of any Nest (role/circle/project...) you interact with. If the label does not exist yet, you can create it right there and then.

Screenshot of adding a label to an item in Nestr

You can also add labels anywhere you see the three dots.

Screenshot of adding labels via the three dots menu in Nestr

As you can see, you can create a personal or workspace label. There are actually three types of labels.

Three types of Labels

In Nestr you can add labels to almost everything and there are three types of labels:

Labels to categorise your work & organisation

You can use labels in a few different ways. The can help you categorise and organise your work and organisation. Once assigned, you can easily search for any project/circle/role/etc. with your label by typing #your_label in the search field.

Screenshot of filtering by label in Nestr search

Also, almost all pages offer a way to filter on used labels. So your circle or role project board allows you to filter on certain labels so you can create focus. This is great for running a sprint where you label your sprint work with the label 'sprint_3' and filter on just that label for the duration of your sprint.

Screenshot of filtering items by sprint label in Nestr

Labels to customize Nestr

Labels also allow you to customise how Nestr works. If you go to your workspace settings you'll see a "Labels & Fields" tab where you can create and edit all workspace labels and some system labels.

Screenshot of the workspace labels management tab in Nestr

If you click on any of the workspace labels you can edit the label name, color and add fields as well. Any field you define here will be added to all projects, roles, circles, etc. you have added this label to. This gets really powerful and you can add as many fields as you would like. At current you can add text, multiline text, number, currency, select, percentage and slider fields.

Screenshot of custom field types available for labels in Nestr

Then whenever you use a label, the fields will automatically get added to what you have added the label to. Here is an example of a 'Story' label where we added a story points and a traffic light field. Note that the values of the fields show up in both the detail view as well as the list view.

Screenshot of custom field values in the list and detail view in Nestr

Extending system labels

On top of adding fields to your own workspace labels, you can also change or add fields to some system labels. At current, you can update roles, circles and projects. If you add a field to any of them, they will show up throughout your workspace. you may also change the project status field and change the available options. This will in effect change the columns on your circle and role project boards as well. Here is a screenshot of a circle project board using custom columns.

Screenshot of a circle project board with custom columns in Nestr

We look forward to seeing how you will be using the power of labels in your workspace.

Happy Nesting!

Nestr search

Nestr's search function is very powerful and is available whenever you use Nestr.

Screenshot of the Nestr search function

Searching

A search query can consist of a simple word or can be made up of a combination of many different parts. Here we lay out all the options available to you.

Text search

You can simply type anything you want and it will find any relevant matches. Nestr will match on the name, purpose or description of anything you have access to. So it will return any found users, projects, roles, circles, accountabilities, to-dos and notes. Click any of the results and they will open for you right there next to your search results.

Screenshot of search results opening inline in Nestr

Search tools

At the top of the search results you have a few tools to your disposal to help you quickly find what you are after.

  • Structure: Click on structure to limit the search results to only show you roles, circles, accountabilities, domains or policies.
  • Projects: Click on projects to limit the search results to only show you projects.
  • Todos: Click on Todos to limit the search results to only show you todos.
  • People: Click on People to limit the search results to only show you people.

Filters

Click the filter icon to filter the search results on users and/or labels. This will allow you to zero in on the results you are after.

Screenshot of filtering search results by label in Nestr

Group

The last search tool in the search toolsbar is the group option. Here you can select if you want your results to be grouped by assignee, workspace or no grouping.

Screenshot of grouping search results in Nestr

Advanced search options

Besides using the search tools you can also use the autocomplete advanced search options available.

Label search

If you type label: or #, nestr will recognise you want to add a label search to your query and present you with a drop down of all the labels available to search with. Keep typing and we'll narrow the available options in the drop down and/or select the label you want.

Screenshot of narrowing search options with label dropdown in Nestr
  • You can also search for multiple labels. If, for example, you type label:bug,project, we'll show all matches with the label bug OR the label project.
  • If you use label:bug label:project we'll return all matches with the label bug AND the label project.
  • If you want to exclude all matches with a certain label. You can add label:!project and we'll remove all matches with the project label from the results.

Assignee searches

When you type assignee: or @ Nestr recognises you wish to limit your search results to only include those assigned to a certain person.

Screenshot of filtering search by assignee in Nestr

Attribute searches

Nestr allows you to further refine your searches by using the has: operator.

Screenshot of refining search with the has: operator in Nestr

This allows you to limit your search results in five different ways:

Search results

Nestr allows you to format the results you get from your searches in a couple of powerful ways.

Sort

By using sort: you can instruct nestr to sort the results. There are six ways to sort.

Screenshot of sorting search results in Nestr
  • Title - This orders the results alphabetically  based on the name or the project/role/circle/etc.
  • Search order - Order the results on their given order. This is the order you the user give any result by dragging it up or down in the search results.
  • Due date - Order the results based on their due date.
  • Created time - Order the results based on when they are created.
  • Last updated time - Order the results based on when they were last updated.
  • Parent nest order - Order the results based on the order you give them under their parent. Foe example, when you add to-dos under a project in a certain order, we'll use that order when you choose this option.

You can also add the optional sort-order: option. When omitted the default value is asc (ascending) will be used. If you choose desc (descending) the sort order will be inverted.

Group by

By adding groupby: to your search Nestr will group your results in groups of your choosing.

Screenshot of grouping search results by category in Nestr

The options you can group by are:

  • label - This will group your results by the first label found in the matched results. (eg. this example will show you all your to-dos grouped by label)
  • parent - This will group the results by the parent of the found results. (eg. this example will group all found roles by their parent circle)
  • workspace - This will group the results by the workspace they are a part of. (eg. this example will show you all your projects grouped by workspace)
  • assignee - This will group the results by assignee. (eg. this example will group all roles by their assignee)
  • completed - This will group results based on their completed status. Note that this will exclude any results that are not completable (eg. a role or circle) and only works if you turn off the 'hide completed' filter on the top right of your screen. (eg. this example will show me all my projects grouped by completed)
  • due - This will group your results by their due date in groups: overdue, today, this week, next week and later. Note that this will exclude any results that do not have a due date assigned. (eg. this example shows you all your results with a due date grouped by their due date)
  • project->status - This option is not in the auto suggest but does work. It will group your results on the state field value of your projects.

Group by columns

Just like the groupby above, you can add a groupbycol: with the same options as groupby. The only difference is that rather than groups, nestr creates columns. It works exactly the same except that the representation is different. And you can even combine the groupby and groupbycol.

Screenshot of combining groupby and groupbycol in Nestr search

Here is an example where we show all projects with a column for each assignee.

Saved searches

All searches you do you can save. Right next to the search a little save icon shows up. When you click it you get a prompt that allows you to name the search and add it to a group. This group will be added to your navigation with your search in it for easy access.

Happy searching!

Chat & channels - communication in Nestr

Communication is baked into the heart of Nestr. Any nest (role, circle, project, etc.) can be communicated about right there in context. No more jumping between tools to have a conversation about the thing you are working on.

Because Nestr is structured around circles, all communication within your organisation is naturally scoped to those circles. This gives the benefit of not having to deal with the noise from other teams in your organisation.

Circle feed

Each circle has a feed. The circle feed shows all communications that are happening inside projects within the circle so that nothing is missed.

Screenshot of circle feed showing aggregated discussions in Nestr

On top of that you can create channels in a circle for specific topics. You can also add people from within or outside the circle to that specific channel. With the @ functionality you can mention people in a conversation and they will be notified.

Direct messaging

You can start a direct message with anyone in Nestr. Simply click on their profile picture or find them in the search dialog to start a conversation. They will get a notification that you have reached out to them.

Screenshot of direct messaging in Nestr

Messaging is always accessible in the bottom left corner of the screen no matter where you are in Nestr.

Work - Collaborating with your peers

So you are ready to start organising your work in Nestr? This article will give you a quick overview of how work in Nestr functions.

Projects

All work items within Nestr are broadly separated into Projects and Tasks. A Project is any piece of work that requires one or more tasks to complete, for example "Write a new blog post" or "Design a product feature". Projects are owned by specific Roles, giving them clear accountability.

Looking across circles and roles, one can follow Projects organised by status and Tasks per Role and per person.

Screenshot of projects and tasks organized by status and role in Nestr

Tasks

A Task is a single action, for example "Get feedback from design team" or "Correct spelling mistakes". A task is owned by an individual person. You can create subtasks and subtasks inside the project, that can be assigned to other people as well.

Screenshot of subtasks inside a project in Nestr

Commenting and Mentioning your peers

Working together often requires communicating with your peers. Within each task or project, you can have a discussion right there in context, by simply clicking "Comment" at the bottom of the page. You can mention your colleague to highlight something of importance by typing @name_of_your_collegue to mention them and they will get notified of your question.

Screenshot of mentioning a colleague in Nestr to notify them

Structure and Governance - shared agreements in Nestr

The basics of governance in Nestr

Nestr aims to support you in manifesting your purpose using self-organisation. This means you will no longer rely on a management hierarchy to make decisions but will have some form of explicit agreements on how decisions are made. Nestr support many different ways of setting this up. So weather you use Sociocracy, Holacracy, Teal practices or some other form of role based work, Nestr supports it. And across these different ways to self-organise, there are some common practices.

In all cases, you'll use roles and circles to express how accountability is distributed throughout your organisation.

Every role/circle will be made up of:

  • Name: Best to use something that is easy to remember. e.g.: "Blogger"
  • Purpose: A phrase that inspires whoever is assigned to that Role to know what is expected in the broadest scope. e.g.: "An blog that amuses readers with inspiring content"
  • Accountabilities: A list of ongoing activities that the person on that Role is expected to be doing from time to time. e.g.: "Writing posts to the blog"
  • Domains: Domains where that Role has exclusive control and possibly, policies to access that domains. If another Role needs access they can ask the domain owning Role to impact it. Or perhaps the owning role has published a policy on how to impact the domain. Ex.: "Blog admin functions"

when you enable self-organization in nestr, we'll automatically add some common core roles to each circle you create. We'll follow accepted definitions of these core roles dependent on the type of self-organisation you have selected for your workspace. In most cases they will look something like this:

  • Circle Lead: Generally represents the initiative starter or someone appointed to lead the strategy of the circle. Whoever is on this Role is responsible for structuring the circle and inviting new members into other Roles. Usually appointed from the outer circle.
  • Facilitator: Facilitates regular circle meeting and can also give coaching and support on self-organization. This role is usually elected.
  • Secretary: Focused on giving clarity on the agreements and organizational structure, also registers the circle meeting outcomes (like new projects, roles etc.). It's usually an elected role.
  • Rep Link: Represents the circle members and needs on external circle meetings. This is usually and elected role.

You can configure which roles to use in your workspace settings and can even add custom roles if the default setup does not serve your needs.

Screenshot of roles and circles structure in Nestr

Making changes to your governance

Any circle member can propose changes to roles, circles, and policies. This is a core principle of self-organisation. Nestr makes it simple to propose changes — either asynchronously or during a governance meeting.

For the full step-by-step guide on creating tensions, building governance proposals, running elections, and the async consent process, see Tensions & Governance Proposals: From Tension to Decision.

The basic building blocks

In Nestr everything is a Nest. From the biggest circle to the smallest task. A nest can be anything depending on the labels you give it.

In its most basic form a nest looks like a simple task. You give it a name, a description, assign it to someone and it can have a due date. On top of that, it can have labels, sub-nests and you can comment on it. So in it's simplest form it looks like a todo or a task.

Two important concepts to understand

1. Hierarchy of nests

Any nest can have children. This means you can have a nest within a nest, within a nest... to infinite depth. If you type a label like #project (part of the system labels) or #your_label when you create a nest and we'll ask you if you want to create a new personal or workspace label.

Screenshot of creating a nest with a label in Nestr

2. Search / Filtering

Nestr has powerful search and filtering capabilities. You can find nests that have a certain person assigned by typing @name of person.

Screenshot of filtering nests by assigned person in Nestr

Or by typing #name of label to search for a nest with a certain label.

Screenshot of filtering nests by label in Nestr search

This is a fundamental concept in Nestr and it is used throughout the app. Combined with the nesting capability described above it makes for a very powerful system.

Navigating Nestr

Nestr serves two goals

  1. Help people to assess if the work they do aligns with their personal values
  2. Help organisations deliver on the purpose they set out to achieve

Your personal views

The navigation on the left of the page is all about your personal overviews. It will show you all your workspaces, circles/roles, projects, todo's and feedback across all workspaces you are a member of.

Screenshot of the Me navigation section in Nestr

The circle view at the bottom shows you all the workspaces you are a member of in one overview. We call this your purpose fingerprint. If you click the arrows, you can maximise that view and use it to navigate your workspaces.

Screenshot of the workspace navigation and sidebar in Nestr

On the top right under your profile picture (or your initials if you have not yet provided one) you can find your account settings.

Workspace views

A workspace can represent an organisation or could be a personal project you run for just yourself. Whatever it represents, once you click it you will only see information relevant to that workspace.

Once you click on any of your worksapces, you will enter the workspace and see all relevant information for that workspace. In the below workspace you see these different parts:

Screenshot of workspace sections and views in Nestr
  1. The maximised purpose fingerprint allowing you to navigate your workspace/organisation visually simply by clicking on the roles/circles
  2. The breadcrumbs showing you where you are in your workspace. Here showing you, you are looking at the Nestr.io GCC circle in the Nestr workspace. You can always click the different parts to navigate there.
  3. The main tabs related to the content you are viewing. In this case the Structure, Work and Communicate tabs of the Nestr.io GCC circle.
  4. The available sub-tabs. Here projects (selected)/todos/meetings/metrics/checklists/feedback as available under 'Work'.
  5. The content of the page. Here the project board for the Nestr.io GCC circle. All headers and cards can be clicked to open the specific projects.

When you have minimised the circle view, and you click on anything, it will open in a detail view on the right. When a detail view is open, there are a couple of parts to the page

Screenshot of the detail view panel in Nestr
  1. The open and close buttons. The left button will open the detail full screen and the right button will close the detail view.
  2. The detail breadcrumbs show you how the detail relates to the main view. The breadcrumbs will be relative to the main view.
  3. The name of the item (circle/role/project/todo) you are viewing
  4. The actions related to the item you are viewing.
  5. The assigned people to the item you are viewing
  6. The optional fields related to the item you are viewing.
  7. Depending on what you are viewing, the content of the page might change. In this case you can add todos to the project being viewed.
  8. Comments and conversations related to the item you are viewing.

Invited into a collaborative workspace? How to get started.

You have been invited into Nestr by a colleague or friend. Let us run you through what Nestr is and how you can use it.

Nestr is a tool to help organisations get purpose driven work done using self-organisation and/or role based work.

This page is intended as a list of the most important help documents to quickly get you on your way.

The basics

  1. Navigating Nestr - Understanding the different elements in Nestr
  2. Structure/Governance - Creating and updating your shared agreements
  3. Work - Self-organised collaboration with your peers
  4. Communicate - Communicating with your peers using Nestr
  5. Search - Search for and finding things in Nestr

Setting up a new collaborative workspace

Great, you have signed up for Nestr and are ready to test it out. The fact you are hear probably means you care about purpose driven work and self-organisation.

There are many ways to self-organise and Nestr aims to support any and all experimentation around self-organisation. And since we don't pretent to know what the best way to self-organise is, we try to offer you a product that can adapt to your needs.

In this article I will lay out how you can configure Nestr to serve you as best as we can.

Creating a workspace

First, go ahead and setup a new workspace.

  1. Click the 'Add workspace' button on your hoe screen of click the '+ create -> workspace'. This will open the new workspace wizard.
  2. The first step in the wizard asks you if this is a personal or collaborative workspace. We are assuming you are setting up a collaborative workspace for now and will explain how to setup a personal workspace elsewhere.
  3. The second step in the wizard aks about your governance model. You can choose between General self organisation, Sociocracy or Holacracy. If the later two are unfamiliar to you, simply choose 'General self organisation'. In the background this will pre-configure your workspace for you.
  4. The third step in the wizard asks if you want Nestr to use AI to generate a starting structure of roles and circles for you or if you want to create these yourself manually.
  5. The last step asks you for the name, logo and purpose of your organisation. You may leave the logo and purpose empty and in the case of AI we'll attempt to autofill these for you.

Your worksapce is now created and ready for you to use. Here is an example of a non AI created workspace right after creation. Three core roles are created based on your governance method of choice.

Screenshot of the published org chart for a new Nestr workspace

In the top right of the new workspace you will find a settings icon. Click it to further configure your workspace.

Screenshot of the workspace settings page in Nestr

There you will find the following tabs:

  • Users: Invite your colleagues into this workspace to join you in your organisation.
  • Workspace details: Update the name, purpose, logo of your workspace.
  • Workspace plan & billing: Choose your plan and provide your billing details for your paid workspace.
  • User Permissions: Setup how access rights are organised in this workspace and optionally add domain names you own allowing people signing up using an email on those domains to automatically join your worksapce.
  • Workspace labels: Configure what labels are available in your workspace. This is very flexible and allows you to categorize your roles, circles and projects in any way you choose.
  • Applications: What applications are available in this workspace. This will allow you to turn them on/off and configure them. (see screenshot below)
  • Integrations: Which other tools and products do you want Nestr to integrate with? You can setup an ever growing list of integrations.

More on configuring your workspace can be found here.

Screenshot of available integrations in Nestr workspace settings

Importing data from other systems

If your are currently using another tool for your self-organisation, you can import that data into Nestr. Here is an article on how to do that for tools like Holaspirit, Glassfrog, Peerdom and others.

Next steps

Now that your workspace is created, you can start using it. Here are a few articles that lay out the basics of using Nestr:

  1. Navigating Nestr - Understanding the different elements in Nestr
  2. Structure/Governance - creating and updating your shared agreements
  3. Work - self-organised collaboration with your peers
  4. Communicate - communicating with your peers using Nestr
  5. Search - Search for and finding things in Nestr
  6. The building blocks of Nestr - How Nestr works so you can configure it to serve your needs

Using Nestr - a quick overview

Let us run you through the basic functionalities of Nestr

Navigating Nestr

Let me guide you through the different ways to navigate in Nestr.

Creating projects & todo's

Here I show how you can create projects and todo's and where you can find them

Starting a circle/tactical meeting

How to to start a circle/tactical meeting and run through the different steps.

Proposing a structure/governance change

If you'd like to suggest a change to a role, circle or policy, you can simply create an agenda item and propose it.

Please don't hesitate to reach out if you have more in depth questions. We're here to assist.

Getting started with Nestr

Many people starting with Nestr will also be somewhere on the journey of mastering self-organisation and role based work.

Our aim is for Nestr to both help you in your journey to master the practice of self-organisation as well as offer a simple and easy way to onboard you onto the product itself.

To help you on your way, we have created a two landing pages aimed at different audiences. Please choose one that is appropriate for you.

Also, feel free to use the help search at the top of the page or to click around through our help docs yourself.

Happy Nesting,

Joost