/k

k is the new l, yo

Primary LanguageShell

k.rimraf.com

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

Repository git status

Git status on files within a working tree

Repository work tree git status

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

File weight colours

Rotting dates

Dates fade with age.

Rotting dates

Installation

Using Antigen

Include the bundle in your .zshrc

antigen bundle rimraf/k
antigen apply

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.