Armory for VS Code

Armory is a task-oriented project navigator that keeps several focused views of your codebase visible at the same time.

Instead of repeatedly digging through one large Explorer tree, create a board of independent trees for the parts of the project involved in your current task. Each tree can have multiple roots, bringing files and folders from different parts of the project into one focused view. A file, folder, or symbol can appear wherever it is useful without changing the structure of your project.

Getting started

Open Armory using either:

• Armory: Open Board in the Command Palette;
• Ctrl+Alt+A on Windows and Linux;
• Cmd+Alt+A on macOS.

The first board is created from the folders in your current VS Code workspace. Its layout is saved with the workspace and restored when you return.

Working with trees

• Use the + button to create another tree.
• Drag a tree header to change the order of trees on the board.
• Right-click a tree header to add a folder root or close the tree.
• Right-click a file, folder, or symbol for the actions available for that item.
• Use Shift+Left and Shift+Right to move keyboard focus between trees.
• Use Ctrl+click or Cmd+click to select several items for Armory root operations.

You can also right-click files and folders in the standard VS Code Explorer and use the Armory submenu to:

• create a tree from the selection;
• add the selection to an existing tree.

Navigation and file operations

Directories and files expand lazily, and supported document symbols appear inside files. Open an item to navigate to it in the editor, or use Reveal in Explorer to locate its file.

Current status

Armory is under active development. The current version supports multi-tree navigation, files and folders, document symbols, persistent board layout, root management, and common file operations. More advanced organization and navigation features will be added incrementally.

Issues and feedback are welcome in the ArmoryVSCode repository.