trello-helpers

1.0.25 • Public • Published

trello-helpers

This integrates with your Trello account using the API to do some more complicated repetitive operations.

Installation

Global: npm i -g trello-helpers

Environmental Variables:

{
  trelloKey: process.env.TRELLO_KEY,
  trelloToken: process.env.TRELLO_TOKEN,
  trelloBoard: process.env.TRELLO_BOARD,
  todayList: process.env.TRELLO_LIST || 'Today',
  trelloLabel: process.env.TRELLO_LABEL || 'Daily'
}

Your key and token can be gotten from the Trello API, here.

Other necessary value:

  • TRELLO_BOARD: This should be the name for your default Board. To get this, use trello-helpers --findBoard to get all names: this should be in human english. For instance, mine is called Life As It Is Played.

Optional values:

  • TRELLO_LIST: This should be the name for your active To Do list. Default: Today.
  • TRELLO_LABEL: This should be the name for your label for recurring items to be copied. Default: Daily.

Methods

create

$ trello-helpers --create 'This is a new card'

This will create a new card at the top of your target list as specified in your env, with the name of the argument.

Aliases: c
Options:

  • -list <target list>
    Description: An optional list argument will create the card if a list exists with that name.
    Aliases: l
    Default: In
  • -position <position>
    Description: An optional position argument will specify where that card should go in the list.
    Aliases: p
    Values: top, bottom, or positive number.
    Default: top

duplicates

$ trello-helpers duplicates

This will delete duplicate cards in a given list. It will also selectively delete only cards which have a certain label (mine is daily).

Aliases: d
Options:

  • --list=<target list> Description: This will delete duplicates in a given list if a list exists with that name. Aliases: l Default: process.env.TRELLO_LIST
  • --label=<label> Description: This will delete duplicates only with a given label Aliases: null Default: process.env.TRELLO_LABEL || 'Daily'

lists

$ trello-helpers lists

This will console log the names of all lists for the given board.

list <list_name>

$ trello-helpers --list 'To Do'

This will print the names of all cards for a given list.

Aliases: l

today

$ trello-helpers today

This will copy all of the cards from a list (mine is called 'Daily Processes') to another list with the format June 16th, 2015. It then copies all of those cards from that list to a list called Today, the goal being that daily processes are added to your to do list for that day, and you have a fresh card to start putting daily accomplishments on.

Aliases: t

archive

$ trello-helpers --archive

This will archive any duplicate empty lists, because who needs those, amiright?

findBoard

$ trello-helpers --findBoard

Print a list of all boards and boardIds to the console, for use in setting the initial ENV vars.

Readme

Keywords

Package Sidebar

Install

npm i trello-helpers

Weekly Downloads

5

Version

1.0.25

License

MIT

Last publish

Collaborators

  • richardlitt