https://github.com/bhavya-dang/mstat
a modern replacement for stat with bordered table output
https://github.com/bhavya-dang/mstat
bubbletea-tui cli golang-tui modern-alternative terminal-based terminal-user-interface tui unixporn
Last synced: 23 days ago
JSON representation
a modern replacement for stat with bordered table output
- Host: GitHub
- URL: https://github.com/bhavya-dang/mstat
- Owner: bhavya-dang
- License: mit
- Created: 2026-07-09T15:27:43.000Z (30 days ago)
- Default Branch: master
- Last Pushed: 2026-07-09T17:09:21.000Z (30 days ago)
- Last Synced: 2026-07-09T19:08:21.342Z (29 days ago)
- Topics: bubbletea-tui, cli, golang-tui, modern-alternative, terminal-based, terminal-user-interface, tui, unixporn
- Language: Go
- Homepage:
- Size: 1.04 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mstat
A modern stat alternative with beautiful bordered tables
[](https://go.dev/)
[](./LICENSE)
[](https://github.com/bhavya-dang/mstat/releases)
## Installation
### Prerequisites
- [Go 1.25+](https://go.dev/)
- Any [Nerd Font](https://www.nerdfonts.com/#home) (optional, for icons)
### Using Go
```bash
go install github.com/bhavya-dang/mstat@latest
```
### Using Makefile
```bash
git clone https://github.com/bhavya-dang/mstat.git
cd mstat
make install
```
### Manual
```bash
git clone https://github.com/bhavya-dang/mstat.git
cd mstat
go build -o build/mstat ./cmd/mstat
cp build/mstat "$(go env GOPATH)/bin/mstat"
```
## Usage
```bash
mstat [file...] [flags]
```
## Flags
| Flag | Short | Description |
| ---------------- | ----- | ------------------------------------------ |
| `--brief` | `-b` | Minimal output (name, size) |
| `--extended` | `-x` | Extended output with all details |
| `--no-icons` | `-n` | Disable Nerd Font icons |
| `--simple-icons` | `-s` | Show only basic icons (folder, file, link) |
| `--version` | `-v` | Show version |
### View Modes
**Default:**
name | size | type | last modified | permissions
**Brief (-b):**
name | size | type
**Extended (-x):**
name | size | type | last modified | permissions | permissions octal | links
### Icons
By default, mstat shows language-specific icons for files (Go, Typescript, Python, etc.).
Use `--simple-icons` to show only basic icons (folder, file, link, etc.).
Use `--no-icons` to disable all icons.
### Colors
By default, directories and their icons will appear in ansi blue color. I am planning to make this configurable soon when configuration system is implemented.
This can be disabled using the `--no-colors` flag.
## Examples
```bash
mstat .
mstat go.mod main.go README.md
mstat -n LICENSE
mstat -x internal/
```
## License
MIT License
## Contributing & Issues
This is an open-source project. Feel free to contribute to existing issues or open a new one if you find anything!