Phials documentation
Developer docs
AI Disclosure: This page was generated by an LLM and may contain inaccuracies. Hand-crafted documentation will be implemented over time on the road to 1.0

Built-in command reference

This reference lists the user-facing commands that ship with Phials. It does not include developer commands or commands added by community plugins.

Most available commands can be found by opening the Command Bar. A command may be hidden or disabled until its required tab, folder, file, or selection is active. The Principal surface column names another place where a command normally appears; it is not an exhaustive list.

Application and window

CommandPurposeAvailabilityPrincipal surface
Open Command BarSearch for and run available commands.Any Phials window.Keyboard shortcut
HelpOpen Phials help.Any Phials window.Keyboard shortcut
SettingsOpen the Settings window.Any Phials window.Keyboard shortcut
Toggle Hidden FilesShow or hide filesystem items whose names begin with a period.Any Explorer tab.Command Bar
Toggle Parent DirectoryShow or hide the .. entry in folder listings.Any Explorer tab.Command Bar
Toggle Left PanelShow or hide the Navigator dock.Any main window.Keyboard shortcut
Toggle Right PanelShow or hide the File dock.Any main window.Keyboard shortcut
Toggle Bottom PanelShow or hide the bottom dock; opening an empty bottom dock also opens Terminal.Any main window.Keyboard shortcut
Zoom InIncrease the scale of the entire Phials interface.Any Phials window.Keyboard shortcut
Zoom OutDecrease the scale of the entire Phials interface.Any Phials window.Keyboard shortcut
Reset ZoomReturn the interface to 100% scale.Any Phials window.Keyboard shortcut
Refresh DOMReload the current Phials window.Any Phials window.Command Bar
Open config.tomlOpen the hand-editable preferences file in the default editor.Any Phials window.Command Bar
Reveal Phials home folderReveal the active Phials data folder in Finder, File Explorer, or the Linux file manager.Any Phials window.Command Bar

Tabs and tab groups

CommandPurposeAvailabilityPrincipal surface
New TabOpen a new Explorer tab.Any main window.Keyboard shortcut
Close TabClose the active tab.When a tab is active.Keyboard shortcut
Next TabSwitch to the next tab in the active tab group, wrapping at the end.A tab group with at least two tabs.Keyboard shortcut
Previous TabSwitch to the previous tab in the active tab group, wrapping at the beginning.A tab group with at least two tabs.Keyboard shortcut
Duplicate TabDuplicate the active tab and its current state.When a tab is active.Command Bar
Move to New Group → LeftSplit the current Layout to the left and move the active tab into the new tab group.A movable tab and enough room to split left.Command Bar
Move to New Group → RightSplit the current Layout to the right and move the active tab into the new tab group.A movable tab and enough room to split right.Command Bar
Move to New Group → AboveSplit the current Layout above and move the active tab into the new tab group.A movable tab and enough room to split above.Command Bar
Move to New Group → BelowSplit the current Layout below and move the active tab into the new tab group.A movable tab and enough room to split below.Command Bar
Switch to Tab 1Switch to the first tab in the active tab group.When the first tab exists.Keyboard shortcut
Switch to Tab 2Switch to the second tab in the active tab group.When the second tab exists.Keyboard shortcut
Switch to Tab 3Switch to the third tab in the active tab group.When the third tab exists.Keyboard shortcut
Switch to Tab 4Switch to the fourth tab in the active tab group.When the fourth tab exists.Keyboard shortcut
Switch to Tab 5Switch to the fifth tab in the active tab group.When the fifth tab exists.Keyboard shortcut
Switch to Tab 6Switch to the sixth tab in the active tab group.When the sixth tab exists.Keyboard shortcut
Switch to Tab 7Switch to the seventh tab in the active tab group.When the seventh tab exists.Keyboard shortcut
Switch to Tab 8Switch to the eighth tab in the active tab group.When the eighth tab exists.Keyboard shortcut
Switch to Tab 9Switch to the ninth tab in the active tab group.When the ninth tab exists.Keyboard shortcut
CommandPurposeAvailabilityPrincipal surface
Go BackReturn to the previous folder in the active Explorer pane’s history.After navigating away from a folder.Path Bar
Go ForwardMove to the next folder in the active Explorer pane’s history.After going back.Path Bar
Go UpOpen the current folder’s parent.When the current folder has a parent.Path Bar
RefreshRescan the current folder.When an Explorer pane has a current folder.Path Bar
Go to HomeOpen the operating-system home folder.Any Explorer tab.Command Bar
Go to Path…Reserved for navigating directly to a path. The current build registers this command and shortcut but does not yet open path entry.Not currently functional.Command Bar
SearchOpen or close the search controls in the Path Bar.Any Explorer tab.Path Bar
Focus searchClear the current search and put keyboard focus in the search field.Any Explorer tab.Keyboard shortcut

Selection and clipboard

CommandPurposeAvailabilityPrincipal surface
Select AllSelect every selectable item in the current file view; the .. entry is excluded.An active Explorer tab with listed items.File context menu
CutMark the selected files and folders to be moved on paste.One or more selected items other than ...File context menu, Path Bar
CopyMark the selected files and folders to be duplicated on paste.One or more selected items other than ...File context menu, Path Bar
PasteMove or copy the clipboard items into a selected folder, or into the current folder when no folder is selected.After using Cut, Copy, or Copy as symlink in Phials.File context menu, Path Bar
Copy as symlinkPrepare symbolic links to the selected files and folders for creation on paste.One or more selected items other than ...File context menu
Copy pathCopy one selected item’s full path as text.One selected item.File context menu
Copy PathsCopy the selected items’ full paths as newline-separated text.Multiple selected items other than ...File context menu

Files, folders, and archives

CommandPurposeAvailabilityPrincipal surface
OpenOpen the selected file with its operating-system default application.One selected file.File context menu
Open in…Choose another installed application for the selected file.One selected file; Phials reports when no other application is available.Command Bar, file context menu
Open in Finder / Open in File Explorer / Open in File ManagerReveal the selected item in the platform’s file manager. The label follows the operating system.One selected item other than ...File context menu
RenameRename the selected file or folder.One selected item other than ...File context menu
Move to TrashMove one or more selected items to the operating-system trash after confirmation.One or more selected items other than ...File context menu
Pin to FavoritesAdd a shortcut to the selected file or folder in Favorites.One selected item that is not already a favorite.File context menu
Unpin from FavoritesRemove the selected item’s shortcut from Favorites without changing the item on disk.One selected item that is already a favorite.File context menu
Expand ArchiveExtract a supported ZIP, TAR, GZ, TGZ, or 7Z archive into its containing folder.One selected supported archive.File context menu
CompressCreate a ZIP, TAR.GZ, or 7Z archive from the selected items.One or more selected items other than ...File context menu
Flatten Directory / Flatten DirectoriesMove each selected folder’s contents into its parent, then remove the empty folder.One selected folder, or at least two selected folders, excluding ...File context menu under Folder Utilities

Create files and folder tools

The New group in the Path Bar and Command Bar contains the following commands.

CommandPurposeAvailabilityPrincipal surface
FolderCreate a folder in the current location.An Explorer pane with a current folder.New group
Markdown FileCreate a Markdown file, open its file tab, and focus the editor.An Explorer pane with a current folder.New group
Spreadsheet (CSV)Create a CSV file in the current folder.An Explorer pane with a current folder.New group
Create Workspace FolderTurn the current folder, or a selected ordinary folder, into a Workspace Folder.A current folder or one selected folder that is not already a Workspace Folder.New group, file context menu
New saved viewSave the current view settings under a name for this folder.An Explorer pane with a current folder.New group

The Add Property group contains these property-type commands:

CommandPurposeAvailability
TextAdd a single-line text property.A current folder; Phials offers to make it a Workspace Folder if needed.
SelectAdd a single-choice option property.A current folder.
Multi-selectAdd a multiple-choice option property.A current folder.
TagsAdd the shared Tags property.A current folder without an existing Tags property.
StatusAdd a workflow status property.A current folder.
RatingAdd a 1–5 star Rating property.A current folder without an existing Rating property.
URLAdd a clickable URL property.A current folder.
DateAdd a date property with optional time or range values.A current folder.
NumberAdd a numeric property.A current folder.
CheckboxAdd a yes-or-no checkbox property.A current folder.
RelationAdd a property that connects files to another Workspace Folder.A current folder.
RollupAdd a property that summarizes values through a Relation.A current folder with at least one Relation property.

File views

The View Mode group in the Path Bar and Command Bar contains one command for each registered file view.

CommandPurposeAvailabilityPrincipal surface
Details ViewShow files as rows with configurable columns.Any Explorer tab.View Mode group
Thumbnails ViewShow files as thumbnail cards. This is called Grid view elsewhere in the user documentation.Any Explorer tab.View Mode group
Column ViewBrowse a folder branch across adjacent columns. This is called Columns view elsewhere in the user documentation.Any Explorer tab.View Mode group
Boards ViewGroup files into cards and columns by an option-backed property.A Workspace Folder with properties.View Mode group
Gallery ViewShow large previews in a gallery layout.Any Explorer tab.View Mode group
Calendar ViewPlace files on a calendar using filesystem dates or date properties.Any Explorer tab.View Mode group
FilterOpen or close the filter controls.Any Explorer tab.Path Bar
SortOpen or close the sort controls.Any Explorer tab.Path Bar
Configure viewOpen or close settings for the active file view.An Explorer tab that is not acting as a file picker.Path Bar

Workspaces and Pages

CommandPurposeAvailabilityPrincipal surface
Create Workspace FolderTurn the current or selected folder into a Workspace Folder.A current folder or one selected ordinary folder.New group, file context menu
Refresh WorkspacesKeep registered local Workspace Folders and rescan the home folder for portable ones.Any Explorer tab.Command Bar
Open PageOpen the selected eligible file’s Page.One selected file in a Workspace Folder.File context menu
Add PropertyOpen the property-type choices listed above.An Explorer pane with a current folder.New group

Network folders

CommandPurposeAvailabilityPrincipal surface
Connect to ServerMount an SMB network share.macOS and Windows only.Command Bar

For factory bindings, see Default keyboard shortcuts. To choose different bindings or change command placement, see Customize commands and shortcuts.