Need help with trello-cli?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

mheap
246 Stars 44 Forks MIT License 154 Commits 8 Opened issues

Description

Command line client for Trello

Services available

!
?

Need anything else?

Contributors list

# 64,458
Laravel
trello
golang
Go
59 commits
# 7,686
Sublime...
python-...
trello
React
25 commits
# 250,487
c-sharp
asp-net...
F#
trello
16 commits
# 512,357
JavaScr...
trello
8 commits
# 292,096
Bootstr...
Arch Li...
install...
git-add...
4 commits
# 400,042
CSS
HTML
trello
Neovim
3 commits
# 34,767
Perl
ip-data...
netflix
qq
2 commits
# 111,608
CSS
trello
Rust
perform...
1 commit
# 522,963
JavaScr...
trello
React
resize-...
1 commit
# 690,243
JavaScr...
trello
1 commit
# 117,623
Dart
angular...
Symfony
oauth2
1 commit
# 605,923
JavaScr...
trello
1 commit

trello-cli is a CLI tool for Trello. Makes sense, right?

Build Status

trello-cli
requires a minimum NodeJS version of 8

Installation

You can install this tool by running

npm install -g trello-cli
.

If you're an Arch user, it's also available in the Arch User Repository

Using trello-cli

  • Run
    npm install
    in the same directory as
    package.json
    to install dependencies
  • Run
    ./bin/trello
    to generate basic config in your home directory.
  • Get an API key and put it in
    ~/.trello-cli/config.json
  • Run
    ./bin/trello refresh
    to refresh the list of Trello boards and lists.
  • Run
    ./bin/trello
    + follow the instructions

If you get stuck, you can always run

./bin/trello --help
or
./bin/trello command --help

If you installed globally

Instead of running

./bin/trello
just run
trello
.

Supported API commands

trello-cli currently supports the following commands:

add-board          Adds a new board with the specified name
add-card           Add a card to a board
add-list           Adds a new list to the spcified board with the specified name
add-webhook        Add a webhook to a board
archive-card       Archive a card from a board
assigned-to-me     Show cards that are currently assigned to yourself, or any member specified
card-assign        Add or remove a member to a card
card-details       Show details about a specified card
close-board        Closes those board(s) where the specified text occurs in their name
delete-card        Remove a card from a board
delete-webhook     Remove a webhook by ID
move-all-cards     Move all cards from one list to another
move-card          Move a card on a board
refresh            Refresh all your board/list names
show-boards        Show the list of cached boards
show-cards         Show the cards on a list
show-labels        Show labels defined on a board
show-lists         Show the list of cached lists
show-webhooks      display webhooks for current user applications

On Windows

Depending on how

node.js
is setup, you may not be able to run
trello
straight from the command line as shown above. To remedy that, add the following to your Powershell profile (type
$profile
at the Powershell prompt to find where your profile is stored):
function trello { & 'PATH_TO_NODE.EXE' 'PATH_TO_TRELLO_BIN' $args }

Replacing

PATH_TO_NODE.EXE
and
PATH_TO_TRELLO_BIN
with the values from your system.

You will then have the

trello
command available anywhere.

Examples

# Add card:
$ trello add-card -b "Inbox" -l "Inbox" "Quick card added from command line" -p bottom

Move all cards:

$ trello move-all-cards -b "GTD" -l "Completed next actions" -c "GTD" -d "Completed next actions (Nov 2-8)"

FAQ

Archived lists aren't included when I run

trello refresh
By default archived lists are not returned by the API. Set the

TRELLO_CLI_LIST_FILTER
environment variable to
all
to include archived lists.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.