{"id":16615721,"url":"https://github.com/michaelaquilina/tro","last_synced_at":"2025-10-12T02:39:15.104Z","repository":{"id":57670604,"uuid":"163523626","full_name":"MichaelAquilina/tro","owner":"MichaelAquilina","description":"Trello command line utility written in Rust","archived":false,"fork":false,"pushed_at":"2025-04-04T12:49:14.000Z","size":1036,"stargazers_count":30,"open_issues_count":2,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-30T07:09:24.392Z","etag":null,"topics":["cli","note-taking","productivity","trello"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MichaelAquilina.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-12-29T16:06:53.000Z","updated_at":"2025-04-05T05:27:11.000Z","dependencies_parsed_at":"2024-10-26T20:34:16.373Z","dependency_job_id":"0ec0b404-6a7b-4240-a42a-e434aae85d37","html_url":"https://github.com/MichaelAquilina/tro","commit_stats":{"total_commits":446,"total_committers":3,"mean_commits":"148.66666666666666","dds":0.2017937219730942,"last_synced_commit":"c097cc50dd7bbe776c1ddf39f145de3938457cda"},"previous_names":["michaelaquilina/trello-rs"],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAquilina%2Ftro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAquilina%2Ftro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAquilina%2Ftro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MichaelAquilina%2Ftro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MichaelAquilina","download_url":"https://codeload.github.com/MichaelAquilina/tro/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251658212,"owners_count":21622822,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","note-taking","productivity","trello"],"created_at":"2024-10-12T02:10:26.792Z","updated_at":"2025-10-12T02:39:10.077Z","avatar_url":"https://github.com/MichaelAquilina.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"===\nTRO\n===\n\n|CircleCI| |CratesIO|\n\n``tro`` is a Trello API client for the command line written in rust.\n\n.. image:: assets/tro_show_board.png\n   :width: 400\n\n\u003e NOTE that tro is still considered to be in development. Expect things to change suddenly and without warning\n\u003e until this notice is removed!\n\nInstallation\n============\n\nCurrently, the only way to install is through cargo\n\n::\n\n   cargo install tro\n\nSetup\n=====\n\nRun ``tro setup`` to setup tro for the first time.\n\nTake a look at ``tro --help`` for a list of all available subcommands after that.\n\nAvailable Subcommands\n=====================\n\n* setup: Setup tro for the first time\n* show: Show an object (Board, List or Card)\n* search: Search for Trello cards\n* create: Create an object\n* move: Move a card from one list to another\n* open: Open an object that has been closed\n* close: Close an object\n* label: Apply or remove a label on a card\n* url: Display the url of an object\n* attach: Attach a file to a Card\n* attachments: View attachments on a Card\n* me: display currently logged in user\n\nHow it works\n============\n\nMost of the subcommands in this tool work by specifying one or more patterns in the form of:\n\n::\n\n    \u003cboard pattern\u003e \u003clist pattern\u003e \u003ccard pattern\u003e\n\nA pattern is any valid regex pattern. You can specify simple patterns such as just specifying a substring too.\n\n``tro`` then attempts to match the pattern you supplied with the available object(s):\n\n* If ``tro`` does not manage to find a match for one or more if the items specified, then it will display an appropriate error.\n\n* If ``tro`` manages to find a unique match for each of the items specified, then it will successfully display the object(s) you requested.\n\n* If ``tro`` finds any of the patterns are matched with multiple possible items, then the tool will be unable to precisely determine which object you were referring to and do its best to explain why.\n\nUsage Example\n=============\n\nSay we have a board named \"TODO\" with two lists named \"today\" and \"done\".\n\nWe can show the entire board by just specifying the board name:\n\n.. image:: assets/tro_show_board.png\n   :width: 400\n\nNotice how by default patterns are case insensitive. You can make pattern matches case sensitive with the ``-c`` flag.\n\nIf we want to only see a specific list within the board, we can specify an additional list pattern:\n\n.. image:: assets/tro_show_list.png\n   :width: 400\n\nIf we want to show/edit a specific card, then we can also specify an additional card pattern.\n\nShowing a card will open your default editor (specified by the ``EDITOR`` environment variable) so that you can edit the contents of the specified card.\n\nFor example, running ``tro show todo today rust`` would open as follows:\n\n.. image:: assets/tro_show_card.png\n   :width: 400\n\nA card which has contents can be easily spotted by the ``[...]`` marker when viewing a board or list:\n\n.. image:: assets/tro_card_contents.png\n   :width: 400\n\nSubcommands\n===========\n\nThis section will explain some of the more useful subcommands in detail\n\nCreate Command\n--------------\n\nCreate a Board, List or Card.\n\nTo create a new board, specify no patterns with ``create``.\n\n::\n\n    $ tro create\n    Board name: TODO\n\nTo create a new list within a board, specify the board which the list will belong to as a pattern.\n\n::\n\n    $ tro create TODO\n    List name: Today\n\nTo create a new card within a list, specify the board and the list\nwhich the card will belong to as the two patterns:\n\n::\n\n    $ tro create TODO today\n    Card name: Walk the dog\n\nWhen creating a card, you can specify the ``--show`` flag to immediately edit the card once it has been created.\n\nYou can also specify one or more labels to assign to a card with\nthe ``--label`` flag.\n\n::\n\n     $ tro create TODO today --label fun\n     Card name: Walk the dog\n     Applied  Fun Times  label\n\nSearch Command\n--------------\n\nYou can perform a search for cards using Trello's Search_ syntax\n\nFor example:\n\n::\n\n    $ tro search dog bones is:open\n    Dig up some dog bones [...] id: 5ed78889acdaf970289ac894\n    walk the dog id: 5da72eed111e6a56d3407e0b\n\nAll operators in the standard Trello search syntax are supported. For example if we want cards which\nonly have descriptions:\n\n::\n\n    $ tro search dog bones is:open has:description\n    Dig up some dog bones [...] id: 5ed78889acdaf970289ac894\n\nIf you wish to use the negative operator, use ``~`` instead of ``-``.\n\n::\n\n    $ tro search dog bones is:open ~has:description\n    walk the dog id: 5da72eed111e6a56d3407e0b\n\nInteractive Mode\n================\n\nMost subcommands have an interactive mode that can be enabled by passing the ``--interactive`` or ``-i`` flag.\n\nInteractive mode provides a simple keyboard interface to choose relative items when possible.\n\n.. _Search: https://help.trello.com/article/808-searching-for-cards-all-boards\n\n.. |CircleCI| image:: https://circleci.com/gh/MichaelAquilina/tro.svg?style=svg\n   :target: https://circleci.com/gh/MichaelAquilina/tro\n\n.. |CratesIO| image:: https://img.shields.io/crates/v/tro.svg\n   :target: https://crates.io/crates/tro\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelaquilina%2Ftro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelaquilina%2Ftro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelaquilina%2Ftro/lists"}