Schnellstart

Installieren Sie Dropstone, melden Sie sich an und liefern Sie Ihre erste Änderung in unter fünf Minuten. Dieser Leitfaden bringt Sie von null zu einer funktionierenden Agent-Schleife.

Am Ende dieses Leitfadens haben Sie Dropstone installiert, angemeldet und echte Änderungen in einem Projekt Ihrer Wahl vorgenommen.

Bevor Sie beginnen

Sie benötigen:

Ein Terminal oder eine Eingabeaufforderung
Ein Projekt auf der Festplatte, auf das Sie Dropstone ausrichten (beliebige Sprache, beliebige Größe)
Ein Dropstone-Konto, das Sie unter dropstone.io erstellen können

Schritt 1: Dropstone installieren

Wählen Sie den Installationspfad für Ihre Plattform.

Homebrew (empfohlen):

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

Oder das Installationsskript:

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

Beide Methoden installieren eine einzelne dropstone-Binärdatei in Ihrem PATH. Kein Node, keine Laufzeitabhängigkeiten.

Überprüfen Sie die Installation:

dropstone --version

Sie sollten eine Versionsnummer sehen (die aktuelle Version ist 1.0.8). Die Binärdatei prüft beim Start auf Updates und installiert sie, sodass Sie ohne erneutes Ausführen des Installationsprogramms aktuell bleiben. Wenn Sie mit Homebrew installiert haben, verwenden Sie stattdessen brew upgrade dropstone – Homebrew besitzt diese Binärdatei und Dropstone wird sie nicht anfassen.

Schritt 2: Anmelden

Wechseln Sie in ein beliebiges Projektverzeichnis und starten Sie Dropstone:

cd /path/to/your/project
dropstone

Beim ersten Start werden Sie zur Anmeldung aufgefordert. Zwei Optionen:

Im Browser fortfahren (empfohlen). Öffnet dropstone.io/login, meldet Sie an und übergibt das Token automatisch an die CLI. Verwendet PKCE, sodass das Token nie in der Browser-URL-Leiste erscheint.
Ein Token einfügen. Für SSH- oder Headless-Sitzungen. Holen Sie sich ein Token unter dropstone.io/account und fügen Sie es ein.

Ihre Anmeldedaten werden nach der ersten Anmeldung auf der Festplatte gespeichert. Um später das Konto zu wechseln, führen Sie /login innerhalb von Dropstone aus.

Schritt 3: Erste Sitzung starten

Sie sehen jetzt den Dropstone-Startbildschirm. Drei Dinge fallen auf:

Ihre aktuelle Modellstufe wird oben rechts angezeigt (Standard: Dropstone Fast)
Das Eingabefeld unten ist der Ort, an dem Sie tippen
Slash-Befehle beginnen mit /. Probieren Sie /help, um alle zu sehen

Geben Sie eine beliebige natürlichsprachliche Eingabe ein, um eine Sitzung zu starten. Es gibt keine spezielle Syntax, die Sie lernen müssen.

Schritt 4: Erste Frage stellen

Lassen Sie Dropstone das Projekt für Sie erkunden. Probieren Sie eine dieser Fragen:

was macht dieses Projekt?

was sind die wichtigsten Einstiegspunkte?

erkläre die Ordnerstruktur

Dropstone liest Dateien bei Bedarf und antwortet mit Verweisen auf den tatsächlichen Code. Sie müssen keine Dateien einfügen oder Kontext manuell schreiben.

Sie können Dropstone auch nach sich selbst fragen:

was kannst du in diesem Projekt tun?

welche Befehle darfst du ausführen?

Schritt 5: Erste Codeänderung vornehmen

Beschreiben Sie nun eine kleine Änderung. Für ein neues Projekt versuchen Sie etwas mit geringem Risiko:

füge eine README mit einer einseitigen Projektbeschreibung hinzu

Für ein bestehendes Projekt:

füge Eingabevalidierung zur Funktion hinzu, die einen Benutzer erstellt

Dropstone wird:

Die relevante Datei finden
Die vorgeschlagene Änderung als Diff anzeigen
Vor dem Schreiben Ihre Genehmigung einholen
Das Ergebnis verifizieren (Typprüfungen, Tests, Lints, falls verfügbar)

Berechtigungen

Dropstone fragt nach Genehmigung, wenn es zum ersten Mal eine Datei bearbeiten oder einen Shell-Befehl ausführen möchte. Genehmigen Sie einmal, und dieselbe Operation in derselben Sitzung läuft ohne erneute Aufforderung. Verwenden Sie /permissions, um Ihre erteilten Berechtigungen anzusehen oder zu widerrufen.

Schritt 6: Mit git arbeiten

Dropstone behandelt git als erstklassiges Werkzeug:

welche Dateien habe ich geändert?

committe meine Änderungen mit einer beschreibenden Nachricht

erstelle einen Branch namens feature/health-endpoint und wechsle zu ihm

zeige die letzten fünf Commits

hilf mir, den Merge-Konflikt in src/auth.ts zu lösen

Für PR-Workflows (Pull-Requests öffnen, PR-Beschreibungen generieren, Review-Kommentare posten) siehe GitHub-Integration.

Schritt 7: Einen Bug beheben oder ein Feature hinzufügen

Beschreiben Sie in einfacher Sprache, was Sie möchten. Dropstone wird den Code lokalisieren, den Kontext verstehen, die Änderung implementieren und verifizieren.

es gibt einen Bug, bei dem leere Suchanfragen alle Ergebnisse zurückgeben – behebe ihn

füge dem API-Server einen /healthz-Endpunkt hinzu, der Build-Informationen zurückgibt

das Login-Formular stürzt ab, wenn die E-Mail fehlt – finde heraus, warum, und behebe es

Wenn die Aufgabe mehrere Dateien umfasst, schreibt Dropstone einen kurzen Plan und führt ihn Schritt für Schritt aus. Sie können jederzeit Esc drücken, um zu unterbrechen und zu steuern.

Schritt 8: Andere häufige Workflows ausprobieren

Einige Muster, bei denen Dropstone besonders gut ist:

Refactoring

refaktoriere das Auth-Modul, um async/await statt Callbacks zu verwenden

Tests schreiben

schreibe Unit-Tests für die Rechnerfunktionen

Code-Review

überprüfe meine gestagten Änderungen und markiere alles Riskante

Dokumentation

aktualisiere die README-Installationsanweisungen, um den WSL-Pfad aufzunehmen

Tip

Sprechen Sie mit Dropstone wie mit einem Teammitglied. Beschreiben Sie, was Sie erreichen möchten, nicht die genauen Schritte dorthin. Der Agent plant am besten, wenn Sie ihm die Implementierungsentscheidungen überlassen.

Wichtige Befehle

Die wenigen Befehle, die Sie tatsächlich verwenden werden:

Befehl	Funktion	Beispiel
`dropstone`	Startet eine interaktive Sitzung im aktuellen Verzeichnis	`dropstone`
`dropstone run "task"`	Führt eine einmalige Aufgabe aus und beendet sich	`dropstone run "erkläre auth.ts"`
`dropstone -c`	Setzt die letzte Sitzung in diesem Verzeichnis fort	`dropstone -c`
`dropstone --session ID`	Setzt eine bestimmte Sitzung per ID fort	`dropstone --session 7f3a...`
`/help`	Zeigt alle Slash-Befehle	innerhalb einer Sitzung
`/effort`	Wechselt die Modellstufe für diese Sitzung	`/effort high`
`/clear`	Löscht die aktuelle Unterhaltung	innerhalb einer Sitzung
`/login`	Wechselt das Konto	innerhalb einer Sitzung
`exit` oder `Ctrl+D`	Beendet Dropstone

Die vollständige Referenz finden Sie auf den Seiten CLI und Slash-Befehle.

Profi-Tipps für neue Benutzer

Was kommt als Nächstes

CLI-Referenz

Jedes Flag, jeder Unterbefehl, jede Option. Die Seite, die Sie sich merken.

Slash-Befehle

Jeder Slash-Befehl an einem Ort. Praktisch nach einer Woche Nutzung.

Bringen Sie Dropstone Ihr Repo bei (AGENTS.md)

Legen Sie eine Datei im Repo-Root ab, die Dropstone Ihre Konventionen, Build-Befehle und Stolperfallen mitteilt.

Verbinden Sie Ihre eigenen Tools (MCP)

Binden Sie Datenbanken, interne APIs, Ticketsysteme oder alles ein, was Model Context Protocol spricht.

Modelle & Anbieter

Mehr zu Fast 1.6, Pro 1.6 und Heavy 1.6 sowie zum Festlegen eines Standards in Ihrer Konfiguration.

Berechtigungen

Kontrollieren Sie genau, was Dropstone in Ihren Projekten lesen, schreiben und ausführen darf.

Hilfe erhalten

Innerhalb von Dropstone geben Sie /help ein oder fragen Sie in einfacher Sprache („wie wechsle ich die Modelle?")
Durchsuchen Sie die restliche Dokumentation unter docs.dropstone.io
Melden Sie ein Problem oder eine Feature-Anfrage unter dropstone.io/contact

Overview

Pricing