# faros use

Switch the active organization and workspace

Source: https://faros.sh/docs/reference/cli/commands/use/

<!-- Generated by scripts/sync-cli-docs.py from faroshq/faros docs/cli. Do not edit by hand; run `make sync-cli-docs`. -->

## Synopsis

Switch the kubeconfig "faros" context between the organizations and
workspaces you belong to.

With no flags it opens an interactive picker — first an organization, then a
workspace within it. Pass --org and/or --workspace (display name or UUID) to
skip the picker, e.g. for scripts:

```bash
faros use                                  # fully interactive
faros use --org acme                       # pick a workspace in "acme"
faros use --org acme --workspace platform  # non-interactive
```

```bash
faros use [flags]
```

## Options

```text
  -h, --help               help for use
      --org string         Organization display name or UUID (skips the org picker)
      --workspace string   Workspace display name or UUID (skips the workspace picker)
```

## Inherited options

```text
      --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
      --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)
```

## See also

- [faros](https://faros.sh/docs/reference/cli/commands/) — faros: an open-source control plane for platform teams