Workspace#
Command: workspace
Shorthands: w
The workspace command is a parent command that provides various operations for managing Workspace(s). This command supports subcommands like list, describe, and remove to handle different workspace-related tasks. Additionally, it includes the --switch flag to set the selected workspace among existing workspaces.
A workspace in pars is a structure that organizes projects, tasks, and workflows, providing physical isolation. Multiple workspaces can be defined, and references to these workspaces can be made where needed. For example, when adding a project, you can specify the workspace with the --workspace flag or argument: pars project new test-project-name --workspace my-workspace.
pars provides support for autocompletion, filtering, and suggestions using the tab key, making it easier to work with workspaces.
Usage#
Commands#
| Name | Description |
|---|---|
list | List Workspaces in Environment |
describe | Describe Workspace details |
remove | Remove Workspace |
Tip
You can use suggestions to list available sub commands. To do this, simply press Tab to proceed. For more details, please visit our Command Autocompletion and Filtering Guide.
Flags#
See Global flags and Common flags
| Name | Datatype | Required | Default | Description |
|---|---|---|---|---|
--switch, -s | string | true | workspace_name | Switch current workspace |
--switch#
- Aliases
-s - Datatype:
string - Type:
workspace - Multiplicity: Optional
- Description: Specifies the name of the workspace to set as selected.
Usage
- The
--switchflag is used to set an existing workspace as theselected workspace. This flag allows you to quickly change the selected workspace without needing to perform multiple steps.
Tip
You can use suggestions to list available workspaces. To do this, simply press Tab to proceed. For more details, please visit our Workspace Autocompletion and Filtering Guide.
Notes
- Ensure the workspace name provided with the
--switchflag exists to avoid errors during command execution.