Kommandozeile
Dateien aus dem Terminal hochladen mit aktar
Ein Befehl, ein Link: aktar upload report.pdf schickt die Datei über die Aktar-App in deinen eigenen Bucket und gibt ihre URL, Markdown oder vollständiges JSON aus. Gemacht für Skripte, CI-Jobs und Editoren wie Typora.
npm install -g @getaktar/cli brew install getaktar/tap/aktar-cliOder ohne Installation ausprobieren: npx @getaktar/cli upload file.png
Befehle
-
aktar upload <file>…Lädt eine oder mehrere Dateien hoch und gibt pro Datei einen Link aus, sobald sie fertig ist.
-
--format markdownGibt statt der einfachen URL Markdown, HTML oder deine eigene Vorlage aus Aktar aus.
-
--jsonGibt alles als JSON aus: URL, jedes Format, Objekt-Key, Größe und wann die Datei abläuft.
-
-d --folder --expiresWählt ein Ziel per Name, lädt in einen Ordner hoch oder lässt den Bucket die Datei nach 1, 7, 14 oder 30 Tagen löschen.
-
--clipboardLädt die Datei oder das Bild aus der Zwischenablage hoch.
-
--name coverLädt eine einzelne Datei unter einem anderen Namen hoch, den die Pfadvorlage des Ziels und der Verlauf von Aktar übernehmen.
-
--qr aktar qrZeigt unter jedem Link einen QR-Code, um ihn auf dem Handy zu öffnen.
aktar qrzeigt einen für jeden beliebigen Link oder für einen Upload aus dem Verlauf. -
"reused": trueLiegt dieselbe Datei schon im Bucket, gibt Aktar ihren Link zurück, statt sie erneut hochzuladen, und
aktarvermerkt das auf stderr. -
aktar replaceSchreibt eine neue Datei über einen Upload und behält den Link, per Upload-ID, Link oder Schlüssel. Braucht Aktar für Mac 0.14.0 oder Windows 0.7.0.
-
--short aktar shortGibt den Kurzlink vom eigenen Linkkürzer des Ziels aus.
aktar shorterstellt einen für einen Upload aus dem Verlauf. Braucht Aktar für Mac 0.17.0 oder Windows 0.10.0. -
aktar mcp aktar skillLässt KI-Agenten wie Claude, Cursor, VS Code und Codex Dateien hochladen, deine Uploads durchsuchen und Links erstellen, als MCP-Server oder mit einem Agenten-Skill.
-
aktar loginSpeichert das Token aus den Einstellungen von Aktar, nachdem es geprüft wurde.
-
status destinations historyZeigt die Verbindung, deine Ziele und einen durchsuchbaren Upload-Verlauf.
In einer Minute eingerichtet
- Öffne in Aktar für Mac oder Windows Einstellungen → Integrationen und aktiviere Lokale Verbindungen erlauben.
- Kopiere das Token, das dort angezeigt wird.
- Führe
aktar loginaus und füge es ein. Das war's:aktar uploadnutzt jetzt das in Aktar ausgewählte Ziel.
Typora-Bilder in deinem eigenen Bucket
Richte aktar als benutzerdefinierten Bild-Uploader in Typora ein, und jedes Bild, das du in ein Dokument einfügst, wird in deinen Bucket hochgeladen und der Link direkt ins Markdown geschrieben.
Typora einrichtenGemacht für Skripte
Links gehen an die Standardausgabe, einer pro Zeile, alles andere an die Standardfehlerausgabe. URL=$(aktar upload build.zip) funktioniert also einfach. --json liefert dir alle Details, und der Exit-Code sagt dir, was passiert ist. In CI setzt du AKTAR_TOKEN, statt dich anzumelden.
| Exit-Code | |
|---|---|
0 | Alles wurde hochgeladen |
1 | Mindestens ein Upload ist fehlgeschlagen, die anderen haben geklappt |
2 | Falsche Argumente oder fehlende Datei, nichts wurde hochgeladen |
3 | Aktar ist nicht erreichbar, das Token ist falsch, oder die App auf dem Port konnte nicht beweisen, dass sie Aktar ist |
Deine Schlüssel bleiben in Aktar
Die CLI sieht deine Speicher-Zugangsdaten nie. Sie schickt Dateien an die Aktar-App auf 127.0.0.1, die sie mit den Schlüsseln aus deinem Schlüsselbund oder der Windows-Anmeldeinformationsverwaltung hochlädt.
Die lokale API von Aktar ist aus, bis du sie einschaltest, nimmt nie Verbindungen von anderen Computern an, und jede Anfrage braucht dein Token. Die CLI bewahrt es in einer Datei auf, die nur du lesen kannst, und prüft, ob die App auf dem Port wirklich Aktar ist, bevor sie es sendet.
Voraussetzungen
- Aktar für Mac 0.18.0 oder Aktar für Windows 0.11.0 oder neuer, mit mindestens einem Ziel (aktar 0.5.0 und älter funktionieren mit Aktar für Mac 0.4.0 oder neuer)
- Node.js 18 oder neuer (Homebrew installiert es für dich)
- Links bereits hochgeladener Dateien wiederverwenden: Aktar für Mac 0.10.0 oder Aktar für Windows 0.3.0
-
aktar replace: aktar 0.3.0 und Aktar für Mac 0.14.0 oder Windows 0.7.0 -
aktar mcpundaktar skill: aktar 0.4.0 - Kurzlinks: aktar 0.5.0 und Aktar für Mac 0.17.0 oder Windows 0.10.0
- Open Source (MIT) auf GitHub
Häufige Fragen
Funktioniert die CLI ohne die Aktar-App?
Nein. Sie ist eine Fernbedienung für die App: Aktar verwaltet die Speicher-Schlüssel und erledigt den Upload, deshalb muss die App laufen und Lokale Verbindungen erlauben aktiviert sein. Aus demselben Grund braucht die CLI nie deine Access Keys.
Kann ich sie in CI oder auf einem Server nutzen?
Nur dort, wo Aktar läuft, denn die CLI spricht mit der App auf demselben Rechner. Auf einem Mac- oder Windows-Build-Agent funktioniert das gut, auf einem Linux-Server nutzt du die CLI deines Anbieters.
Welche Speicher werden unterstützt?
Alles, was Aktar unterstützt: Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO und jeder S3-kompatible Dienst. Siehe die Einrichtungsanleitungen.
Können Claude, Cursor oder andere KI-Agenten sie nutzen?
Ja. aktar mcp ist ein MCP-Server: Füge ihn mit claude mcp add aktar -- aktar mcp --root ~/Projects hinzu (oder mit der JSON-Konfiguration in der Doku), und dein Agent kann Dateien hochladen, deine Uploads durchsuchen und temporäre Links erstellen. --root ist der Ordner, aus dem er hochladen darf, Geheimnisse wie SSH-Schlüssel und .env-Dateien werden nie hochgeladen, --allow-replace lässt ihn eine Datei unter Beibehaltung ihres Links ersetzen, und --read-only lässt alles weg, was schreibt. Für Agenten ohne MCP gibt aktar skill einen Skill aus, der ihnen die CLI beibringt.
Wo wird das Token gespeichert?
In ~/.config/aktar/cli.json auf dem Mac (%APPDATA%\aktar\cli.json unter Windows), nur für deinen Benutzer lesbar. aktar logout entfernt es, und wenn du das Token in Aktar neu erzeugst, werden alle Clients getrennt.