https://github.com/elliottt/two-trucs

A command-line tool for managing todo files written in markdown
https://github.com/elliottt/two-trucs

command-line-tool markdown productivity rust todo

Last synced: 4 months ago
JSON representation

A command-line tool for managing todo files written in markdown

• Host: GitHub
• URL: https://github.com/elliottt/two-trucs
• Owner: elliottt
• License: mit
• Created: 2020-03-07T21:14:49.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-23T01:47:36.000Z (10 months ago)
• Last Synced: 2024-04-23T04:02:30.638Z (10 months ago)
• Topics: command-line-tool, markdown, productivity, rust, todo
• Language: Rust
• Size: 72.3 KB
• Stars: 3
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# two-trucs

> So, the French phrase trucs à faire means "things to do". J'ai des trucs à

> faire, "I have things to do." truc means 'thingamajig', basically.

>

> Anyway, you should call your tool `two-trucs`.

>

> -- [getty](https://twitter.com/aisamanra)

## Introduction

`two-trucs` is a tool for managing a grouped todo list written in markdown. For

example, if you have the following markdown:

```markdown

* [x] Task 1

* [x] Task 2

* [ ] Task 3

* [x] Add bugs

* [ ] Fix bugs

```

and you run `two-trucs` on it, it will re-order the list to the following:

```markdown

* [ ] Task 3

* [ ] Fix bugs

* [x] Task 1

* [x] Task 2

* [x] Add bugs

```

If you manage these lists by updating them daily, and want to archive the tasks

that were completed in the previous day, you can run `two-trucs` with the `-n`

flag, instructing it that you are beginning a new day. Given this markdown file:

```markdown

# Yesterday

## Project

* [x] Finish that thing

* [ ] Do that other thing

* [ ] Add bugs

```

Running `two-trucs -n` on the file will give you:

```markdown

# Today

## Project

* [ ] Do that other thing

* [ ] Add bugs

# Yesterday

## Project

* [x] Finish that thing

```

If you are starting a new day, you can alter the default heading of "Today" by

passing `-t "My alternate title"`.

## Vim plugin

You can use `two-trucs` with vim by using this repository as a plugin. For

[vim-plug](https://github.com/junegunn/vim-plug), just add the following to your

config:

```vim

Plug 'elliottt/two-trucs', { 'do': 'make release' }

```

The plugin comes with two commands:

* `TTSort` which will sort the todo items in place

* `TTNext` which will start a new day, using a default title of the current date