Skip to main content

​
Setup

Make sure your GitHub App is connected and the repo is accessible. See the Quickstart.
  1. Go to Settings → Integrations → Notion and connect your workspace
  2. In Notion, make sure Twill has access to the pages where you want to use it (Notion will prompt you during connection)

​
Create a Task

Mention @twill in a Notion comment with your request: 
@twill Add pagination to the users list
Know the repo? You can include it directly: 
@twill owner/repo: Add pagination to the users list

@twill https://github.com/owner/repo: Fix the login bug
Twill will start analyzing and will post updates back into the same Notion comment thread (for example: repo selection, the plan, and completion).
Twill responding to a Notion comment with an implementation plan

​
Pick a Repository (if you didn’t specify one)

If your Notion comment includes @twill but doesn’t include a repo:
  • If your workspace has multiple accessible repositories, Twill replies with a list of repository links to choose from (click one).
  • If your workspace has a single accessible repository, Twill selects it automatically.

​
Approve the Plan

Once analysis is done, Twill posts the implementation plan back into the Notion comment thread with an approval link. Want changes? Reply in the same Notion thread with feedback — Twill will revise the plan. Ready? Click the approval link to start implementation.

​
Request a Plan

By default, Twill starts implementing immediately. To request a plan first, include /plan in the triggering Notion comment: 
@twill /plan Add pagination to the users list
See Research & Planning for details on how planning and approval works.

​
Pick an Agent / Model (optional)

You can optionally override the agent and/or model when creating a new task by adding agent= and/or model= to the triggering Notion comment: 
@twill agent=claude model=sonnet Add pagination to the users list
If you specify agent= but omit model=, Twill uses defaults:
  • agent=claude-code → Opus
  • agent=codex → GPT 5.2 Codex
  • agent=open-code → GPT 5.2 Codex
@twill /plan agent=codex model=gpt-5.2-codex owner/repo: Add pagination to the users list
Agent/model overrides only apply when the comment creates a new task. Follow-ups in the same Notion thread don’t change the agent/model.

​
Clarifications

If Twill needs more information, it will ask clarifying questions in the thread. Reply in a new comment (plain text) and include @twill with your answers.

​
Follow-ups

Reply in the same Notion comment thread and mention @twill again to add more context or adjust the request. Twill treats it as a follow-up on the existing task for that thread.