Klef docs
Commands

Projects and workspaces

Create and link projects, and organize them into workspaces.

klef init

Create a new Klef project in the current directory. Writes a .klef file with the project id and default environment.

klef init my-app

The project name is optional. If you omit it, the CLI prompts for one.

Options

FlagDescription
-w, --workspace <slug>Workspace to create the project in (default: personal).
klef init my-app --workspace acme-inc

Link the current directory to an existing project. Writes a .klef file so the directory points at that project. Use this after cloning a repo that does not yet have a .klef, or to re-point a directory.

klef link my-app

klef projects list

List your projects across all workspaces.

klef projects list

Options

FlagDescription
-w, --workspace <slug>Only show projects in this workspace.
klef projects list --workspace acme-inc

klef workspace

Manage workspaces, the top level grouping of projects.

klef workspace list

Subcommands

CommandDescription
klef workspace listList your workspaces.
klef workspace create <name>Create a workspace, for example "Acme Inc".
klef workspace rename <slug> <new-name>Rename a workspace. The slug stays the same.
klef workspace delete <slug>Delete a non-personal workspace with no projects.
klef workspace create "Acme Inc"
klef workspace rename acme-inc "Acme Corporation"
klef workspace delete acme-inc

klef workspace delete asks for confirmation. Skip it with -y, --yes. A workspace must have no projects before it can be deleted, and the personal workspace cannot be deleted.

On this page