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

# Westyx CLI

> Manage secrets, configs, and feature flags from your terminal.

The `westyx` CLI is the unified command-line interface for the Westyx platform. Install it once
and use it across all your projects - on your local machine, in CI/CD pipelines, and on any
server.

> [card] [Installation](https://docs.westyx.dev/cli/installation.md)
>
> Linux, macOS, and Windows download instructions.

> [card] [Getting started](https://docs.westyx.dev/cli/getting-started.md)
>
> Log in, set up your project, and run your first command.

> [card] [Command reference](https://docs.westyx.dev/cli/reference.md)
>
> Full reference for every command and flag.

> [card] [CI/CD](https://docs.westyx.dev/cli/ci-cd.md)
>
> Use the CLI in automated pipelines with token-based auth.

## What you can do

> [accordion] Manage secrets, configs, and flags from the terminal
>
> Read and write individual values without opening the browser. Every operation supports
> `--format=json` and `--format=plain` for easy scripting.
>
> ```bash theme={null}
> westyx secret get DB_PASSWORD --service=payments --format=plain
> westyx config set LOG_LEVEL debug --service=api
> westyx flag set new_checkout true --service=payments
> ```

> [accordion] Migrate from .env files
>
> `westyx analyze` reads an existing `.env` file, classifies each entry as a secret, config,
> or feature flag, and writes a `.wx` file ready to push to Nexus.
>
> ```bash theme={null}
> westyx analyze .env
> westyx dev push
> ```

> [accordion] Run your app with injected Nexus values
>
> `westyx dev run` starts any command with all Nexus values injected as environment variables.
> Scripts and profiles are defined in `.westyx/config` and committed to git.
>
> ```bash theme={null}
> westyx dev run           # starts default script
> westyx dev run dev       # hot reload
> westyx dev run test      # run tests
> ```
>
> Falls back to cached `.wx` values when Nexus is unreachable.

> [accordion] Developer WIF - no static API keys in your local env
>
> `westyx dev setup` provisions short-lived Developer WIF credentials. The Nexus SDK in your
> app detects them automatically - no `api_key` needed in your local config.
>
> ```bash theme={null}
> westyx dev setup --service=my-api
> # start your app normally - the SDK picks up credentials automatically
> ```

## Current version

`v0.12.7` - see the [changelog](https://docs.westyx.dev/cli/changelog.md) for release notes.

| Version | Commands added |
| - | - |
| v0.1.0 | `login`, `logout`, `version`, `tenant list/set`, `project list/set` |
| v0.2.0 | `analyze`, `dev push` |
| v0.3.0 | `dev setup`, `dev pull`, `dev status`, `dev teardown` |
| v0.4.0 | `dev run` |
| v0.5.0 | `secret get/set/list`, `config get/set/list`, `flag get/set/list` |
| v0.6.0 | `upgrade`, `upgrade --check` |
| v0.7.0 | `snapshot list/create/delete/diff/restore` |
| v0.8.0 | `service list/get`, `environment list/set` |
| v0.9.0 | `service create/delete` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.