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 avez 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 le chemin d'installation pour 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 se met à jour automatiquement en arrière-plan, vous restez donc à jour sans relancer l'installateur.

É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'URL 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 regardez 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 les voir toutes

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 points d'entrée principaux ?

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 t'a-t-on donné 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 la validation des entrées à 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 veut 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 voir 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 flux de travail 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 clair. 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 écrira 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 flux de travail 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 attente et signale tout ce qui est risqué

Documentation

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

Astuce:

Parlez à Dropstone comme à un coéquipier. Décrivez ce que vous voulez accomplir, pas les étapes exactes pour y arriver. L'agent est le 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`	Continue la dernière session dans ce répertoire	`dropstone -c`
`dropstone --session ID`	Reprend une session spécifique par 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. Utile après une semaine d'utilisation.

Apprenez à Dropstone votre dépôt (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 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 exactement ce que Dropstone peut lire, écrire et exécuter dans vos projets.

Obtenir de l'aide

Dans Dropstone, tapez /help ou posez une 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