Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Find and understand files

kater files create-folder

Makes an empty folder where you can add files.

Kater keeps the empty folder with a .gitkeep file, which Files does not show, until you save something in it.

Examples

Terminal window
# Go to your brainstorm folder
cd connections/snowflake_prod_connection/users/you@example.com/brainstorm
# Make a folder named pricing
kater files create-folder pricing
# Make a folder, and the folders above it that do not exist yet
kater files create-folder campaigns/2026/q3

Arguments

ArgumentDescription
<path>The new folder, by its path from the folder you are in, or from --kater-root. Kater also makes the folders above it that do not exist yet.

Options

It also takes the global options --json, --kater-root, --scope and --help.

Where you cannot make a folder

  • In a folder that you can only read. Make it in your own folder, such as users/you@example.com/.
  • Where something has that name already.
  • In a workspaces/ folder, where a folder is a workspace. Make a workspace with kater new workspace.
  • In an apps/ folder, where a folder is an app. Make an app with kater new app.
  • Directly in users/, which holds one folder for each person.
  • In Kater’s own folders.

A folder’s name cannot hold line breaks, tabs or other control characters.

See also