Bucket-Befehlszeilenschnittstelle
Befehlszeilenschnittstelle für die Interaktion mit Bucket-Diensten. Mit der CLI können Sie Apps, Features und Authentifizierung verwalten und TypeScript-Typen für Ihre Bucket-Features generieren. Mit diesem Tool können Sie Ihren Feature-Flagging-Workflow direkt von Ihrem Terminal aus optimieren.
Verwendung
Beginnen Sie, indem Sie die CLI lokal in Ihrem Projekt installieren:
Führen Sie dann den new
Befehl aus dem Stammverzeichnis Ihres Projekts aus, initialisieren Sie die CLI, erstellen Sie eine Funktion und generieren Sie die Typen auf einmal:
Einzelne Befehle
Anstatt new
auszuführen, können Sie jeden Schritt einzeln aufrufen.
Konfiguration
Die CLI erstellt die Datei bucket.config.json
in Ihrem Projektverzeichnis, wenn Sie bucket init
ausführen. Diese Datei enthält alle erforderlichen Einstellungen für Ihre Bucket-Integration.
Struktur der Konfigurationsdatei
Hier ist eine umfassende Liste der in der Datei bucket.config.json
verfügbaren Konfigurationsoptionen:
Option | Beschreibung | Standard |
---|---|---|
$schema | Autovervollständigung für die Konfiguration. latest kann durch eine bestimmte Version ersetzt werden. | " https://unpkg.com/@bucketco/cli@latest/schema.json " |
baseUrl | Basis-URL für Bucket-Dienste. | " https://app.bucket.co " |
apiUrl | API-URL für Bucket-Dienste (überschreibt baseUrl für API-Aufrufe). | " https://app.bucket.co/api " |
appId | Ihre Bucket-Anwendungs-ID. | Erforderlich |
typesOutput | Pfad(e), in dem/denen TypeScript-Typen generiert werden. Kann ein String oder ein Array von Objekten mit path und format sein. Verfügbare Formate: react und node . | „gen/features.ts“ mit dem Format „react“ |
Sie können diese Einstellungen mithilfe von Befehlszeilenoptionen für einzelne Befehle überschreiben.
Befehle
bucket init
Initialisieren Sie eine neue Bucket-Konfiguration in Ihrem Projekt. Dadurch wird eine Datei bucket.config.json
mit Ihren Einstellungen erstellt und Sie werden aufgefordert, alle erforderlichen Informationen einzugeben, die nicht über Optionen bereitgestellt werden.
Optionen:
--overwrite
: Vorhandene Konfigurationsdatei überschreiben, falls vorhanden.--app-id <id>
: Legen Sie die Anwendungs-ID fest.--key-format <format>
: Legen Sie das Schlüsselformat für Features fest.
bucket new [featureName]
All-in-One-Befehl für den schnellen Einstieg. Dieser Befehl kombiniert init
, Feature-Erstellung und Typgenerierung in einem einzigen Schritt. So starten Sie Bucket am schnellsten.
Optionen:
--key
: Spezifischer Schlüssel für die Funktion.--app-id
: Zu verwendende App-ID.--key-format
: Format für Funktionsschlüssel (benutzerdefiniert, Snake, Camel usw.).--out
: Pfad zum Generieren von TypeScript-Typen.--format
: Format der generierten Typen (React oder Node).
Wenn Sie mehr Kontrolle über jeden Schritt bevorzugen, können Sie stattdessen die einzelnen Befehle ( init
, features create
, features types
) verwenden.
bucket login
Melden Sie sich bei Ihrem Bucket-Konto an. Dadurch wird Ihre CLI für nachfolgende Vorgänge authentifiziert und die Anmeldeinformationen sicher gespeichert.
bucket logout
Melden Sie sich von Ihrem Bucket-Konto ab und entfernen Sie die gespeicherten Anmeldeinformationen.
bucket features
Verwalten Sie Ihre Bucket-Funktionen mit den folgenden Unterbefehlen.
bucket features create [featureName]
Erstellen Sie eine neue Funktion in Ihrer Bucket-App. Der Befehl führt Sie mit interaktiven Eingabeaufforderungen durch den Prozess der Funktionserstellung, falls keine Optionen bereitgestellt werden.
Optionen:
--key
: Spezifischer Schlüssel für die Funktion.--app-id
: Zu verwendende App-ID.--key-format
: Format für Funktionsschlüssel.
bucket features list
Listen Sie alle Funktionen der aktuellen App auf. So können Sie sich einen Überblick über die verfügbaren Funktionen und ihre aktuelle Konfiguration verschaffen.
Optionen:
--app-id
: Zu verwendende App-ID.
bucket features types
Generieren Sie TypeScript-Typen für Ihre Features. Dies gewährleistet die Typsicherheit bei der Verwendung von Bucket-Features in Ihren TypeScript-/JavaScript-Anwendungen.
Optionen:
--app-id
: Zu verwendende App-ID.--out
: Pfad zum Generieren von TypeScript-Typen.--format
: Format der generierten Typen (React oder Node).
bucket companies
Befehle zur Verwaltung von Unternehmen.
bucket companies list
Listen Sie alle Unternehmen in Ihrer App auf.
Optionen:
--filter
: Filtern Sie Unternehmen nach Name oder ID.--app-id
: Zu verwendende App-ID.
Der Befehl gibt eine Tabelle mit den folgenden Spalten aus:
id
: Firmen-ID.name
: Firmenname (wird „(unbenannt)“ angezeigt, wenn nicht festgelegt).users
: Anzahl der Benutzer im Unternehmen.lastSeen
: Datum, an dem das Unternehmen zuletzt aktiv war.
bucket companies features access
Gewähren oder entziehen Sie Unternehmen, Segmenten und Benutzern den Zugriff auf bestimmte Funktionen. Wenn kein Funktionsschlüssel angegeben ist, werden Sie aufgefordert, einen aus einer Liste auszuwählen.
Argumente:
featureKey
: Schlüssel der Funktion, für die der Zugriff gewährt/entzogen werden soll (optional, interaktive Auswahl, falls weggelassen).
Optionen:
--enable
: Aktivieren Sie die Funktion für die angegebenen Ziele.--disable
: Deaktiviert die Funktion für die angegebenen Ziele.--users
: Zielbenutzer-IDs. Kann mehrfach angegeben werden.--companies
: Zielfirmen-IDs. Kann mehrfach angegeben werden.--segments
: Zielsegment-IDs. Kann mehrfach angegeben werden.--app-id
: Zu verwendende App-ID.
Mindestens ein Ziel (Unternehmen, Segmente oder Benutzer) muss angegeben werden. Sie müssen außerdem entweder --enable
oder --disable
angeben, aber nicht beides.
Beispiel:
bucket apps
Befehle zum Verwalten von Bucket-Apps.
Globale Optionen
Diese Optionen können mit jedem Befehl verwendet werden:
--debug
: Aktiviert den Debug-Modus für ausführliche Ausgabe.--base-url <url>
: Legen Sie die Basis-URL für die Bucket-API fest.--api-url <url>
: Legen Sie die API-URL direkt fest (überschreibt die Basis-URL).--help
: Hilfeinformationen für einen Befehl anzeigen.
KI-gestützte Entwicklung
Bucket bietet leistungsstarke KI-gestützte Entwicklungsfunktionen durch Regeln und Model Context Protocol (MCP). Diese Funktionen helfen Ihren KI-Entwicklungstools, Ihre Funktionen besser zu verstehen und präzisere Unterstützung zu bieten.
Bucket-Regeln (empfohlen)
Mit dem Befehl rules
können Sie KI-spezifische Regeln für Ihr Projekt einrichten. Diese Regeln ermöglichen es KI-Tools, die Arbeit mit Buckets und Feature-Flags und deren Verwendung in Ihrer Codebasis besser zu verstehen.
Optionen:
--format
: Format zum Hinzufügen von Regeln:cursor
: Fügt Regeln zu.cursor/rules/bucket.mdc
für die Cursor-IDE-Integration hinzu.copilot
: Fügt Regeln zu.github/copilot-instructions.md
für die GitHub Copilot-Integration hinzu.
--yes
: Bestätigungsaufforderungen überspringen und vorhandene Dateien ohne Nachfrage überschreiben.
Dieser Befehl fügt Ihrem Projekt Regeln hinzu, die KI-Tools Kontextinformationen zur Einrichtung und Verwendung von Bucket-Feature-Flags liefern. Für das Copilot-Format werden die Regeln einem eigenen Abschnitt in der Datei hinzugefügt, sodass Sie neben den Bucket-Regeln auch andere Copilot-Anweisungen verwalten können.
Modellkontextprotokoll
Das Model Context Protocol (MCP) ist ein offenes Protokoll, das eine standardisierte Möglichkeit bietet, KI-Modelle mit verschiedenen Datenquellen und Tools zu verbinden. Im Kontext von Bucket ermöglicht MCP Ihrem Code-Editor, Ihre Feature-Flags, deren Zustände und deren Beziehungen innerhalb Ihrer Codebasis zu verstehen. Dies schafft eine nahtlose Verbindung zwischen Ihrem Feature-Management-Workflow und KI-gestützten Entwicklungstools. Der MCP-Server wird von Bucket gehostet, sodass der Einstieg ganz einfach ist.
**Hinweis: Der Bucket-Befehl mcp
wurde zuvor für einen lokalen Server verwendet . In neueren Versionen der Bucket-CLI wurde der Befehl mcp
jedoch umfunktioniert, um Ihnen die Verbindung zum neuen Remote-MCP-Server zu erleichtern.**_
Einrichten von MCP
Mit dem Befehl mcp
konfigurieren Sie Ihren Editor oder KI-Client für die Verbindung mit dem Remote-MCP-Server von Bucket. Dadurch können Ihre KI-Tools Ihre Feature-Flags verstehen und kontextbezogenere Unterstützung bieten.
Optionen:
--app-id
: Für die MCP-Verbindung zu verwendende App-ID.--editor
: Der zu konfigurierende Editor/Client:cursor
: Cursor-IDEvscode
: Visual Studio Codeclaude
: Claude Desktopwindsurf
: Windsurf
--scope
: Ob die Einstellungen für das Projekt global oder lokal konfiguriert werden sollen.
Der Befehl führt Sie durch:
- Auswählen, welcher Editor/Client konfiguriert werden soll.
- Auswählen, mit welcher Bucket-App eine Verbindung hergestellt werden soll.
- Entscheidung zwischen globaler oder projektlokaler Konfiguration.
- Einrichten der entsprechenden Konfigurationsdatei für Ihren gewählten Editor.
Hinweis: Das Setup verwendet mcp-remote als Kompatibilitätsebene, sodass der remote gehostete Bucket MCP-Server mit allen Editoren/Clients funktioniert, die MCP-STDIO-Server unterstützen. Wenn Ihr Editor/Client HTTP-Streaming mit OAuth unterstützt, können Sie sich direkt mit dem Bucket MCP-Server verbinden.
Entwicklung
Anforderungen
- Node.js >=18.0.0
Lizenz
MIT-Lizenz Copyright (c) 2025 Bucket ApS
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Markieren Sie Funktionen direkt aus dem Chat in Ihrem Code-Editor, einschließlich VS Code, Cursor, Windsurf, Claude Code – jede IDE mit MCP-Unterstützung.
Related MCP Servers
- AsecurityAlicenseAqualityreact-mcp integrates with Claude Desktop, enabling the creation and modification of React apps based on user promptsLast updated -919JavaScriptMIT License
- AsecurityAlicenseAqualityA template for creating custom tools for Cursor IDE using Model Context Protocol (MCP), allowing developers to extend Cursor's functionality with their own server-based tools.Last updated -112PythonMIT License
- -securityAlicense-qualitySeekChat supports MCP tool execution, enabling AI to directly control your computer and perform various tasks. Easily automate file management, data analysis, code development, and more, turning AI into a truly intelligent assistant.Last updated -18JavaScriptApache 2.0
- -securityFlicense-qualityAn MCP server that allows AI assistants to programmatically manage Unleash feature flags through natural language, enabling operations like creating, updating, and retrieving feature flags across projects.Last updated -52TypeScript