Dropstone Docs

Bienvenue sur Dropstone

Dropstone est un outil de codage agentique qui vit dans votre terminal. Il lit votre codebase, effectue des modifications coordonnées sur plusieurs fichiers, exécute des commandes et explique son raisonnement au fur et à mesure.

Dropstone exécuté dans un terminal

Vous décrivez ce que vous voulez, et Dropstone lit le code pertinent, planifie la modification, édite les fichiers, exécute des commandes et explique ce qu'il a fait. Il fonctionne sur de vrais projets, pas sur des extraits factices, et reste ancré dans le code que vous possédez déjà.

Cette page vous donne un aperçu du produit. Le Démarrage rapide vous guide à travers l'installation et la livraison de votre première modification.

Installation en quelques secondes

Homebrew (recommandé) :

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

Ou le script d'installation :

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

Puis lancez-le dans n'importe quel projet :

cd /path/to/your/project
dropstone

Vérifiez l'installation avec dropstone --version. Au premier lancement, vous serez invité à vous connecter ; les détails complets de connexion se trouvent sur la page Démarrage rapide.

Ce que vous pouvez faire

Comprendre une codebase

Demandez comment l'authentification circule dans le système, où un bug pourrait se cacher, ou comment un module est assemblé. Dropstone lit les fichiers à la demande et répond avec des citations vers le code réel.

Créer des fonctionnalités et corriger des bugs

Décrivez la modification en langage naturel. Dropstone propose un plan, édite plusieurs fichiers et affiche les diffs avant que quoi que ce soit ne soit appliqué.

Exécuter, tester et vérifier

Les vérifications de types, les tests et les lints s'exécutent automatiquement lorsqu'ils existent. Les échecs sont réintégrés dans le plan afin que le résultat soit vert au moment où vous le lisez.

Créer des commits et des pull requests

Générez des messages de commit conventionnels, poussez des branches et ouvrez des PR via l'intégration GitHub ou GitLab. Résumés de revue de code inclus.

Connectez vos outils avec MCP

Branchez des bases de données, des API internes, des systèmes de tickets ou n'importe quel serveur Model Context Protocol. Dropstone les traite comme des outils de première classe.

Personnalisez avec des règles et des compétences

Déposez un fichier AGENTS.md à la racine du dépôt pour enseigner vos conventions à Dropstone. Empaquetez des workflows réutilisables sous forme de compétences.

Composer avec le shell

Dropstone est un citoyen Unix. La session interactive est l'interface par défaut, mais chaque capacité est disponible via une invocation unique, ce qui le rend scriptable dans les CI, les hooks de pré-commit et vos propres workflows.

# Invocation unique : posez une question et quittez
dropstone run "Expliquez comment fonctionne le middleware d'authentification"

# Passez un fichier en entrée
dropstone run "Trouvez des problèmes de sécurité" < src/auth.ts

# Utilisez-le dans un pipeline shell
git diff main | dropstone run "Rédigez une description de PR pour ce diff"

# Pilotez-le depuis la CI sans TTY
dropstone run --json "Générez des notes de version à partir des 20 derniers commits"

Comment ça fonctionne

Dropstone s'exécute comme un binaire unique dans votre terminal. Rien à configurer, aucun runtime à installer — vous le démarrez dans un projet et il opère sur les fichiers de votre répertoire de travail. Si vous préférez l'avoir à côté de votre code sous forme de panneau, il existe aussi Dropstone pour VS Code.

Chaque tour suit la même boucle :

1

Vous décrivez la tâche en langage naturel

Aucune syntaxe particulière. « Ajoutez un endpoint /healthz qui renvoie les informations de build » suffit.

2

Dropstone rassemble le contexte

Il lit les fichiers, recherche les symboles et inspecte la structure jusqu'à ce qu'il en sache assez pour agir.

3

Il propose et exécute un plan

Les modifications sont affichées sous forme de diffs. Les commandes shell demandent une autorisation, sauf si vous les avez mises sur liste blanche.

4

Il vérifie le résultat

Les vérifications de types, les tests et les lints s'exécutent automatiquement lorsqu'ils existent. Les échecs sont réintégrés dans le plan.

Toute l'interaction reste dans votre terminal. Votre code n'est jamais envoyé ailleurs qu'à l'inférence propre de Dropstone, qui est exploitée selon une politique de non-conservation et de non-entraînement. Voir la page Confiance pour plus de détails.

Utiliser Dropstone partout

Je veux…Meilleure option
Démarrer une session de codage interactiveExécutez dropstone dans votre répertoire de projet
Poser une question ponctuelle sans sessiondropstone run "..." ou passez un fichier en entrée avec <
Reprendre la dernière sessiondropstone --continue (ou dropstone -c)
Brancher un outil personnalisé ou une API interneServeurs MCP
Enseigner les conventions de votre dépôt à DropstoneDéposez un fichier AGENTS.md à la racine du dépôt
Empaqueter un workflow réutilisableCompétences et Plugins
Utiliser Dropstone dans la CI ou en pré-commitdropstone run avec --json et le modèle de permissions
Choisir le bon niveau de modèle pour la tâcheModèles (Fast / Pro / Heavy)
Exécuter dans un sandbox ou un shell restreintPermissions

Conçu autour de trois niveaux de modèles

Vous choisissez le modèle adapté au travail. Les trois sont hébergés sur une infrastructure américaine et optimisés pour le codage.

Fast

Dropstone Fast

Modifications rapides, génération de code, refactorisations sur un seul fichier et débogage conversationnel. Premier token en moins d'une seconde. Le niveau par défaut pour les nouvelles sessions.
ProRecommandé

Dropstone Pro

Refactorisations multi-fichiers, modifications transversales et tâches nécessitant un raisonnement plus large. Basculez avec /effort high.
Heavy

Dropstone Heavy

Décisions d'architecture, migrations importantes et débogage difficile. Raisonnement le plus profond, budget de réflexion le plus long. Basculez avec /effort xhigh.

Astuce:

Vous n'avez pas besoin de réfléchir à la sélection du modèle à l'avance. Commencez en Fast et utilisez /effort depuis Dropstone pour monter en puissance lorsqu'une tâche nécessite plus de profondeur.

Où aller ensuite

1

Mettez-vous en route

Le Démarrage rapide couvre l'installation, la connexion et votre première tâche.

2

Choisissez un niveau de modèle

Modèles approfondit Fast, Pro et Heavy, et quand utiliser chacun.

3

Configurez selon vos goûts

Configuration couvre les paramètres globaux et par projet ; Permissions et Raccourcis clavier couvrent le reste.

4

Voyez ce qui est nouveau

Le Journal des modifications liste chaque version avec les changements visibles par l'utilisateur.

Une fois configuré, la référence CLI et le guide des commandes slash sont les deux pages auxquelles vous reviendrez le plus souvent.


Vous construisez un agent ou une application LLM qui doit lire cette documentation ? Pointez-la vers /llms.txt pour un index du site, ou /llms-full.txt pour le corpus complet dans un seul fichier.

Ctrl+I