Skip to content

flow workspace add

Initialize a new workspace from a local path or Git URL.

Synopsis

Initialize a new workspace. PATH_OR_GIT_URL can be a local directory path or a Git repository URL (HTTPS or SSH). When a Git URL is provided, the repository is cloned to the flow cache directory and registered as a workspace.

Examples: flow workspace add my-ws ./path/to/dir flow workspace add shared https://github.com/org/flows.git flow workspace add tools [email protected]:org/tools.git --branch main flow workspace add stable https://github.com/org/flows.git --tag v1.0.0

shell
flow workspace add NAME PATH_OR_GIT_URL [flags]

Options

FlagTypeDescription
-b, --branchstringGit branch to checkout when cloning a git workspace
--depthintGit clone depth (0 for full history)
-h, --helphelp for add
-o, --outputstringOutput format. One of: yaml, json, or tui.
-s, --setSet the newly created workspace as the current workspace
--tagstringGit tag to checkout when cloning a git workspace

Options inherited from parent commands

FlagTypeDescription
-L, --log-levelstringLog verbosity level (debug, info, fatal) (default "info")
--syncSync flow cache and workspaces

See also