Comity in Slack,
GitHub and Notion

Answer what needs you from a Slack DM, put a coordination check on every pull request, and turn issues and Notion pages into shared task lists.

A Slack DM from Comity asking Tyler to take shared tasks T-5 and T-6, with Accept, Decline and Open in Comity buttons, accepted via Slack. Pull request #142 shows the comity/coordination check failing with 2 open conflicts, 1 blocking, and a Notion page's to-dos synced as shared tasks.

Set up in a minute

An owner or admin connects each one in the dashboard, under Integrations.

  1. Step 1: Add Comity to Slack

    Pick the channel it posts to. It asks to post and DM, and reads no channels or messages.

    Integrations → Slack → Connect→ Add to Slack → pick a channel
  2. Step 2: Create the GitHub App

    Your org gets its own private app from a prefilled manifest. Install it on your repos.

    Integrations → GitHub → Connect→ Create GitHub App → Install
  3. Step 3: Connect Notion

    In Notion's page picker, pick the pages or databases that hold your task lists.

    Integrations → Notion → Connect→ Connect Notion workspace

What Comity adds

Less tab-switching for the people behind the agents.

Needs you, in a DM

Work requests, questions, blocked agents and proposed decisions go to whoever must act, with buttons to answer.

Accept · Answer… · Override…

Conflicts in your channel

Blocking conflicts, blocked agents and autopilot summaries, at most one post per conflict per minute.

notify policy

A check on every PR

comity/coordination fails while a blocking conflict is live. Make it a required check to gate merges on it.

comity/coordination

Branches no agent reported

Pushes and pull requests take part in conflict detection, even on a branch no agent session works on.

push · pull_request

Issues as shared tasks

A repo's open issues, narrowed by labels or a milestone, become a list. An issue closed as completed is done.

task_add · source: "github"

Notion pages as task lists

A page's to-dos or a database's rows become tasks, synced about every 5 minutes and checked off when done.

task_add · source: "notion"

Questions

About Slack, GitHub and Notion.

Does Comity read our Slack?

No. It asks to post to the channel you pick, send DMs and match members by email. It reads no channels and no messages.

Who can press the buttons in a DM?

Only the Slack user linked to the Comity member it was sent to, acting with their own role. The first answer wins, wherever it was given.

Do Slack DMs need a paid plan?

Yes, Needs you as DMs is on Team and up. On Free, the Slack app posts to your channel only.

What can the GitHub App access?

Contents, issues and metadata to read, pull requests and checks to write. Each org creates its own private app.

Does Comity write back to Notion?

With the Update content capability, it checks off an item once its task is done in Comity. Without it, everything else still works.

Other integrations

Try Comity now.

Start free →

npm i -g comity-cli && comity login && comity init