Démarrage rapide

Installez Dropstone, connectez-vous et livrez votre première modification en moins de cinq minutes. Ce guide vous fait passer de zéro à une boucle d'agent fonctionnelle.

À la fin de ce guide, vous aurez installé Dropstone, vous serez connecté et vous produirez de véritables modifications dans un projet de votre choix.

Avant de commencer

Vous aurez besoin de :

Un terminal ou une invite de commande
Un projet sur disque vers lequel pointer Dropstone (n'importe quel langage, n'importe quelle taille)
Un compte Dropstone, que vous pouvez créer sur dropstone.io

Étape 1 : Installer Dropstone

Choisissez la méthode d'installation adaptée à votre plateforme.

Homebrew (recommandé) :

brew tap blankline-org/dropstone-cli
brew install dropstone

Ou le script d'installation :

curl -fsSL https://dropstone.io/install | bash

Les deux méthodes installent un seul binaire dropstone sur votre PATH. Pas de Node, pas de dépendances d'exécution.

Vérifiez l'installation :

dropstone --version

Vous devriez voir un numéro de version (la version actuelle est 1.0.8). Le binaire vérifie les mises à jour au démarrage et les installe, afin que vous restiez à jour sans relancer l'installateur. Si vous avez installé avec Homebrew, utilisez brew upgrade dropstone à la place — Homebrew gère ce binaire et Dropstone n'y touchera pas.

Étape 2 : Se connecter

Déplacez-vous dans un répertoire de projet et lancez Dropstone :

cd /chemin/vers/votre/projet
dropstone

Au premier lancement, vous serez invité à vous connecter. Deux options :

Continuer dans le navigateur (recommandé). Ouvre dropstone.io/login, vous connecte et transmet automatiquement le jeton au CLI. Utilise PKCE pour que le jeton n'apparaisse jamais dans la barre d'adresse de votre navigateur.
Coller un jeton. Pour les sessions SSH ou sans interface graphique. Obtenez un jeton sur dropstone.io/account et collez-le.

Vos identifiants sont stockés sur disque après la première connexion. Pour changer de compte plus tard, exécutez /login depuis Dropstone.

Étape 3 : Démarrer votre première session

Vous voyez maintenant l'écran d'accueil de Dropstone. Trois choses à remarquer :

Votre niveau de modèle actuel est affiché en haut à droite (par défaut : Dropstone Fast)
La zone de saisie en bas est l'endroit où vous tapez
Les commandes slash commencent par /. Essayez /help pour toutes les voir

Tapez n'importe quelle invite en langage naturel pour démarrer une session. Il n'y a aucune syntaxe spéciale à apprendre.

Étape 4 : Poser votre première question

Laissez Dropstone explorer le projet pour vous. Essayez l'une de ces invites :

que fait ce projet ?

quels sont les principaux points d'entrée ?

explique la structure des dossiers

Dropstone lira les fichiers à la demande et répondra avec des citations du code réel. Vous n'avez pas besoin de coller des fichiers ou d'écrire du contexte manuellement.

Vous pouvez aussi interroger Dropstone sur lui-même :

que peux-tu faire dans ce projet ?

quelles commandes as-tu la permission d'exécuter ?

Étape 5 : Effectuer votre première modification de code

Décrivez maintenant une petite modification. Pour un nouveau projet, essayez quelque chose à faible risque :

ajoute un README avec une description du projet en un paragraphe

Pour un projet existant :

ajoute une validation d'entrée à la fonction qui crée un utilisateur

Dropstone va :

Trouver le fichier pertinent
Afficher la modification proposée sous forme de diff
Demander votre approbation avant d'écrire
Vérifier le résultat (vérifications de types, tests, lints si disponibles)

Permissions

Dropstone demande une approbation la première fois qu'il souhaite modifier un fichier ou exécuter une commande shell. Approuvez une fois, et la même opération dans la même session s'exécutera sans nouvelle invite. Utilisez /permissions pour consulter ou révoquer ce que vous avez autorisé.

Étape 6 : Travailler avec git

Dropstone traite git comme un outil de première classe :

quels fichiers ai-je modifiés ?

valide mes modifications avec un message descriptif

crée une branche appelée feature/health-endpoint et bascule dessus

affiche les cinq derniers commits

aide-moi à résoudre le conflit de fusion dans src/auth.ts

Pour les workflows au niveau des PR (ouverture de pull requests, génération de descriptions de PR, publication de commentaires de revue), consultez Intégration GitHub.

Étape 7 : Corriger un bug ou ajouter une fonctionnalité

Décrivez ce que vous voulez en langage naturel. Dropstone localisera le code, comprendra le contexte, implémentera la modification et la vérifiera.

il y a un bug où les recherches vides renvoient tous les résultats - corrige-le

ajoute un endpoint /healthz au serveur API qui renvoie les informations de build

le formulaire de connexion plante lorsque l'email est manquant - trouve pourquoi et corrige-le

Si la tâche s'étend sur plusieurs fichiers, Dropstone rédigera un court plan et l'exécutera étape par étape. Vous pouvez appuyer sur Échap à tout moment pour interrompre et orienter.

Étape 8 : Essayer d'autres workflows courants

Quelques modèles dans lesquels Dropstone excelle :

Refactorisation

refactorise le module d'authentification pour utiliser async/await au lieu des callbacks

Écrire des tests

écris des tests unitaires pour les fonctions de la calculatrice

Revue de code

revue mes modifications en staging et signale tout ce qui est risqué

Documentation

mets à jour les instructions d'installation du README pour inclure le chemin WSL

Tip

Parlez à Dropstone comme à un coéquipier. Décrivez ce que vous voulez accomplir, pas les étapes exactes pour y arriver. L'agent est meilleur pour planifier lorsque vous lui laissez les choix d'implémentation.

Commandes essentielles

Les quelques commandes que vous utiliserez réellement :

Commande	Ce qu'elle fait	Exemple
`dropstone`	Démarre une session interactive dans le répertoire courant	`dropstone`
`dropstone run "tâche"`	Exécute une tâche ponctuelle puis quitte	`dropstone run "explique auth.ts"`
`dropstone -c`	Reprend la dernière session dans ce répertoire	`dropstone -c`
`dropstone --session ID`	Reprend une session spécifique par son identifiant	`dropstone --session 7f3a...`
`/help`	Affiche toutes les commandes slash	dans une session
`/effort`	Change le niveau de modèle pour cette session	`/effort high`
`/clear`	Efface la conversation en cours	dans une session
`/login`	Change de compte	dans une session
`exit` ou `Ctrl+D`	Quitte Dropstone

La référence complète se trouve sur les pages CLI et commandes slash.

Conseils de pro pour les nouveaux utilisateurs

Et ensuite

Référence CLI

Chaque drapeau, chaque sous-commande, chaque option. La page à mettre en favori.

Commandes slash

Toutes les commandes slash au même endroit. Pratique après une semaine d'utilisation.

Apprenez votre dépôt à Dropstone (AGENTS.md)

Déposez un fichier à la racine du dépôt qui indique à Dropstone vos conventions, commandes de build et pièges à éviter.

Connectez vos propres outils (MCP)

Branchez des bases de données, des API internes, des systèmes de tickets ou tout ce qui parle le Model Context Protocol.

Modèles & fournisseurs

En savoir plus sur Fast 1.6, Pro 1.6 et Heavy 1.6, ainsi que sur la façon de définir un modèle par défaut dans votre configuration.

Permissions

Contrôlez précisément ce que Dropstone peut lire, écrire et exécuter dans vos projets.

Obtenir de l'aide

Dans Dropstone, tapez /help ou posez votre question en langage naturel (« comment changer de modèle ? »)
Parcourez le reste de la documentation sur docs.dropstone.io
Signalez un problème ou demandez une fonctionnalité sur dropstone.io/contact

Overview

Pricing