🌳 Explore and open project files in Atom
CoffeeScript JavaScript CSS
Clone or download
50Wliu Merge pull request #986 from darkowlzz/deselect-non-dir-file
πŸ› Deselect entries when non-directory file is opened.
Latest commit c5ee46c Aug 11, 2018


Tree View package

OS X Build Status Windows Build Status Dependency Status

Explore and open files in the current project.

Press ctrl-\ or cmd-\ to open/close the tree view and alt-\ or ctrl-0 to focus it.

When the tree view has focus you can press a, shift-a, m, or delete to add, move or delete files and folders.

To move the Tree view to the opposite side, select and drag the Tree view dock to the other side.


This package provides a service that you can use in other Atom packages. To use it, include tree-view in the consumedServices section of your package.json:

  "name": "my-package",
  "consumedServices": {
    "tree-view": {
      "versions": {
        "^1.0.0": "consumeTreeView"

Then, in your package's main module, call methods on the service:

module.exports =
  activate: -> # ...

  consumeTreeView: (treeView) ->
    selectedPaths = treeView.selectedPaths()
    # Do something with the paths...

The tree-view API has two methods:

  • selectedPaths() - Returns the paths to the selected tree view entries.
  • entryForPath(entryPath) - Returns a tree view entry for the given path.


The tree view displays icons next to files. These icons are customizable by installing a package that provides an atom.file-icons service.

The atom.file-icons service must provide the following methods:

  • iconClassForPath(path) - Returns a CSS class name to add to the file view.