toodles: Manage the TODO entries in your code

[ library, mit, program, project-management ] [ Propose Tags ]

See the README on GitHub at

[Skip to Readme]
Versions [faq],,,,,,,,,,,,,,,,, 0.1.1, 0.1.2, 0.1.3, 0.1.4, 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.1.0, 1.1.1, 1.2.1, 1.2.2
Dependencies aeson, base (>=4.7 && <5), blaze-html, bytestring, cmdargs, directory, filepath, http-types, megaparsec, MissingH, regex-posix, servant, servant-blaze, servant-server, strict, text, transformers, wai, warp, yaml [details]
License MIT
Copyright 2018 Avi Press
Author Avi Press
Category Project Management
Home page
Bug tracker
Source repo head: git clone
Uploaded by aviaviavi at Tue Oct 9 17:17:28 UTC 2018
Distributions NixOS:1.2.1
Executables toodles
Downloads 2899 total (536 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs not available [build log]
All reported builds failed as of 2018-10-09 [all 3 reports]


Maintainer's Corner

For package maintainers and hackage trustees

Readme for toodles-

[back to package description]


Build Status

Toodles scrapes your entire repository for TODO entries and organizes them so you can manage your project directly from the code. View, filter, sort, and then edit your TODO's with an easy to use web application. When you're done, commit and push your changes and share changes with your team!

Toodles Screenshot

TODO details

Specify details about your TODO's so that you can filter and sort them with ease! Specify details within parenthasis and separate with the | delimeter.

# TODO(assignee|p=1|keys=vals|#tags) 


The key p=<integer> will be interpreted as a priority number


Use arbitrary key value pairs <key>=<value>|<key2>=<value2>|... and design any organization scheme you wish! A good use for this is to enter dates of deadlines for TODO's that you can sort on in Toodles


A detail starting with #, eg #bug|#techdebt|#database|... will be interpreted as a tag, which can be used to label and group your TODO's.


Assign your TODO's to someone. Any plain word that will be interpreted as an assignee.

# TODO(bob) - something we need to do later

Per Project Configuration

You can configure toodles by putting a .toodles.yaml file in the root of your project. See this repo's .toodles.yaml for the full configuration spec.

Currently via config you can:

  • Set files to ignore via a list of regular expressions

Scanned Languages

Submit a PR if you'd like a language to be added. There will eventually be support for this to be user configurable

  • C/C++
  • Elixir
  • Erlang
  • Go
  • Haskell
  • Java
  • Javascript
  • Objective-C
  • Protobuf
  • Python
  • Ruby
  • Rust
  • Scala
  • Shell / Bash
  • Swift
  • Typescript
  • Yaml

Current Limitations

Due to the parser's current simplicity, Toodles won't see TODO's in multiline initiated comment. For instance in javascript

// TODO(#bug) this would be parsed


 TODO(#bug) this will _not_ be picked up by toodles