mayhem - GitLite

KO | EN

gitlite — search

#python #react #go #machine-learning #rust #deep-learning #docker #windows #awesome #cli #awesome-list #mcp #openai #open-source

mayhem

(★ 99)

A minimal TUI based task tracker 📝

File Explorer

Download Latest Version (.zip)

- - go.yml
- entity.go
- recur_task.go
- stack.go
- step.go
- task.go
- Editing.gif
- Navigation.gif
- keys.go
- main_model.go
- messages.go
- model_calendar.go
- model_delete_confirmation.go
- model_details_box.go
- model_help.go
- model_input_form.go
- model_list_selector.go
- model_steps_editor.go
- model_text_area.go
- model_text_input.go
- model_time_picker.go
- styles.go
- table_utils.go
.gitignore
go.mod
go.sum
LICENSE
main.go
README.md

# Installation Guide

1. Get the code

git clone https://github.com/BOTbkcd/mayhem

Downloads the entire project code from GitHub to your computer.

cd mayhem

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Go Go is required to use go install.

go install github.com/BOTbkcd/mayhem@latest

Downloads and installs the specified version directly — no need to clone the repo yourself.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Go

Medium

Prerequisites

Git Needed to download the project code from GitHub.
Go The Go compiler and toolchain.

go install github.com/BOTbkcd/mayhem@latest

Downloads and installs the specified version directly — no need to clone the repo yourself.

✅ If the build finishes without errors, it worked. If you used go run ., check the terminal output.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Mayhem 📝

A minimal TUI based task tracker

<a href="./altscreen-toggle/main.go">
  <img src="gifs/Navigation.gif"/>
</a>

<br></br>

<a href="./altscreen-toggle/main.go">
  <img src="gifs/Editing.gif"/>
</a>

## Installation

- You can download a pre-compiled binary for your system for the [latest release](https://github.com/BOTbkcd/mayhem/releases/latest)
- Or if you have go installed on your system you can use the following command to install this package:

```
go install github.com/BOTbkcd/mayhem@latest
```

*SQLite is a dependency for this tool, make sure it is installed beforehand (it is fairly ubiquitous & should already be present on your system).*

## Features

- Three pane responsive layout, auto adjusts when terminal is resized

- Vim key bindings for navigation

- Tasks:

- Completion Status:
    - Tasks can be marked finished/unfinished using `Tab` key
    - Each stack has a label which denotes the number of unfinished tasks in that stack
  - A task can be broken down into associated *<u>steps</u>* 
    - Individual steps can be marked as finished as progress is made

- Task can be moved to a new stack after creation without any loss of data
    
  - Recurring tasks:
    - A recurring task will begin from the specified start time & repeat after the recurrence interval until the deadline is reached
    - A recurring task can only be temporarily marked as finished. It will resurface after the recurrence interval.
    - The deadline can be extended as per requirement
    - They are marked in task table using `📌` icon

- Sorting:

- Stacks are sorted alphabetically by default
  - Tasks are sorted by completion status, then deadline, then priority & then by title
    - Unscheduled tasks have less precedence than scheduled tasks

- Pane Footer: each pane has a footer which your relative position in the pane

- Dynamic help section at the bottom shows the relevant key bindings available at a given instance

## Navigation

| Key                   | Description                        |
| --------------------- | ---------------------------------- |
| <kbd>k or up</kbd>    | Move up                            |
| <kbd>j or down</kbd>  | Move down                          |
| <kbd>l or right</kbd> | Switch focus to the pane on right  |
| <kbd>h or left</kbd>  | Switch focus to the pane on left   |
| <kbd>g</kbd>          | Jump to top of the pane            |
| <kbd>G</kbd>          | Jump to bottom of the pane         |
| <kbd>e</kbd>          | Edit                               |
| <kbd>tab</kbd>        | Toggle task/step completion status |
| <kbd>esc</kbd>        | Return                             |
| <kbd>m</kbd>          | Move task to new stack             |
| <kbd>?</kbd>          | Toggle Help                        |
| <kbd>q</kbd> / <kbd>ctrl+c</kbd>          | Quit                               |