{"id":13412497,"url":"https://github.com/supercrabtree/k","last_synced_at":"2025-05-15T17:02:52.429Z","repository":{"id":14702840,"uuid":"17423038","full_name":"supercrabtree/k","owner":"supercrabtree","description":"k is the new l, yo","archived":false,"fork":false,"pushed_at":"2023-02-04T05:43:53.000Z","size":7528,"stargazers_count":1792,"open_issues_count":37,"forks_count":126,"subscribers_count":24,"default_branch":"master","last_synced_at":"2025-03-31T20:11:31.986Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supercrabtree.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-05T00:53:47.000Z","updated_at":"2025-03-29T21:11:45.000Z","dependencies_parsed_at":"2023-02-18T14:00:39.679Z","dependency_job_id":null,"html_url":"https://github.com/supercrabtree/k","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supercrabtree%2Fk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supercrabtree%2Fk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supercrabtree%2Fk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supercrabtree%2Fk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supercrabtree","download_url":"https://codeload.github.com/supercrabtree/k/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247730069,"owners_count":20986404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T20:01:25.369Z","updated_at":"2025-04-07T21:16:07.867Z","avatar_url":"https://github.com/supercrabtree.png","language":"Shell","readme":"[![k.supercrabtree.com](https://raw.githubusercontent.com/supercrabtree/k/gh-pages/k-logo.png)](http://k.supercrabtree.com)\n\n\u003e k is the new l, yo\n\n## Directory listings for zsh with git features\n\n**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.\n\n### Git status on entire repos\n![Repository git status](https://raw.githubusercontent.com/supercrabtree/k/gh-pages/repo-dirs.jpg)\n\n\n### Git status on files within a working tree\n![Repository work tree git status](https://raw.githubusercontent.com/supercrabtree/k/gh-pages/inside-work-tree.jpg)\n\n### File weight colours\nFiles sizes are graded from green for small (\u003c 1k), to red for huge (\u003e 1mb).\n\n**Human readable files sizes**  \nHuman 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](http://brew.sh):\n\n```\nbrew install coreutils\n```\n\n![File weight colours](https://raw.githubusercontent.com/supercrabtree/k/gh-pages/file-size-colors.jpg)\n\n\n### Rotting dates\nDates fade with age.  \n\n![Rotting dates](https://raw.githubusercontent.com/supercrabtree/k/gh-pages/dates.jpg)\n\n\n## Installation\n\n### Using [zplug](https://github.com/b4b4r07/zplug)\nLoad k as a plugin in your `.zshrc`\n\n```shell\nzplug \"supercrabtree/k\"\n\n```\n### Using [zgen](https://github.com/tarjoilija/zgen)\n\nInclude the load command in your `.zshrc`\n\n```shell\nzgen load supercrabtree/k\nzgen save\n```\n\n### Using [Antigen](https://github.com/zsh-users/antigen)\n\nBundle k in your `.zshrc`\n\n```shell\nantigen bundle supercrabtree/k\nantigen apply\n```\n\n### As an [Oh My ZSH!](https://github.com/robbyrussell/oh-my-zsh) custom plugin\n\nClone k into your custom plugins repo\n\n```shell\ngit clone https://github.com/supercrabtree/k $ZSH_CUSTOM/plugins/k\n```\nThen load as a plugin in your `.zshrc`\n\n```shell\nplugins+=(k)\n```\n\n### Manually\nClone this repository somewhere (~/k for example)\n\n```shell\ngit clone git@github.com:supercrabtree/k.git $HOME/k\n```\nSource the script\n\n```shell\nsource $HOME/k/k.sh\n```\nPut the same line in your `.zshrc` to have `k` available whenever you start a shell. If you don't know what your `.zshrc` is, just do this.\n\n```shell\nprint \"source $HOME/k/k.sh\" \u003e\u003e $HOME/.zshrc\n```\n\n## Usage\nHit k in your shell\n\n```shell\nk\n```\n# 😮\n\n## Minimum Requirements\nzsh 4.3.11  \nGit 1.7.2\n\n## Contributors\n[supercrabtree](https://github.com/supercrabtree)  \n[chrstphrknwtn](https://github.com/chrstphrknwtn)  \n[zirrostig](https://github.com/zirrostig)  \n[lejeunerenard](https://github.com/lejeunerenard)  \n[jozefizso](https://github.com/jozefizso)  \n[unixorn](https://github.com/unixorn)  \n[george-b](https://github.com/george-b)  \n[philpennock](https://github.com/philpennock)  \n[hoelzro](https://github.com/hoelzro)  \n[srijanshetty](https://github.com/srijanshetty)  \n[zblach](https://github.com/zblach)  \n[mattboll](https://github.com/mattboll)  \nPull requests welcome :smile:  \n\n## Thanks\n[Paul Falstad](http://www.falstad.com/) for zsh   \n[Sindre Sorhus](https://github.com/sindresorhus) for the fast git commands from zsh pure theme  \n[Rupa](https://github.com/rupa/z) for that slammin' strapline  \n\nCopyright © 2015 George Crabtree \u0026 Christopher Newton. MIT License.\n","funding_links":[],"categories":["Shell","Command-Line Productivity","Plugins","others","Tools and Plugins"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)","Windows"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupercrabtree%2Fk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupercrabtree%2Fk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupercrabtree%2Fk/lists"}