Repository files navigation

1. Table of Contents
2. Motivation
3. Prerequires
4. Setup
   • 1. Install Roamist
   • 2. Configure Roamist
   • 3. See[[roam/roamist]]
   • 4. RunRoamist - pull ... smartblocks
   • 5. Place a button on the[[Roamist]] page.
5. Workflows
   • pull-tasks
   • sync-completed
   • complete-task
   • quick-capture
6. roam/css for priority
7. Inspired

I have been using Todoist as my task management tool for a long time.
I still think that Roam Research is the best note-taking tool, but Todoist is more suitable for task management.

Since I started using Roam Research, I've wondered if it would be possible to use Todoist for task management but take detailed notes for each task in Roam Research.

Roamist is one way to make this possible. With this integration, you can copy tasks from Todoist to Roam Research, complete Todoist tasks from within Roam Reasearch, and synchronize task completion status between Todoist and Roam Reserach.

• Todoist’s api token
  • See:https://developer.todoist.com/rest/v1/#javascript-sdk
  • You can get your token onhttps://todoist.com/prefs/integrations.
• SmartBlocks (You can install it through roam-depot)
  • https://roamjs.com/extensions/smartblocks

• Install Roamist through roam-depot.
• You can see[[roam/roamist]] is created.

• FillTodoist's token, andTodoist filters.
  • Todoist's token
    • You can get your token via todoist.com/prefs/integrations.
  • Todoist filters
    • left:
      • Name of your filter.
        • ex.Today's work
    • right:
      • Todoist filter.https://todoist.com/help/articles/205248842.
        • ex.(today | overdue) & #Work

• You can see some blocks are added automatically if you setTodoist filters correctlly.
  • Please don't modify blocks of this page. That makes Roamist broken.
• Roamist - pull today (only diff) is designed to ignore blocks that already exist on the page where smartblock is executed.
  • This is useful if you only want to bring tasks that are newly added to Todoist into Roam.

You can edit, add or remove filters at any time.
Roamist will do its best to automatically reflect them, but if you have problems, first try removing theworkflows block on the[[roam/roamist]] page and then reload Roam.

• Run smartblocks on any page you like.
  • If you have set it up properly so far, you should be able to run smartblocks with a name likeRoamist - pull ....
  • If there are no tasks in Todoist, nothing will be imported, so make sure you have tasks in Todoist.

Have you been able to import tasks from Todoist?
The block you have imported will be labeled#Roamist. Let's navigate to this page.
In the first block on[[Roamist]] page, enter a block like this.

- `{{Sync todoist completed:42SmartBlock:Roamist - sync completed:button=true,42RemoveButton=false}}`

You can use this button to reflect the completion status of Todoist tasks into Roam.There is no need to change each TODO to DONE on Roam.

⚠️This integration recognizes the Todoist id using a tag likeTodoist/1234567890.
You must NOT remove this tag.
If you do, Roamist won't work as intended.

• This workflow will pull tasks with theTodoist's Filters.
  • You can set your filter in[[roam/roamist]]
    • 
• Block will look like this.
  • 

• This workflow will sync completion status from Todoist to Roam Research.
• I recommend you use this workflow as a button in[[Roamist]] as follows.
  • {{Sync todoist completed:SmartBlock:Roamist - sync completed:RemoveButton=false}}
  • 

• This is almost the same one assync-completed, but it only works for a single day.
• It's supposed to be used in DNP.
• It might be useful if you have recurring tasks.
• I would recommend you put the following button in your daily template.
  • {{Sync todoist DNP completed:SmartBlock:Roamist - sync completed (DNP):RemoveButton=false}}

• This workflow will complete a task under your cursor.
  • After running this workflow,{{[[TODO]]}} will turn into{{[[DONE]]}} automatically.

• This workflow pulls Todoist's tasks.
  • Todoist's filter for quick Capture is used.
  • Unlike pull-tasks, this workflow marks Todoist's tasks as completed.
  • ex. If you set like#Quick Caputure, whole tasks inQuick Capture product of todoist will be copied, and original tasks are marked as completed.

• I recommend you set css for todoist's priority.
  • ref.https://roamresearch.com/#/app/help/page/RA1UXmzp0

-#priority/p1#priority/p2#priority/p3#priority/p4- ```css@importurl('https://kdnk.github.io/roamist/style.css');    ```

• dvargas92495/roam42
• Universal Quick Capture for Roam Research Beta