files: protocol

To access file system folders and files

Returns an FileTree representation of the current directory or (if dirname is supplied) subdirectory named dirname within the current directory.

Because the Origami language recognizes many types of file paths, you won’t often need to explicitly invoke the files command.

For example, suppose the current folder contains a subfolder called misc. To display the contents of that folder in the terminal, you could write:

$ ori files:misc

But you can also write:

$ ori ./misc

or just

$ ori misc

One situation where invoking files is often necessary is specifying the target of a copy operation as a folder that does not yet exist.