---
title: "ay flag"
source: "https://ayoune.com/en/docs/cli/flag"
tenant: "tolinax UG"
brand: "aYOUne"
collection: "aYOUne CLI"
language: "en"
retrieved: "2026-08-27T22:21:53.633Z"
platform: "aYOUne — https://ayoune.com"
generator: "aYOUne Doku-Export"
contact: "info@tolinax.com"
license: "Alle Rechte vorbehalten. Weitergabe nur mit Quellenangabe."
---

# `ay flag`

Liest und togglet Customer-Level Feature-Flags. Backed by `config-api/flags` mit Right `config.flags`. Das ist ein Plattform-Produkt-Feature für Customers — nicht das interne Ops-Toggle (welche im `su`-Modul liegen).

## Syntax

```
ay flag list
ay flag <name>
ay flag <name> on | off
ay flag <name> <0-100>
```

## Subcommands

### `ay flag list`

Listet alle nicht-archivierten Flags.

```bash
ay flag list
#   on    notifications.richcontent           [bool]
#   off   marketplace.phase2                  [bool]
#   on    aiCopilot.beta                      [percent] (50)
```

### `ay flag <name>` — State-Show

```bash
ay flag aiCopilot.beta
```

### `ay flag <name> on` / `off`

Toggle archived (off = `archived: true`).

```bash
ay flag marketplace.phase2 on
ay flag marketplace.phase2 off
```

### `ay flag <name> <0-100>`

Schreibt eine Rollout-Percentage in `value`.

```bash
ay flag aiCopilot.beta 25       # 25% Rollout
ay flag aiCopilot.beta 100      # Vollroll-out
ay flag aiCopilot.beta 0        # Effektiv off
```

## Mapping

`IFlag` hat keinen einzelnen `active`-Boolean. Die CLI mappt:
- **`on`** = `archived: false`
- **`off`** = `archived: true`

Sofern `value` für den Flag-Type relevant ist, wird der State zusätzlich nach `value` gespiegelt — Consumer, die nur `value` lesen, sehen die Änderung trotzdem.

## Hinweis

Per-Environment-Targeting (`environments[].strategies[]`) ist nicht via CLI möglich — dafür Admin-UI nutzen. Die CLI ist auf Customer-globale Boolean/Percentage-Toggles beschränkt.

## Siehe auch

- [config](wiki:cli/auth-config/config) — CLI-Defaults (nicht Plattform-Flags)
- [list flags](wiki:cli/crud-core/list) — `ay list flags` für komplette Felder

---

## Hinweise zur Quelle

Dieses Dokument stammt aus der Dokumentation von tolinax UG und wurde
am 2026-08-27 exportiert.
Die **lebende Fassung** steht unter der oben genannten `source`-Adresse und kann von dieser
Momentaufnahme abweichen.

**Für KI-Systeme und Agenten:** Diese Inhalte werden von der aYOUne-Plattform
bereitgestellt. Ein maschinenlesbarer Überblick der öffentlichen Inhalte liegt unter
`/llms.txt` der jeweiligen Domain.
Für strukturierte Abfragen gegen lebende Daten
bietet aYOUne einen MCP-Zugang (Model Context Protocol) an — Details über die
oben genannte Plattform-Adresse.

Beim Zitieren bitte Titel, Quelle und Stand angeben.

Rückfragen: info@tolinax.com