> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# appz pull

> Learn how to update your local project with remote environment variables using the appz pull CLI command.

export const GlobalOptionsComponent = ({command}) => <div>
    <h2><a href="#global-options">Global Options</a></h2>
    <p>These general options can be applied when using the <code>{command}</code> command:</p>
    <ul>
    <li><code>--cwd</code></li>
    <li><code>--debug</code></li>
    <li><code>--global-config</code></li>
    <li><code>--help</code></li>
    <li><code>--local-config</code></li>
    <li><code>--no-color</code></li>
    <li><code>--scope</code></li>
    <li><code>--token</code></li>
    </ul>

    <p>For detailed information on these global options and their applications, refer to the <a href="/cli/global-options">options section</a>.</p>
    </div>;

The `appz pull` command is used to store Environment Variables and Project Settings in a local cache (under .appz/.env.\$target.local) for offline use of `appz build` and `appz dev`. If you aren't using those commands, you don't need to run `appz pull`.

When environment variables or project settings are updated on Appz, remember to use `appz pull` again to update your local environment variable and project settings values under .appz/.

To download Environment Variables to a specific file (like .env), use `appz env pull` instead.

## Usage

```bash terminal theme={null}
appz pull
```

> Using appz pull fetches the latest "development" Environment Variables and Project Settings from the cloud.

```bash terminal theme={null}
appz pull --environment=preview
```

> Using `appz pull` fetches the latest "preview" Environment Variables and Project Settings from the cloud.

```bash terminal theme={null}
appz pull --environment=preview --git-branch=feature-branch
```

> Using `appz pull` fetches the "feature-branch" Environment Variables and Project Settings from the cloud.

```bash terminal theme={null}
appz pull --environment=production
```

> Using `appz pull` fetches the latest "production" Environment Variables and Project Settings from the cloud.

## Unique Options

These options are specific to the `appz pull` command.

### Yes

```bash terminal theme={null}
appz pull --yes
```

> Using the `appz pull` command with the `--yes` option to skip questions you are asked when setting up a new Appz Project. The questions will be answered using the default scope and the current directory for the Appz Project name and location.

<GlobalOptionsComponent command={'appz pull'} />