Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Auto-complete paths and filenames from the filesystem, à la Ctrl-X,Ctrl-F in VIM
branch: master
Failed to load latest commit information.
messages Update messages
testing Move test files and update sublime-* files
.gitignore Ignore compiled python
Default (Linux).sublime-keymap
Default (OSX).sublime-keymap ADD Default keymap files
Default (Windows).sublime-keymap
FilesystemAutocompletion.sublime-commands Move test files and update sublime-* files
FilesystemAutocompletion.sublime-settings Add Settings file
LICENSE.txt Initial commit
Main.sublime-menu Add Settings file Update package for Package Installer USE add_slash setting Fixed problems with missing method and wrong view_path addition.
messages.json Update messages
test.txt Fixed problems with missing method and wrong view_path addition.

FileSystem AutoCompletion

Enable auto-completion of paths from the file system à la VIM.

Depending on the path, the file completion can be trigged automatically using the default Ctrl-Space auto-completion or it can be explicitly triggered by Ctrl+Alt+/ (on OSX, Command instead of control) shortcut.

This combination can be always rebound to a different key combination in usual SublimeText manner, by opening the User keybindings file (see menu: Preferences/Package Settings/FileSystem Autocompletion).

This plugin handles spaces in file names and find the correct file path beginning. If you find any problem, please open an issue.


Either by using the package manager or manually by cloning/downloading the latest snapshot of the master branch into the Sublime's package folder (e.g. ~/Library/Application Support/Sublime Text 2/Packages/ on OSX).

Default auto-completion

If the path has a root, this means it starts with ./, ~/, / (or C:\ (C:/ on win32) the auto completion will be triggered automatically using the regular auto-complete command.

Triggered file auto-completion

For relative paths, the file path auto-completion can be triggered by hitting Ctrl-x, Ctrl-f. This is because we do not want to collide with the other auto-completion.


This plugin should handle file paths that contains spaces including escaped spaces with \.

For example if there are three files:

quick test
quick test 1
quick test 2

Then quick test followed by Ctrl-x, Ctrl-f will display all three options and when selecting the second one for instance it will get expanded to quick test 1. On the other hand quick\ test followed by Ctrl-x, Ctrl-f with the same selection will be expanded to quick\ test\ 1. If the path is detected to be escaped it will continue to escape all the followed spaces.

File path beginning

The problem is that a file name can be contain many special characters. For example \input{some file} is a valid file. However, it is also a way how to include a file in LaTeX document and more likely we want to have a completion of the path some file rather than path \input{some file}. This plugin, therefore, tries to determine the beginning of a path from which it should look for the completion by finding the longest possible path that exists. For the example above, with the cursor positioned at the end of some file, it will try:

/Users/user/\input{some file
Users/user/\input{some file
krikava/\input{some file
\input{some file
input{some file
some file

and it will stop as soon as any of these path exists (a glob pattern with appended * returns something).


All parts of this plugin are licensed under GPL v3 (see LICENSE.txt).

Something went wrong with that request. Please try again.