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

https://github.com/smuchok/smart-logger

ZSH logger with command output, errors & metadata / Логування команд з виводом і помилками
https://github.com/smuchok/smart-logger

automation bash cli devtools linux-tools logging shell terminal-logger zsh

Last synced: 11 months ago
JSON representation

ZSH logger with command output, errors & metadata / Логування команд з виводом і помилками

Awesome Lists containing this project

README

          

# 🧠 Smart Logger for ZSH

Простий, зручний і читабельний логер для `zsh`, який автоматично записує виконані команди у структуровані лог-файли, згруповані по датах.

---

## 🚀 Можливості

- Автоматично створює папки з логами по датах: `my_logs/YYYY-MM-DD/`
- Створює окремий `.log`-файл на кожну сесію
- Логує:
- час виконання
- директорію
- команду
- вивід (stdout + stderr)
- Команда `logs` відкриває сьогоднішню теку з логами
- Команда `logss` відкриває всі логи
- Повертає назад у директорію після перегляду логів

---

## 📦 Встановлення

1. Скопіюй файл [`smart-logger.zsh`](./smart-logger.zsh) у зручне місце, наприклад:

```bash
mkdir -p ~/smart-logger
cp smart-logger.zsh ~/smart-logger/
```

2. Додай у свій `~/.zshrc`:

```zsh
source ~/smart-logger/smart-logger.zsh
```

3. Перезавантаж shell:

```bash
source ~/.zshrc
```

---

## 🧪 Використання

### 🔹 Логувати команду:

```bash
runlog python script.py
```

або

```bash
logrun ls -la
```

У лог буде записано:

```
[18:33:10] ➜ /home/user/projects $ ls -la
(вивід команди)
```

---

### 🔹 Подивитися сьогоднішні логи:

```bash
logs
```

### 🔹 Подивитися всі логи:

```bash
logss
```

---

## 📁 Приклад структури логів

```
my_logs/
└── 2025-03-27/
├── my_log_10-12-34.log
└── my_log_17-44-02.log
```

---

## 🤝 Авторство

Створено вручну й з душею: **Taras + ChatGPT**
Спільна розробка, 100% shell-натхнення 🐚