Skip to main content
DocumentationLibraryReference
On this page

Kater CLI Find and understand files

kater files

Lists, finds and organizes the files in your Kater content, as the Files page does.

It shows only what you can read. You can also make folders, and copy, move and delete the plain files that you can change.

Commands

CommandWhat it does
kater files listList one folder’s files and folders.
kater files indexList every file and folder you can read.
kater files searchFind the lines in your files that hold some text.
kater files create-folderMake an empty folder.
kater files moveRename or move a file or folder.
kater files duplicateCopy a file beside it, or into your brainstorm folder.
kater files add-toAdd a query or chart to a workspace, dashboard or app.
kater files remove-fromTake a chart or query off a dashboard or app.

Paths

Give each path from the folder you are in, or from --kater-root when you give it. Kater finds the content root, the folder that holds connections/, by walking up from that path.

Files that keep their place

Queries, charts, models, workspaces and apps keep their names and places, because other files find them by name. So do the files that Kater writes, test files and Kater’s own folders. kater files index marks each of them.

Examples

Terminal window
# List the folders and files in the ad_reporting workspace
kater files list connections/snowflake_prod_connection/workspaces/ad_reporting
# List every file and folder you can read in snowflake_prod_connection
kater files index --connection snowflake_prod_connection
# Find every line that mentions sum__spend in snowflake_prod_connection
kater files search sum__spend --connection snowflake_prod_connection

See also