Atom Packages Directory

a package directory for a text editor of the 21st Century

Imdone Atom by Jesse Piascik

Install with:
    apm install imdone-atom

A task board made from TODO comments in your code and text files

Turn your TODO comments and plain text tasks into a task board and set up webhooks on to integrate with anything
Just use alt+t while editing a file to see your projects board.

Static imdone image

apm apm

NEW in 2.2 Webhooks!

### Now you can integrate any way you want
Just configure the payloadURL of your project’s webhook. The payloadURL will receive an HTTP POST with the following JSON body. js { "taskNow": {}, // "taskBefore": {}, // "delta": {} // }

You can also update tasks by returning a json response in the following format. ```js { text: “The text of the task id:3 +story trello:19”, list: “DOING” }


Working webhook examples in Glitch

### imdone-webhook-twitter - Tweet your TODO comments when they change - Check out this blog post to get started


You live in the code, your tasks should too!

For decades developers have used TODO style code comments to track issues that almost never end up in issue tracking software. imdone is a plugin for your favorite text editor that turns code comments into trackable issues that you can update from your code. It collects all TODO style comments in your project and organizes them in a drag and drop task-board that can integrate with GitHub, and soon whatever you want with webhooks using

imdone works best with todo.txt and markdown syntax. See the syntax guide at imdone-core for details.


### Filtering your board imdone uses regular expression matching to filter your cards on your board. The content and the path of the file are searched, but the Token (e.g. TODO) is not searched. filter-tasks

Delete all visible tasks

Just click on the trash can icon and all the visible tasks will be deleted. imdone will also get rid of any blank lines left behind! Great for cleaning up!

Open all files for visible tasks

Click on the lightning bolt icon and open all files for the visible tasks.

Using tags in your TODO comments

imdone uses a bit of Todo.txt format (except priority), so +bug would be a tag. Tags in TODO content are turned into filter links, so clicking on it will filter the board.

Using contexts and @name syntax

You can use Todo.txt contexts in the same way. They’ll also be turned into filter links.


Another great benefit of using Todo.txt format is the metadata. Just use the format ` key:value , and your metadata will be listed in a table inside the task card. We use metadata for integrations like gh:1 to represent github issue number 1 and id:1` to represent imdone task id 1.

Integrate with issue tracking

My favorite feature of imdone are the integrations. Today you can integrate with github and Jira SaaS integration is coming soon. integration

if the token DOING is mapped to “in progress” then a TODO like this

js // DOING: DRY this code up, and create a new method +enhancement id:1 gh:1

will move the waffle card to the “in progress” list in your project

Adding and removing TODO tokens

You can add a token by just adding an all caps list using the add list button. If the list name matches this regex [A-Z]+[A-Z-_]{2,} a new token will be created. Adding a  TODO token If the list name matches this this regex /[\w\-]+?/, then you will have to use the hash style syntax like this… js // #to-do: This is in a list that doesn't have all caps! ### Code journal Configure a directory to use as a daily journal. Open the daily journal with alt+j. If your like me, you’ll just use dropbox directory for this. Remember, you can use TODO’s in any text file if you put a # in front of the token, like this… md This is my simple markdown journal - #TODO: Finish this work

Use your code journal for anything, even planning your next set of features!

### Open files in intellij and webstorm - Open task links in intellij family of products with imdone-atom and imdone intellij plugin!

Ignoring files


$ apm install imdone-atom or open Atom and go to Preferences > Install and search for imdone-atom


| Command Palette | Key Mapping | Description | |:——————————|:————|:————————-| | Imdone Atom: Tasks | Alt+T | Open task board | | Imdone Atom: Todays Journal | Alt+J | Open todays journal file | | Imdone Atom: Board Zoom In | Alt+. | Zoom in board | | Imdone Atom: Board Zoom Out | Alt+, | Zoom out board |


| Name | Type | Default | Description | |:———————————–|:——–|:————|:———————————————————————————————–| | Exclude Vcs Ignored Paths | boolean | false | Exclude files that are ignored by your version control system | | File Opener Port | integer | 9799 | Port the file opener communicates on | | Max Files Prompt | integer | 2500 | How many files is too many to parse without prompting to add ignores? | | Open in Intellij | string | ‘’ | Glob pattern for files that should open in Intellij. | | Show Notifications | boolean | false | Show notifications upon clicking task source link. | | Show Tags Inline | boolean | false | Display inline tag and context links in task text? | | Today’s Journal Date Format | string | YYYY-MM-DD | How would you like your date variable formatted? | | Today’s Journal Directory | string | $HOME/notes | Where do you want your journal files to live? (Their project directory) | | Today’s Journal File Name Template | string | ${date}.md | How do you want your journal files to be named? | | Today’s Journal Month Format | string | YYYY-MM | How would you like your month variable formatted for use in directory or file name template? | | Use Alternate File Watcher | boolean | false | If your board won’t update when you edit files, then try the alternate file watcher | | Zoom Level | Number | 1 | Set the default zoom level on startup. min: .2, max: 2.5 |

Keywords: todo, fixme, tasks, productivity, issues, flow, zone, waffle, github issues, webhooks Suggest keywords
Fork me on GitHub