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 richten können (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 /pfad/zu/ihrem/projekt
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 Ihrer Browser-URL-Leiste erscheint.
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: Starten Sie Ihre erste Sitzung

Sie sehen jetzt den Dropstone-Startbildschirm. Drei Dinge, die Sie beachten sollten:

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: Stellen Sie Ihre erste Frage

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

was macht dieses Projekt?

was sind die Haupteinstiegspunkte?

erkläre die Ordnerstruktur

Dropstone liest Dateien bei Bedarf und antwortet mit Zitaten aus dem 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 hast du die Erlaubnis auszuführen?

Schritt 5: Machen Sie Ihre erste Codeänderung

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 um Ihre Genehmigung bitten
Das Ergebnis verifizieren (Typprüfungen, Tests, Lints, falls verfügbar)

Berechtigungen

Dropstone fragt beim ersten Mal um Genehmigung, wenn es 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 erlaubten Aktionen 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-bezogene Workflows (Pull-Requests öffnen, PR-Beschreibungen generieren, Review-Kommentare posten) siehe GitHub-Integration.

Schritt 7: Einen Bug beheben oder eine Funktion hinzufügen

Beschreiben Sie, was Sie möchten, in einfacher Sprache. Dropstone wird den Code lokalisieren, den Kontext verstehen, die Änderung implementieren und sie 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: Probieren Sie andere häufige Workflows aus

Einige Muster, in denen Dropstone 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.

Wesentliche Befehle

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

Befehl	Was er tut	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 Konten	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, das Model Context Protocol spricht.

Modelle & Anbieter

Mehr über Fast 1.6, Pro 1.6 und Heavy 1.6 sowie darüber, wie Sie einen Standard in Ihrer Konfiguration festlegen.

Berechtigungen

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

Hilfe erhalten

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

Overview

Pricing