semvec/pypi-packages huggingface dataset:
meistertask-cli 2.1.0
Command-line client for Meistertask
License: MIT
Requires Python: >=2.7

# Meistertask-cli

[![PyPI version](https://badge.fury.io/py/meistertask-cli.svg)](https://badge.fury.io/py/meistertask-cli)

## What is meistertask-cli

Meistertask is a cloud-based project management tool, based on Kanban-style.
If you are familiar with Trello, then think of it the same way


## Why I build this ?

Once I discovered this platform from my tutor during an internship, I basically started using
it on every project I'm working on.

My problem was the **Terminal**, most of the time I'm working on a terminal / IDE, so it became a pain in the ass for me to open a browser window, authenticate, make a chagne, add a task, create a project ...
So I thought why not build a terminal-based tool to save me some time.

And here it is :smiley:

> **warning**: *Some features are not available because the official meistertask api does not support them yet.*

## Overview 

[![asciicast](https://asciinema.org/a/J2823GKg7Yd2XdDqEbiAAqvdn.svg)](https://asciinema.org/a/J2823GKg7Yd2XdDqEbiAAqvdn)
## Requirement
First thing you need is python (obvious).

### GET Key
Second thing you need is an access token key, you can acquire one from the official link here:

[official api](https://www.mindmeister.com/api)

Scroll down to **Personal access tokens** and add new one.

Make sure to **select** all options, and **de-select** these two:

    * mindmeister.readonly
    * meistertask.readonly

### Add key to env variables

Next step is adding your key to environment variables using the following command:

```> export MEISTERTASK='you auth key here'```

You can also that line to .bashrc to save you time.

## How to use ?

Install using pip
```
# install
pip install meistertask-cli

# Set authentication key
export MEISTERTASK=your-key-here

# Start using
ms --help
```

For more detailed description in usage, please check the [wiki](https://github.com/ablil/meistertask-cli/wiki)

## Contribution
Building this app is very easy, if you are familiar with the basic of python3 and API.

You can even build it from scratch yourself, or just fork this project and build on top of.

There are multiple features that need to be included, feel free to contribute, in fact I would love if you take a look and give me some feedback, open some issue/pull request.

Or contact me: ablil@pm.me

## More to come
- [x] Allow user to reference project, task or section by their ids.
- [ ] Caching
- [ ] Work in an offline mode (No internet connection)