doomemacs/modules/ui/treemacs/README.org

ui/treemacs

• Description
  • Maintainers
  • Module Flags
  • Plugins
• Prerequisites
• Features
• Configuration
• Troubleshooting

Description

This module adds the treemacs project sidebar

It is a little more powerful a little cooler than neotree

• Integration with Git (when :tools magit is enabled)
• Integration with Evil (when :editor evil +everywhere is enabled)
• Workspace awareness (when :ui workspaces is enabled)

Maintainers

• This module has no dedicated maintainers.

Module Flags

• +lsp Enable lsp-treemacs integration and add shortcuts for common commands.

Plugins

• treemacs
• treemacs-projectile

• :editor evil +everywhere

  • treemacs-evil

• :tools magit

  • treemacs-magit

• :ui workspaces

  • treemacs-persp

• +lsp

  • lsp-treemacs

Prerequisites

If +treemacs-git-mode is set to extended or deferred you will need to have python3 installed

Features

The project bar can be opened using SPC o p

Keybind	Description
o s	Open a horizontal dired buffer on the currently highlighted node
o v	Open a vertical dired buffer on the currently highlighted node

Configuration

the variable +treemacs-git-mode sets the type of git integration for treemacs

There are 3 possible values:

1. simple, which highlights only files based on their git status, and is slightly faster,
2. extended, which highlights both files and directories, but requires python,
3. deferred, same as extended, but highlights asynchronously.

the default being simple

This must be set before treemacs has loaded.

TODO Troubleshooting