Your GitHub and Linear Work, in Your Coven's Tasks

Most of my work lives in three places that don't talk to each other: the conversation where I figured out what to do, the tracker where someone wrote it down, and my head, where I keep a third, more honest list. AICoven's Tasks now pulls the second one in, so the first and the second can at least sit in the same room.

---

What it does

When you open a coven's Tasks, or On me, AICoven gathers:

• From GitHub: open issues assigned to you, and open pull requests with a review requested from you.
• From Linear: issues assigned to you that aren't completed or cancelled.

Each one becomes a task in that coven, with its labels and their colours, and a link back with Open in GitHub or Open in Linear. You see them as a List or on the Board. A gathered task is yours alone: in a shared coven, nobody else sees what was gathered for you.

From there, a task behaves like any other. Mark done, Close, Reopen, Move to… a column, Pin for today, or hand it over with Do it for me or Talk it through.

How to set it up

1. Settings → Connected Apps. Connect GitHub, Linear, or both.
2. Open the coven, then its Connections. Choose the account, then the Repositories (GitHub) or Teams (Linear) this coven cares about. A coven with none chosen gathers nothing, which is the point: your client work stays in the client's coven.
3. Choose what agents can do: Read, or Read and make changes. Read is the default.

GitHub only reaches repositories where the AICoven GitHub app is installed. If one is missing, Add an Organization or Repositories on GitHub… fixes that.

What changes in GitHub and Linear

With Read and make changes, a change you make in AICoven is also made in the app, as you:

• A GitHub issue: Mark done closes it as completed, Close closes it as not planned, and Reopen reopens it. If the issue sits in one GitHub Project, moving it on the Board sets its Status there too.
• A Linear issue: done, closed, reopened, or moved between columns, it moves to the matching Linear state.

A pull request waiting on your review is never written back. Ticking it off doesn't approve anything; it just means you've stopped pretending you'll get to it today.

It works the other way as well. Move an issue in Linear or GitHub Projects, and the task follows the next time Tasks opens.

Agents

An agent can work with these tasks too. With Linear and Read and make changes, agents can comment on an issue or change its status, assignee, title, or due date, as you and without asking first, in the teams you chose. That's the trade: speed for trust, and the switch to make it Read is in the same place.

What it doesn't do (yet)

• It gathers when you open Tasks or On me, or refresh. Nothing runs on a schedule.
• Review requests made to your team, and @-mentions, aren't gathered yet.
• No issue body or comment is read or stored. Titles and label names are stored as plain text, as every task title in AICoven is, so a label with a client's name in it is a label with a client's name in it.