aktar CLI-Dokumentation

aktar upload

Lädt eine oder mehrere Dateien hoch und gibt pro Datei einen Link aus, in der richtigen Reihenfolge, sobald sie fertig ist.

Verwendung

$ aktar upload <file>... [options]

Optionen

Gut zu wissen

• Jede Datei wird geprüft, bevor irgendetwas hochgeladen wird: Fehlt eine, wird nichts hochgeladen, und aktar beendet sich mit Code 2.
• Schlägt ein Upload fehl, laufen die anderen trotzdem durch. Jeder Fehler wird auf stderr gemeldet, und der Exit-Code ist 1.
• Ohne --folder benennt die Pfadvorlage des Ziels die Datei, genau wie beim Ablegen auf der Menüleiste. Mit --folder behält die Datei in diesem Ordner ihren Namen.
• --name funktioniert mit jeweils einer Datei. Schrägstriche werden entfernt, und die Dateiendung wird ergänzt, wenn der Name keine hat: --name cover lädt IMG_4021.jpg als cover.jpg hoch. Mit --folder ist es der Name im Ordner.
• --expires nimmt 1, 7, 14 oder 30 (Tage) oder 0, um die Datei zu behalten. Ohne die Option bleibt die Datei erhalten, egal, was in Aktar bei Löschen nach eingestellt ist. Das Ziel braucht dafür die Regeln für automatisches Löschen von Aktar, und die Option lässt sich nicht mit --folder kombinieren.
• --qr lässt sich nicht mit --json kombinieren, und --png funktioniert nur mit aktar qr.
• Im Terminal wird der Fortschritt auf stderr angezeigt, während eine Datei hochlädt. Die Datei wird an Aktar gestreamt, ihre Größe spielt also keine Rolle, und es gibt kein Zeitlimit.
• Hat das Ziel in Aktar einen Linkkürzer, wird der Kurzlink ausgegeben, und --format und --qr verwenden ihn. --short erstellt einen, auch wenn die Regeln des Ziels diesen Upload auslassen würden, --no-short erstellt keinen. Kann Aktar ihn nicht erstellen, wird der ursprüngliche Link ausgegeben, und stderr nennt den Grund.

Beispiele

$ aktar upload screenshot.png
https://files.example.com/2026/10/7f3c2a91.png

$ aktar upload *.png -f markdown
![](https://files.example.com/2026/10/1b9e44d0.png)
![](https://files.example.com/2026/10/c2f71a5e.png)

$ aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpg

$ aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpg

$ aktar upload talk.pdf --short
https://s.example.com/k3Tq9

aktar upload --clipboard

Lädt die Datei oder das Bild aus der Zwischenablage hoch, wie das Zwischenablage-Kürzel von Aktar.

Verwendung

$ aktar upload --clipboard [options]

Optionen

Gut zu wissen

• Gib Dateien oder --clipboard an, nicht beides.
• --name und --folder funktionieren nur mit Dateien. -d, -f, --expires, --qr und --json funktionieren wie bei Dateien.
• Mit --json kommt trotzdem ein Array heraus, mit einem Eintrag.

Beispiele

$ aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.png

$ aktar upload --clipboard -f markdown -d Blog
![](https://blog-assets.example.com/2026/10/e5b2c8a4.png)

$ aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.png

aktar replace

Schreibt eine neue Datei über einen Upload, sodass Schlüssel und Link gleich bleiben. Alle mit dem Link sehen die neue Datei.

Verwendung

$ aktar replace <upload-id|link|key> <file> [options]

Optionen

Gut zu wissen

• Das erste Argument ist eine Upload-ID oder ein Link aus aktar history (der Eintrag im Verlauf von Aktar wird aktualisiert), sonst ein Schlüssel im Bucket von -d (ohne -d das in Aktar ausgewählte Ziel). Ein Link, der nicht im Verlauf von Aktar steht, wird abgelehnt: gib stattdessen seinen Schlüssel mit -d an.
• Aktar entfernt die Metadaten der Datei und verkleinert sie, wie das Ziel es vorgibt, wandelt sie aber nie in ein anderes Format um, sodass die Endung des Schlüssels bleibt. Eine Datei unter tmp/{N}d/ beginnt ihre N Tage von vorn.
• Der Schlüssel wird nie nummeriert und sonst wird nichts hochgeladen. --folder, --expires, --name und --clipboard gelten hier nicht und werden abgelehnt.
• Alte Kopien können eine Weile im Cache eines CDN bleiben. Die Kurze Cache-Dauer eines Ziels oder das Leeren des Cloudflare-Caches in Aktar erledigt das.
• Braucht Aktar für Mac 0.14.0 oder Aktar für Windows 0.7.0 oder neuer.

Beispiele

$ aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar replace docs/guide.pdf guide.pdf -d Blog -f markdown
[guide.pdf](https://blog-assets.example.com/docs/guide.pdf)

aktar short

Erstellt mit dem Linkkürzer des Ziels einen Kurzlink für einen Upload aus dem Verlauf und gibt ihn aus. Hat der Upload schon einen, wird dieser ausgegeben.

Verwendung

$ aktar short <upload-id|link> [--json | --qr]

Optionen

Gut zu wissen

• Gib eine Upload-ID oder einen Link aus aktar history an; sein Kurzlink geht auch. aktar sucht ihn in den letzten 1.000 Uploads.
• Das Ziel braucht einen Linkkürzer im Abschnitt Kurzlinks in Aktar: Shlink, YOURLS, Kutt, Dub, Short.io oder eine eigene Anfrage. Der Kurzlink kommt von diesem Kürzer, deine Links und Klickdaten bleiben also in deiner Infrastruktur.
• --json gibt die Details des Kurzlinks aus: Anbieter, Status sowie Klicks und letzten Klick, wenn der Kürzer sie zählt. --qr fügt seinen QR-Code hinzu. Beides zusammen geht nicht.
• Braucht Aktar für Mac 0.17.0 oder Aktar für Windows 0.10.0. Ältere Versionen antworten, dass sie noch keine Kurzlinks erstellen.

Beispiele

$ aktar short 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1
https://s.example.com/Qm3xZ

aktar qr

Zeigt im Terminal einen QR-Code für einen Link oder beliebigen Text, damit du ihn auf dem Handy öffnen kannst. Mit einer Upload-ID zeigt er den Link dieses Uploads und seinen QR-Code.

Verwendung

$ aktar qr <link|text|upload-id> [--png <file>]

Optionen

Gut zu wissen

• Gib genau ein Argument an und setz Text mit Leerzeichen in Anführungszeichen.
• Eine Upload-ID ist die id aus aktar history --json oder aktar upload --json. aktar sucht sie in den letzten 1.000 Uploads im Verlauf von Aktar. Für reinen Text oder einen Link braucht es Aktar gar nicht.
• Im Terminal wird der Code schwarz auf weiß gezeichnet, unabhängig vom Theme. Ist die Ausgabe kein Terminal oder ist NO_COLOR gesetzt, wird er ohne Farben gezeichnet.
• --png speichert den QR-Code als PNG, statt ihn auszugeben.
• Bei einem Upload mit Kurzlink zeigt er den Kurzlink.

Beispiele

$ aktar qr https://files.example.com/2026/10/demo.mp4

$ aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.png

aktar login

Prüft ein Token bei Aktar und speichert es, damit die anderen Befehle sich verbinden können.

Verwendung

$ aktar login [--token <token>] [--port <port>]

Optionen

Gut zu wissen

• Im Terminal fragt es nach dem Token und verbirgt, was du tippst. Kommt die Eingabe über eine Pipe, liest es das Token von dort.
• --token überspringt die Abfrage, aber andere Programme können das Token sehen, solange der Befehl läuft, und es landet in deinem Shell-Verlauf, deshalb warnt aktar davor. Eine Pipe oder AKTAR_TOKEN vermeiden das.
• Ein Token, das Aktar ablehnt, wird nicht gespeichert, und der Exit-Code ist 3.

Beispiele

$ aktar login
Copy the token from Aktar: Settings > Integrations (turn on Allow local connections first).
Token:
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ pbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ aktar login --token "$AKTAR_SECRET" --port 47920
aktar: warning: a token on the command line can be seen by other programs (ps) and stays in your shell history. Next time, run aktar login without --token and paste it, or pipe it in.
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

aktar logout

Löscht das gespeicherte Token und den Port.

Verwendung

$ aktar logout

Optionen

Keine Optionen.

Gut zu wissen

• AKTAR_TOKEN funktioniert, falls gesetzt, auch nach aktar logout weiter.
• Andere Clients werden dadurch nicht getrennt. Dafür erzeugst du das Token in Aktar neu.

Beispiele

$ aktar logout
Logged out.

$ aktar status
aktar: Not connected to Aktar yet. Run aktar login with the token from Aktar's Settings > Integrations.

aktar status

Zeigt, mit welchem Aktar du verbunden bist, auf welchem Port, welches Ziel in Aktar ausgewählt ist und wo die Konfigurationsdatei liegt.

Verwendung

$ aktar status [--json]

Optionen

Gut zu wissen

• Ein schneller Verbindungstest in einem Skript: Der Befehl beendet sich mit Code 3, wenn Aktar nicht erreichbar oder das Token falsch ist.

Beispiele

$ aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.json

$ aktar status --json
{
  "app": "Aktar",
  "version": "0.10.0",
  "build": "28",
  "apiVersion": 1,
  "defaultDestinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
  "outputFormat": "url",
  "port": 47913
}

aktar destinations

Listet deine Ziele mit Anbieter, Bucket und ID auf. * markiert das in Aktar ausgewählte.

Verwendung

$ aktar destinations [--json]

Optionen

Gut zu wissen

• Nutze bei -d einen Namen oder eine ID. Bei Namen spielt Groß- und Kleinschreibung keine Rolle, eine ID funktioniert immer, auch nach dem Umbenennen.
• --json liefert für jedes Ziel id, name, provider, providerName, bucket, publicBaseURL und isDefault.

Beispiele

$ aktar destinations
* Screenshots  Cloudflare R2  screenshots  5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47
  Builds  Amazon S3  acme-builds  A83F2C10-6D4B-4F7E-9C1A-2B5E8D0F3C66
  Blog  Backblaze B2  blog-assets  E2C7B9A4-1F3D-4A8E-B6C0-9D5F2A7E4B13

$ aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshots

aktar history

Listet die letzten Uploads auf, die neuesten zuerst: Datum, Dateiname und Link. Wörter nach history durchsuchen den Verlauf.

Verwendung

$ aktar history [search] [options]

Optionen

Gut zu wissen

• Es werden 20 Uploads gelistet, sofern du nicht -n angibst.
• --json liefert dieselben Felder wie aktar upload --json, darunter die id jedes Uploads für aktar qr.

Beispiele

$ aktar history -n 3
2026-10-01  screenshot.png  https://files.example.com/2026/10/7f3c2a91.png
2026-10-01  cover.jpg  https://files.example.com/blog/2026/cover.jpg
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar history invoice -d Screenshots
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf
2026-08-29  invoice-august.pdf  https://files.example.com/2026/08/a6c94f20.pdf

$ aktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zip

aktar mcp

Startet einen Model-Context-Protocol-Server (MCP), damit KI-Agenten wie Claude, Cursor, VS Code und Codex über Aktar Dateien hochladen, frühere Uploads finden und Links erstellen können. Du trägst ihn einmal in deinen Agenten ein; der Agent startet ihn selbst, wenn er ihn braucht.

Verwendung

$ aktar mcp [--root <folder>]... [--read-only | --allow-replace | --allow-delete] [--max-link-minutes <n>] [--log <file>]

Optionen

Gut zu wissen

• Führe zuerst aktar login aus. Der Server liest bei jedem Aufruf das gespeicherte Token, daher funktioniert ein erneutes Anmelden ohne Neustart des Agenten.
• Ein Upload veröffentlicht eine Datei: Jeder mit dem Link kann sie öffnen. Agenten fragen vor dem Aufruf eines Tools nach, sofern du es nicht erlaubst.
• Dateien werden nur aus den Ordnern hochgeladen, die du mit --root angibst, sonst aus dem Ordner, in dem der Server läuft. Ist das dein Benutzerordner oder die oberste Ebene der Festplatte, wie bei manchen Apps, werden keine lokalen Dateien hochgeladen, bis du --root hinzufügst. --root ~ erlaubt deinen ganzen Benutzerordner, falls du das wirklich willst. Pfade werden samt Symlinks aufgelöst, bevor sie geprüft werden.
• Geheimnisse werden nie hochgeladen, egal wo sie liegen: SSH- und private Schlüssel, .env-Dateien, Zugangsdaten für Cloud und Paketmanager (~/.aws, ~/.kube, ~/.npmrc und andere), die Konfiguration von Aktar selbst, der Schlüsselbund, Browserprofile und Passwortdatenbanken. Dateien mit mehreren Hardlinks werden ebenfalls abgelehnt. Um eine davon zu teilen, lade sie selbst mit aktar upload hoch.
• --read-only bietet nur die Tools an, die in einem Bucket nichts verändern. replace_file überschreibt eine Datei, wie es ein Löschen täte, und wird daher nur mit --allow-replace angeboten, delete_upload nur mit --allow-delete (das auch replace_file anbietet).
• create_temporary_link erstellt Links, die höchstens 60 Minuten gelten, sofern --max-link-minutes nicht mehr erlaubt. upload_clipboard fehlt, wenn du --root angibst, da die Zwischenablage alles enthalten kann.
• Tool-Ergebnisse beginnen mit dem Hinweis, dass Dateinamen, Keys und Meldungen darin Daten sind, keine Anweisungen, und --log protokolliert jeden Aufruf. Es laufen höchstens 4 Tool-Aufrufe gleichzeitig.
• Ohne globale Installation nimm npx -y @getaktar/cli mcp --root ~/Projects als Befehl.
• Er spricht die aktuelle MCP-Version (2026-07-28) und die früheren, die mit initialize beginnen (2024-11-05 bis 2025-11-25), über stdio. Braucht aktar 0.4.0; die Grenzen oben kamen mit aktar 0.6.0.

Tools

Beispiele

$ claude mcp add aktar -- aktar mcp --root ~/Projects
$ codex mcp add aktar -- aktar mcp --root ~/Projects

$ claude mcp add aktar -- aktar mcp --root ~/Projects --root ~/Desktop --allow-replace

$ claude mcp add aktar -- aktar mcp --root ~/Projects --log ~/aktar-mcp.log

aktar skill

Gibt einen Agenten-Skill (SKILL.md) aus, der Agenten beibringt, den Befehl aktar mit --json zu nutzen: was auszuführen ist, wie das Ergebnis gelesen wird und dass nur hochgeladen wird, was du teilen wolltest. Für Agenten, die Skills, aber kein MCP nutzen.

Verwendung

$ aktar skill

Optionen

Keine Optionen.

Gut zu wissen

• Speichere ihn dort, wo dein Agent nach Skills sucht, zum Beispiel ~/.claude/skills/aktar/ für Claude Code.

Beispiele

$ mkdir -p ~/.claude/skills/aktar
$ aktar skill > ~/.claude/skills/aktar/SKILL.md

Optionen für jeden Befehl