Skip to main content

​
Setup

  1. Go to 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).

​
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).

​
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.
Plans can auto-approve based on your agent configuration. Set it to Always or Confidence-based to skip manual approval.

​
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.