Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/irevenko/tsukae

🐚📊 Show off your most used shell commands
https://github.com/irevenko/tsukae

cli command command-line command-line-tool commandline commands go golang golang-tools shell terminal terminal-based visualization

Last synced: 3 months ago
JSON representation

🐚📊 Show off your most used shell commands

Awesome Lists containing this project

README

        

# 🐚📊 tsukae - Show off your most used shell commands

> Tsukae, 使え - means use in Japanese (so it refers to commands that you use)

Built on top of termui and cobra



Big shoutout to jokerj40 for suggesting this project idea (the original thought was to parse the history file)

# Installation 🔨
```go get -u github.com/irevenko/tsukae```

```tsukae ```


AUR package

# Usage 🔬
`````` - zsh or bash or fish

### Flags 🎌
```-p, --piechart``` - use with `````` (draws only piechart widget)

```-b, --barchart``` - use with `````` (draws only barchart widget)

```-l, --list``` - use with `````` (draws only list widget)

```-s, --shell-path``` - use with `````` Manualy provide the history file path

### Draw all widgets
```tsukae ```

### Draw specific widget
```tsukae -p ```



```tsukae -b```



```tsukae -l```

### Pass certain commands number (1-15) and draw all widgets
```tsukae 10```

### Draw specific widget with certain commands number
```tsukae 10 -p ```

```tsukae 5 -b```

```tsukae 3 -l```

### Pass certain history file
```tsukae -s=$HOME/dir/hist_file```

### Ignore commands by writing the to blacklist file
When you run ```tsukae``` for the first time it creates the blacklist file in ```$HOME/.config/tsukae``` and you can prevent some commands from displaying
Example of blacklist file:

```
echo
clear
cd
```

# Contributing 🤝
Contributions, issues and feature requests are welcome! 👍

Feel free to check [open issues](https://github.com/irevenko/tsukae/issues).

# Quick Start 🚀
```git clone https://github.com/irevenko/tsukae.git```

```cd tsukae```

```go get -d ./...```

```go build```

# What I Learned 🧠
- Parsing Text Files using Go
- Drawing termui

# License 📑
(c) 2021 Ilya Revenko. [MIT License](https://tldrlegal.com/license/mit-license)