Asana
Asana is a work-management tool where teams organise tasks in projects inside workspaces.
What it reads
- Who you are and your workspaces: your user id and name and your workspaces (names); the first 3 workspaces are read
- Tasks you completed: tasks assigned to you that were completed since your last read (7 days on the first read), up to 50 per workspace: name, notes, completed flag, completed time and the first project's name
- Projects: non-archived projects in each workspace (up to 25) with name, notes and created time; only those created in the window become moments
Moments
- A task assigned to you is completed. You complete the task 'Write onboarding emails' in the project 'Launch'. FoxPlug writes 'Completed: Write onboarding emails' with the task's notes and '(Launch)' at the end, and scores it like any other update.
- A new project is created in one of your workspaces. You create a project called 'Mobile app v1' this week. FoxPlug writes 'Started a new project: Mobile app v1' with the project's notes, or 'Kicked off Mobile app v1 in <workspace>.' if there are none. Whether it becomes a post depends on its score.
Set up
- Open https://app.asana.com/0/my-apps
- Click '+ Create new token'.
- Give it a name (FoxPlug).
- Click 'Create token'. Asana shows it once. Copy it now and paste it into the Asana box in FoxPlug.
- Press Check for what's new.
What it never reads
- Comments, attachments or tasks assigned to other people: the task call is filtered to your own assignee
- Archived projects
- Anything it could write: only GET requests are made
How it differs
Asana versus Jira, ClickUp, Trello and Linear: Asana reads only tasks assigned to the token's owner (plus newly created projects) and does not sort them into bug or feature. Its token is full-access, unlike Trello's read-only token or the Linear key that can be restricted. Jira and ClickUp sort finished work into feature, bug or other; Linear reads the 25 latest completed issues; Trello reads cards in lists named like Done.
Is the Asana token read-only?
No. Asana has no read-only token: a personal access token can do anything you can do in Asana. FoxPlug's code only makes read requests, but the token itself is not limited, so keep it private and revoke it from Asana's apps page if you stop using it.
Which tasks does FoxPlug see?
Tasks assigned to you that you completed, in your first 3 workspaces, plus projects created recently. Tasks assigned to other people are not read.
When does it read Asana?
Only when you press Check for what's new. Nothing is fetched on a timer for your project.
Has the Asana connection been tested against a real account?
No. It is marked code-path-only: the code path exists and its offline checks pass, but no real Asana account of ours has exercised it.
Linear
Linear is an issue tracker for software teams, built around issues, projects and cycles.
What it reads
- Recently completed issues: the 25 most recently updated issues that have a completed time; for each: id, identifier, title, description, completed time and project name
- The project an issue belongs to: project name, added to the end of the milestone text in brackets
Moments
- An issue is completed. You close the issue 'Add CSV export to reports' in the project 'Reports v2'. At the next Check for what's new FoxPlug writes the moment 'Shipped: Add CSV export to reports' with the issue's description and '(Reports v2)' at the end, scores it, and the brain may offer it as a say card.
- Several completed issues that have not been announced. You close 3 issues this month and none has an approved or posted update. Linear entries count toward the 'shipped but never announced' rule, so the brief names the highest scoring one as the say line.
Set up
- Open https://linear.app/settings/account/security
- Find 'Personal API keys' and click 'Create key'.
- Give it a name (FoxPlug). If you are offered the choice, restrict it to Read and to the teams you want FoxPlug to see; FoxPlug never needs to change anything.
- Click Create. Linear shows the key once. Copy the key that starts with lin_api_ now and paste it into the Linear box in FoxPlug.
What it never reads
- Comments, assignees, reporters or labels: the request names only id, identifier, title, description, completed time and project name
- Issues that are not completed
- Anything it could write: the only call is a read query
How it differs
Compared with the other work trackers: Linear is read over GraphQL with a personal API key, takes the 25 latest completed issues with their description and project, and does not sort bugs from features (every one is 'Shipped:'). Jira (email plus API token, Jira Cloud only) and ClickUp (personal token) read closed work for a date window and sort it into feature, bug or other. Asana reads only tasks assigned to the token's owner plus new projects. Trello reads cards in lists named like Done. Notion reads edited pages, not finished work.
Does FoxPlug change my Linear issues?
No. It sends one read query for completed issues. The key is a personal API key; if Linear offers a Read-only restriction when you create it, pick that.
What does FoxPlug do with my completed issues?
Each one becomes a 'Shipped:' moment with its title, description and project. It is scored like any other update and the brain may suggest it as a post or count it toward 'shipped but never announced'.
When does it read Linear?
Only when you press Check for what's new. Nothing is fetched on a timer for your project.
Has the Linear connection been tested against a real account?
No. It is marked code-path-only: the code path exists and its offline checks pass, but no real Linear account of ours has exercised it.
Notion
Notion is a workspace for notes, docs, wikis and databases, organised as pages.
What it reads
- Pages your connection can see: a search over pages, most recently edited first, 50 at a time; only pages you shared with the connection appear
- Each page's title and last edited time: the page id, the text of the title property and the last edited time; pages edited before your last read are skipped
Moments
- A page you shared with the connection is edited. You edit your page 'Launch checklist' today. At the next Check for what's new FoxPlug writes 'Updated: Launch checklist' with the line 'Worked on "Launch checklist" in Notion.' It is scored like any other update; the code treats an edited page as a soft signal, so whether it becomes a post depends on its score.
- The same page edited on another day. The page's moment id carries the edit date, so editing 'Launch checklist' on Monday and again on Wednesday gives two moments, one for each day.
Set up
- You must be a Workspace Owner. Open https://app.notion.com/developers/connections and, in the Build section of the sidebar, select 'Internal connections'.
- Click 'Create a new connection', give it a name (FoxPlug) and choose the workspace it belongs to.
- On the Configuration tab, under capabilities, turn on 'Read content' and leave the rest off.
- Copy the Installation access token (it starts with ntn_) and paste it into the Notion box in FoxPlug.
- The step everyone misses: in Notion open the page or database you want FoxPlug to watch, click the three-dot menu, choose Connections, click '+ Add connection' and pick FoxPlug by name. Sharing a parent page passes access down to everything inside it.
What it never reads
- The body of your pages: the only call is a search, and only the title property is used
- Pages you have not shared with the connection
- Anything it could write: the only call is a search
How it differs
Different in kind from the task trackers: Linear, Jira, ClickUp, Asana and Trello report finished work (a completed issue, task or card). Notion reports that a page was edited, with only its title, so nothing says anything was shipped; the comment in the code calls it a soft signal.
Does FoxPlug read what is inside my Notion pages?
No. It searches for pages and uses each page's title and last edited time. The page body is not fetched.
Why does FoxPlug see nothing after I paste the Notion secret?
A Notion connection can see nothing until you share a page with it. Open the page, use the three-dot menu, choose Connections, add FoxPlug. Sharing a parent page covers the pages inside it.
When does it read Notion?
Only when you press Check for what's new. Nothing is fetched on a timer for your project.
Has the Notion connection been tested against a real account?
No. It is marked code-path-only: the code path exists and its offline checks pass, but no real Notion workspace of ours has exercised it.
Trello
Trello is a card-and-board tool where teams move cards through lists such as To do, Doing and Done.
What it reads
- Your open boards: board id and name of the boards you belong to; the first 8 are read
- The lists on each board: open lists; only lists whose name contains done, complete, completed, shipped, finished or released are kept
- Cards in those lists: card id, name and last activity time; cards with no activity since your last read are skipped
Moments
- A card sits in a Done-style list and has activity since your last read. You drag the card 'Redesign the pricing page' into your list called 'Done'. FoxPlug writes 'Completed: Redesign the pricing page' with the line 'Redesign the pricing page', and scores it like any other update.
- Cards in lists named Shipped or Released. A card 'Launch referral program' sits in a list named 'Shipped'. The list name matches the Done pattern, so it becomes 'Completed: Launch referral program'; the brain decides from its score whether it is worth a post.
Set up
- Open https://trello.com/apps/admin
- Create a new Power-Up, or open one you already have. It is only a container for the key; you do not have to build anything.
- Open the 'Trello Auth' tab and click 'Generate a new API Key'. Copy the API Key and paste it into the API Key box in FoxPlug.
- On that same page, next to the key, click the 'Token' link, then click 'Allow'.
- Copy the token you are given and paste it into the token box in FoxPlug.
What it never reads
- Card descriptions, comments, members and attachments: the card call asks only for name and last activity
- Lists that are not named like Done
- Anything it could write: only GET requests are made
How it differs
Trello versus Jira, ClickUp, Asana and Linear: Trello has no 'completed' flag, so FoxPlug infers it from the name of the list a card sits in (done, complete, shipped, finished, released). It reads only card names and times, does not sort bugs from features and does not filter by assignee. Jira and ClickUp sort finished work into feature, bug or other; Asana reads tasks assigned to the token's owner; Linear reads completed issues with their description.
Which Trello cards does FoxPlug count as finished?
Cards sitting in a list whose name contains done, complete, completed, shipped, finished or released. A list with a different name, such as 'Live', is not read.
Does FoxPlug read card descriptions or comments?
No. It reads each card's name and last activity time only.
Why does Trello need both an API key and a token?
Trello's API takes both. They come from two clicks on the same Power-Ups admin page: the key first, then the Token link beside it.
Has the Trello connection been tested against a real account?
No. It is marked code-path-only: the code path exists and its offline checks pass, but no real Trello account of ours has exercised it.
FoxPlug reads this tool only when you press Check for what's new, and only to read. Plans and limits are on the pricing page. Questions: support.