k is the new l, yo

Directory listings for zsh with git features

k is a zsh script / plugin to make directory listings more readable, adding a bit of color and some git status information on files and directories.

Git status on entire repos

Git status on files within a working tree

File weight colours

Files sizes are graded from green for small (< 1k), to red for huge (> 1mb).

Human readable files sizes
Human readable files sizes can be shown by using the -h flag, which requires the numfmt command to be available. OS X / Darwin does not have a numfmt command by default, so GNU coreutils needs to be installed, which provides gnumfmt that k will also use if available. GNU coreutils can be installed on OS X with homebrew:

brew install coreutils

Rotting dates

Dates fade with age.

Installation

Using Antigen

Include the bundle in your .zshrc

antigen bundle rimraf/k
antigen apply

Using zgen

Include the load command in your .zshrc

zgen load rimraf/k
zgen save

Manually

Put k.sh somewhere, and source it in your .zshrc.

source ~/path-to/k/k.sh

Usage

Hit k in your shell

k

Minimum Requirements

zsh 4.3.11
Git 1.7.2

Contributers

Pull requests welcome.
supercrabtree 56
chrstphrknwtn 44
zirrostig 19
lejeunerenard 2
george-b 1
pixcrabtree 1
jozefizso 1
philpennock 1
hoelzro 1
srijanshetty 1
mattboll 1

We'd like to make this POSIX compliant so that it can be used with bash and other shells. But don't really know anything about shell scripting, so if you think you could help that would be coooool :)

Thanks

Paul Falstad for zsh
Robby Russell for making the shell fun with oh my zsh
Sindre Sorhus for fast git commands from zsh pure theme
Rupa for that slammin' strapline

Copyright © 2015 George Crabtree & Christopher Newton. MIT License.