KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #claude-code #mcp #rust #deepseek-harness #ai-agent #cli

dired-k

★ 84 Open GitHub ↗

Highlighting dired buffer like k

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# dired-k.el

[![melpa badge][melpa-badge]][melpa-link]
[![melpa stable badge][melpa-stable-badge]][melpa-stable-link]
[![gh actions badge][gh-actions-badge]][gh-actions-link]

`dired-k.el` highlights dired buffer like [k](https://github.com/supercrabtree/k).

(This may works only default dired setting)

## screenshot

### k.zsh style

![Screenshot of dired-k command](https://raw.githubusercontent.com/emacsorphanage/dired-k/master/image/dired-k.png)

### git status --short style

![Screenshot of dired-k with git style](https://raw.githubusercontent.com/emacsorphanage/dired-k/master/image/dired-k-style-git.png)

### direx version

![Screenshot of direx-k](https://raw.githubusercontent.com/emacsorphanage/dired-k/master/image/direx-k.png)

## Installation

`dired-k` is available on [MELPA](https://melpa.org/) and [MELPA stable](https://stable.melpa.org/)

You can install `dired-k` with the following command.

<kbd>M-x package-install [RET] dired-k [RET]</kbd>

## Commands

### `dired-k`

Highlight dired buffer by following parameters.

- File size
- Modified time
- Git status(if here is in git repository)

### `dired-k-no-revert`

Same as `dired-k`, except this command does not call `revert-buffert`.
This command can set to a hook `dired-after-readin-hook`.

## Customization

### `dired-k-style`(Default `nil`)

View like `k.zsh` if this value is `nil`. View like `git status --short` if
this value is `'git`.

### `dired-k-human-readable`(Default `nil`)

Set non-nil if you add `-h` or `--human-readable` option to `dired-listing-switches`.

### `dired-k-padding`(Default 0)

Number of spaces around git status character.

## Sample Configuration

### dired-k
```lisp
(require 'dired-k)
(define-key dired-mode-map (kbd "K") 'dired-k)

;; You can use dired-k alternative to revert-buffer
(define-key dired-mode-map (kbd "g") 'dired-k)

;; always execute dired-k when dired buffer is opened
(add-hook 'dired-initial-position-hook 'dired-k)

(add-hook 'dired-after-readin-hook #'dired-k-no-revert)
```

### direx-k
```lisp
(require 'direx-k)

(global-set-key (kbd "C-\\") 'direx-project:jump-to-project-root-other-window)
(define-key direx:direx-mode-map (kbd "K") 'direx-k)
```

[melpa-link]: https://melpa.org/#/dired-k
[melpa-stable-link]: https://stable.melpa.org/#/dired-k
[gh-actions-link]: https://github.com/emacsorphanage/dired-k/actions
[melpa-badge]: https://melpa.org/packages/dired-k-badge.svg
[melpa-stable-badge]: https://stable.melpa.org/packages/dired-k-badge.svg
[gh-actions-badge]: https://github.com/emacsorphanage/dired-k/workflows/ci-checks/badge.svg

dired-k

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README