CLI
Options et commandes de l'interface en ligne de commande Dropstone.
L'interface en ligne de commande Dropstone démarre par défaut une session interactive lorsqu'elle est exécutée sans aucun argument.
dropstone
Mais elle accepte également des commandes comme documenté sur cette page. Cela vous permet d'interagir avec Dropstone de manière programmatique.
dropstone run "Expliquez comment fonctionnent les fermetures en JavaScript"
tui
Démarrez une session interactive Dropstone. C'est le comportement par défaut lorsque vous exécutez dropstone sans sous-commande ; dropstone tui est la forme explicite.
dropstone [project]
Flags
| Flag | Short | Description |
|---|---|---|
--continue | -c | Continuer la dernière session |
--session | -s | ID de session à continuer |
--fork | Forker la session lors de la continuation (à utiliser avec --continue ou --session) | |
--prompt | Invite à utiliser | |
--model | -m | Modèle à utiliser (dropstone/dropstone-fast, dropstone/dropstone-pro, ou dropstone/dropstone-heavy) |
--agent | Agent à utiliser | |
--port | Port d'écoute | |
--hostname | Nom d'hôte d'écoute | |
--mdns | Activer la découverte mDNS | |
--mdns-domain | Nom de domaine mDNS personnalisé | |
--cors | Origine(s) de navigateur supplémentaire(s) pour autoriser CORS |
Commandes
L'interface en ligne de commande Dropstone dispose également des commandes suivantes.
agent
Gérer les agents pour Dropstone.
dropstone agent [command]
create
Créer un nouvel agent avec une configuration personnalisée.
dropstone agent create
Cette commande vous guidera dans la création d'un nouvel agent avec une invite système personnalisée et une configuration des permissions. Tout ce que vous n'autorisez pas est refusé dans le frontmatter de l'agent généré.
Flags
| Flag | Short | Description |
|---|---|---|
--path | Répertoire où écrire le fichier de l'agent (par défaut global ou .dropstone/agent selon l'invite) | |
--description | Ce que l'agent doit faire | |
--mode | Mode de l'agent : all, primary, ou subagent | |
--permissions | Liste de permissions séparées par des virgules à autoriser (par défaut : toutes). Disponibles : bash, read, edit, glob, grep, webfetch, task, todowrite, websearch, lsp, skill. Tout ce qui est omis est refusé. Alias : --tools | |
--model | -m | Modèle à utiliser (dropstone/dropstone-fast, dropstone/dropstone-pro, ou dropstone/dropstone-heavy) |
Passer tous les arguments --path, --description, --mode, et --permissions exécute la commande de manière non interactive.
list
Lister tous les agents disponibles.
dropstone agent list
attach
Attacher un terminal à un serveur backend Dropstone déjà en cours d'exécution, démarré via les commandes serve ou web.
dropstone attach [url]
Cela vous permet de pointer une session interactive vers un serveur Dropstone exécuté sur une autre machine. Par exemple :
# Sur la machine hôte, démarrez le serveur
dropstone web --port 4096 --hostname 0.0.0.0
# Sur une autre machine, attachez une session à celui-ci
dropstone attach http://10.20.30.40:4096
Flags
| Flag | Short | Description |
|---|---|---|
--dir | Répertoire de travail pour démarrer la session | |
--continue | -c | Continuer la dernière session |
--session | -s | ID de session à continuer |
--fork | Forker la session lors de la continuation (à utiliser avec --continue ou --session) | |
--password | -p | Mot de passe d'authentification de base (par défaut DROPSTONE_SERVER_PASSWORD) |
--username | -u | Nom d'utilisateur d'authentification de base (par défaut DROPSTONE_SERVER_USERNAME ou dropstone) |
auth
Commande pour gérer les identifiants et la connexion pour les fournisseurs.
dropstone auth [command]
login
Utilisez dropstone auth login pour vous connecter à Dropstone. Vos identifiants sont stockés dans ~/.local/share/dropstone/auth.json.
dropstone auth login
Dropstone lit les identifiants de ce fichier à chaque lancement.
Flags
| Flag | Short | Description |
|---|---|---|
--provider | -p | ID ou nom du fournisseur auquel se connecter |
--method | -m | Libellé de la méthode de connexion à utiliser, en ignorant la sélection de méthode |
list
Liste tous les fournisseurs authentifiés tels que stockés dans le fichier d'identifiants.
dropstone auth list
Ou la version courte.
dropstone auth ls
logout
Vous déconnecte d'un fournisseur en le supprimant du fichier d'identifiants.
dropstone auth logout
github
Gérer l'agent GitHub pour l'automatisation de dépôts.
dropstone github [command]
install
Installer l'agent GitHub dans votre dépôt.
dropstone github install
Cela configure le workflow GitHub Actions nécessaire et vous guide à travers le processus de configuration. En savoir plus.
run
Exécuter l'agent GitHub. Ceci est généralement utilisé dans GitHub Actions.
dropstone github run
Flags
| Flag | Description |
|---|---|
--event | Événement simulé GitHub pour lequel exécuter l'agent |
--token | Jeton d'accès personnel GitHub |
mcp
Gérer les serveurs Model Context Protocol.
dropstone mcp [command]
add
Ajouter un serveur MCP à votre configuration.
dropstone mcp add
Cette commande vous guidera pour ajouter un serveur MCP local ou distant.
list
Lister tous les serveurs MCP configurés et leur état de connexion.
dropstone mcp list
Ou utilisez la version courte.
dropstone mcp ls
auth
S'authentifier auprès d'un serveur MCP compatible OAuth.
dropstone mcp auth [name]
Si vous ne fournissez pas de nom de serveur, vous serez invité à sélectionner parmi les serveurs compatibles OAuth disponibles.
Vous pouvez également lister les serveurs compatibles OAuth et leur état d'authentification.
dropstone mcp auth list
Ou utilisez la version courte.
dropstone mcp auth ls
logout
Supprimer les identifiants OAuth pour un serveur MCP.
dropstone mcp logout [name]
debug
Déboguer les problèmes de connexion OAuth pour un serveur MCP.
dropstone mcp debug <name>
models
Lister les niveaux de modèles Dropstone disponibles pour votre compte.
dropstone models
La sortie est au format dropstone/<niveau>. Dropstone propose trois niveaux :
| Model ID | Niveau | Idéal pour |
|---|---|---|
dropstone/dropstone-fast | Fast | Pilote quotidien par défaut. Modifications rapides, génération de code, débogage conversationnel. |
dropstone/dropstone-pro | Pro | Refactorisations multi-fichiers, modifications transversales, raisonnement plus large. |
dropstone/dropstone-heavy | Heavy | Décisions d'architecture, migrations importantes, débogage difficile. |
Voir Modèles pour la répartition complète et comment définir un modèle par défaut.
Flags
| Flag | Description |
|---|---|
--refresh | Actualiser la liste des modèles en cache |
--verbose | Inclure les métadonnées (fenêtre de contexte, capacités) |
run
Exécuter dropstone en mode non interactif en passant une invite directement.
dropstone run [message..]
Ceci est utile pour les scripts, l'automatisation, ou lorsque vous voulez une réponse rapide sans ouvrir une session interactive. Par exemple :
dropstone run Expliquez l'utilisation du contexte en Go
Vous pouvez également vous attacher à une instance dropstone serve en cours d'exécution pour éviter les temps de démarrage à froid du serveur MCP à chaque exécution :
# Démarrez un serveur sans interface dans un terminal
dropstone serve
# Dans un autre terminal, exécutez des commandes qui s'y attachent
dropstone run --attach http://localhost:4096 "Expliquez async/await en JavaScript"
Flags
| Flag | Short | Description |
|---|---|---|
--command | La commande à exécuter, utilisez le message pour les arguments | |
--continue | -c | Continuer la dernière session |
--session | -s | ID de session à continuer |
--fork | Forker la session lors de la continuation (à utiliser avec --continue ou --session) | |
--share | Partager la session | |
--model | -m | Modèle à utiliser (dropstone/dropstone-fast, dropstone/dropstone-pro, ou dropstone/dropstone-heavy) |
--agent | Agent à utiliser | |
--file | -f | Fichier(s) à joindre au message |
--format | Format : default (formaté) ou json (événements JSON bruts) | |
--title | Titre de la session (utilise l'invite tronquée si aucune valeur n'est fournie) | |
--attach | S'attacher à un serveur dropstone en cours d'exécution (par ex., http://localhost:4096) | |
--password | -p | Mot de passe d'authentification de base (par défaut DROPSTONE_SERVER_PASSWORD) |
--username | -u | Nom d'utilisateur d'authentification de base (par défaut DROPSTONE_SERVER_USERNAME ou dropstone) |
--dir | Répertoire dans lequel exécuter, ou chemin sur le serveur distant lors de l'attachement | |
--port | Port pour le serveur local (par défaut port aléatoire) | |
--variant | Variante du modèle (effort de raisonnement spécifique au fournisseur) | |
--thinking | Afficher les blocs de réflexion | |
--dangerously-skip-permissions | Approuver automatiquement les permissions qui ne sont pas explicitement refusées (dangereux !) |
serve
Démarrer un serveur Dropstone sans interface pour un accès API. Consultez la documentation du serveur pour l'interface HTTP complète.
dropstone serve
Cela démarre un serveur HTTP sans interface qui fournit un accès programmatique à Dropstone, sans ouvrir de session interactive. Définissez DROPSTONE_SERVER_PASSWORD pour activer l'authentification HTTP de base (le nom d'utilisateur par défaut est dropstone).
Flags
| Flag | Description |
|---|---|
--port | Port d'écoute |
--hostname | Nom d'hôte d'écoute |
--mdns | Activer la découverte mDNS |
--mdns-domain | Nom de domaine mDNS personnalisé |
--cors | Origine(s) de navigateur supplémentaire(s) pour autoriser CORS |
session
Gérer les sessions Dropstone.
dropstone session [command]
list
Lister toutes les sessions Dropstone.
dropstone session list
Flags
| Flag | Short | Description |
|---|---|---|
--max-count | -n | Limiter aux N sessions les plus récentes |
--format | Format de sortie : table ou json (table) |
delete
Supprimer une session Dropstone.
dropstone session delete <sessionID>
stats
Afficher les statistiques d'utilisation de jetons et de coûts pour vos sessions Dropstone.
dropstone stats
Flags
| Flag | Description |
|---|---|
--days | Afficher les statistiques pour les N derniers jours (tous les temps) |
--tools | Nombre d'outils à afficher (tous) |
--models | Afficher la répartition de l'utilisation des modèles (masquée par défaut). Passez un nombre pour afficher les N premiers |
--project | Filtrer par projet (tous les projets, chaîne vide : projet actuel) |
export
Exporter les données de session au format JSON.
dropstone export [sessionID]
Si vous ne fournissez pas d'ID de session, vous serez invité à sélectionner parmi les sessions disponibles.
Flags
| Flag | Description |
|---|---|
--sanitize | Masquer les données sensibles de transcription/fichier |
import
Importer des données de session à partir d'un fichier JSON ou d'une URL de partage Dropstone.
dropstone import <file>
Vous pouvez importer à partir d'un fichier local ou d'une URL de partage Dropstone.
dropstone import session.json
dropstone import https://dropstone.io/s/abc123
web
Démarrer un serveur Dropstone sans interface avec une interface web.
dropstone web
Cela démarre un serveur HTTP et ouvre un navigateur web pour accéder à Dropstone via une interface web. Définissez DROPSTONE_SERVER_PASSWORD pour activer l'authentification HTTP de base (le nom d'utilisateur par défaut est dropstone).
Flags
| Flag | Description |
|---|---|
--port | Port d'écoute |
--hostname | Nom d'hôte d'écoute |
--mdns | Activer la découverte mDNS |
--mdns-domain | Nom de domaine mDNS personnalisé |
--cors | Origine(s) de navigateur supplémentaire(s) pour autoriser CORS |
acp
Démarrer un serveur ACP (Agent Client Protocol).
dropstone acp
Cette commande démarre un serveur ACP qui communique via stdin/stdout en utilisant nd-JSON.
Flags
| Flag | Description |
|---|---|
--cwd | Répertoire de travail |
--port | Port d'écoute |
--hostname | Nom d'hôte d'écoute |
--mdns | Activer la découverte mDNS |
--mdns-domain | Nom de domaine mDNS personnalisé |
--cors | Origine(s) de navigateur supplémentaire(s) pour autoriser CORS |
plugin
Installer un plugin et mettre à jour votre configuration.
dropstone plugin <module>
Ou utilisez l'alias.
dropstone plug <module>
Flags
| Flag | Short | Description |
|---|---|---|
--global | -g | Installer dans la configuration globale |
--force | -f | Remplacer la version de plugin existante |
pr
Récupérer et extraire la branche d'une PR GitHub, puis exécuter Dropstone.
dropstone pr <number>
db
Outils de base de données.
dropstone db [query]
Flags
| Flag | Description |
|---|---|
--format | Format de sortie : json ou tsv |
path
Afficher le chemin de la base de données.
dropstone db path
debug
Outils de débogage et de résolution de problèmes.
dropstone debug [command]
uninstall
Désinstaller Dropstone et supprimer tous les fichiers associés.
dropstone uninstall
Flags
| Flag | Short | Description |
|---|---|---|
--keep-config | -c | Conserver les fichiers de configuration |
--keep-data | -d | Conserver les données de session et les instantanés |
--dry-run | Afficher ce qui serait supprimé sans supprimer | |
--force | -f | Ignorer les invites de confirmation |
upgrade
Met à jour l'interface en ligne de commande Dropstone vers la dernière version ou une version spécifique. dropstone update est un alias et se comporte de manière identique.
dropstone upgrade [target]
# ou
dropstone update [target]
Pour mettre à niveau vers la dernière version :
dropstone upgrade
Pour installer une version spécifique :
dropstone upgrade 1.0.5
Sur Windows, si Dropstone est actuellement en cours d'exécution, le programme d'installation prépare la nouvelle version sous dropstone.exe.pending. La nouvelle version s'active automatiquement au prochain lancement : aucun déplacement manuel de fichier n'est nécessaire.
Flags
| Flag | Short | Description |
|---|---|---|
--method | -m | La méthode d'installation à utiliser : curl, npm, pnpm, bun, brew, scoop, choco |
Flags globaux
L'interface en ligne de commande dropstone accepte les flags globaux suivants.
| Flag | Short | Description |
|---|---|---|
--help | -h | Afficher l'aide |
--version | -v | Afficher le numéro de version |
--print-logs | Afficher les journaux sur stderr | |
--log-level | Niveau de journalisation (DEBUG, INFO, WARN, ERROR) | |
--pure | Exécuter sans plugins externes |
Variables d'environnement
Dropstone lit les variables d'environnement suivantes au lancement. Ce sont les variables orientées utilisateur prises en charge ; tout ce qui n'est pas listé ici est interne et peut changer ou être supprimé sans préavis.
| Variable | Type | Description |
|---|---|---|
DROPSTONE_API_KEY | string | Clé API Dropstone pour une utilisation sans interface / CI (ignore la connexion par navigateur) |
DROPSTONE_CONFIG | string | Chemin vers un fichier de configuration dropstone.json |
DROPSTONE_TUI_CONFIG | string | Chemin vers un fichier de configuration de session (tui.json) |
DROPSTONE_DISABLE_AUTOUPDATE | boolean | Désactiver les vérifications automatiques de mise à jour du CLI |
DROPSTONE_GIT_BASH_PATH | string | Chemin vers Git Bash sur Windows (utilisé comme outil shell) |
DROPSTONE_SERVER_PASSWORD | string | Activer l'authentification HTTP de base sur dropstone serve / dropstone web |
DROPSTONE_SERVER_USERNAME | string | Remplacer le nom d'utilisateur d'authentification de base (par défaut dropstone) |