• Wiersz poleceń
  • v0.6.0

Przesyłaj pliki z terminala za pomocą aktar

Jedno polecenie, jeden link: aktar upload report.pdf wysyła plik do Twojego własnego bucketu przez aplikację Aktar i wypisuje jego URL, Markdown lub pełny JSON. Stworzone dla skryptów, zadań CI i edytorów takich jak Typora.

Albo wypróbuj bez instalacji: npx @getaktar/cli upload file.png

aktar upload w terminalu, wypisujący linki, obraz w Markdown i JSON

  • aktar upload <file>…

    Przesyła jeden lub więcej plików i wypisuje link do każdego z nich, gdy tylko skończy się jego przesyłanie.

  • --format markdown

    Wypisuje Markdown, HTML lub Twój własny szablon z Aktara zamiast zwykłego adresu URL.

  • --json

    Wypisuje wszystko jako JSON: URL, każdy format, klucz obiektu, rozmiar i datę wygaśnięcia pliku.

  • -d · --folder · --expires

    Wybiera miejsce docelowe po nazwie, przesyła do folderu lub każe bucketowi usunąć plik po 1, 7, 14 lub 30 dniach.

  • --clipboard

    Przesyła plik lub obraz ze schowka.

  • --name cover

    Przesyła pojedynczy plik pod inną nazwą, której używają szablon ścieżki miejsca docelowego i historia Aktara.

  • --qr · aktar qr

    Wypisuje kod QR pod każdym linkiem, żeby otworzyć go na telefonie. aktar qr pokazuje kod dla dowolnego linku lub dla pliku z historii.

  • "reused": true

    Gdy ten sam plik jest już w buckecie, Aktar zwraca jego link zamiast przesyłać go ponownie, a aktar odnotowuje to na stderr.

  • aktar replace

    Zapisuje nowy plik w miejsce przesłanego i zachowuje jego link, wskazanego przez ID przesłania, link lub klucz. Wymaga Aktara na Maca 0.14.0 lub na Windows 0.7.0.

  • --short · aktar short

    Wypisuje krótki link z własnego skracacza miejsca docelowego. aktar short tworzy go dla przesłanego pliku z historii. Wymaga Aktar dla Maca 0.17.0 lub Windows 0.10.0.

  • aktar mcp · aktar skill

    Pozwala agentom AI, takim jak Claude, Cursor, VS Code i Codex, przesyłać pliki, przeszukiwać twoje przesłania i tworzyć linki, jako serwer MCP lub przez skill dla agentów.

  • aktar login

    Zapisuje token z Ustawień Aktara po sprawdzeniu, że działa.

  • status · destinations · history

    Pokazuje połączenie, Twoje miejsca docelowe i historię przesłanych plików z wyszukiwaniem.

Konfiguracja w minutę

  1. Zezwól na połączenia lokalne

    W Aktarze na Maca lub Windows otwórz Ustawienia > Integracje i włącz Zezwalaj na połączenia lokalne.
  2. Skopiuj token

    Skopiuj wyświetlony tam token.
  3. Uruchom aktar login

    Uruchom aktar login i wklej go. To wszystko: aktar upload korzysta teraz z miejsca docelowego wybranego w Aktarze.

Stworzone dla skryptów

Linki trafiają na standardowe wyjście, po jednym w wierszu, a wszystko inne na standardowe wyjście błędów, więc URL=$(aktar upload build.zip) po prostu działa. --json daje pełne szczegóły, a kod wyjścia mówi, co się stało. W CI zamiast logowania ustaw AKTAR_TOKEN.

Kod wyjściaKod wyjścia
0Wszystko zostało przesłane
1Co najmniej jedno przesyłanie się nie powiodło, pozostałe przeszły
2Błędne argumenty lub brakujący plik, nic nie zostało przesłane
3Aktar jest nieosiągalny, token jest błędny albo aplikacja na porcie nie mogła udowodnić, że jest Aktarem

Obrazy z Typory we własnym buckecie

Ustaw aktar jako własne narzędzie Typory do przesyłania obrazów, a każdy obraz wklejony do dokumentu trafi do Twojego bucketu, z linkiem wpisanym w Markdown.

Skonfiguruj Typorę

Twoje klucze zostają w Aktarze

CLI nigdy nie widzi danych uwierzytelniających do Twojego magazynu. Wysyła pliki do aplikacji Aktar na 127.0.0.1, a ta przesyła je kluczami z pęku kluczy lub Menedżera poświadczeń.

Lokalne API Aktara jest wyłączone, dopóki go nie włączysz, nigdy nie przyjmuje połączeń z innych komputerów, a każde żądanie wymaga Twojego tokenu. CLI przechowuje go w pliku, który tylko Ty możesz odczytać, i przed jego wysłaniem sprawdza, czy aplikacja na porcie to naprawdę Aktar.

Wymagania

  • Aktar na Maca 0.18.0 lub Aktar na Windows 0.11.0 albo nowszy, z co najmniej jednym miejscem docelowym (aktar 0.5.0 i starsze działają z Aktarem na Maca 0.4.0 lub nowszym)
  • Node.js 18 lub nowszy (Homebrew zainstaluje go za Ciebie)
  • Ponowne użycie linków do plików już przesłanych: Aktar na Maca 0.10.0 lub Aktar na Windows 0.3.0
  • aktar replace: aktar 0.3.0 i Aktar na Maca 0.14.0 lub na Windows 0.7.0
  • aktar mcp i aktar skill: aktar 0.4.0
  • Krótkie linki: aktar 0.5.0 oraz Aktar dla Maca 0.17.0 lub Windows 0.10.0
  • Open source (MIT) na GitHubie

Pytania

Czy CLI działa bez aplikacji Aktar?

Nie. To pilot do aplikacji: Aktar przechowuje klucze do magazynu i zajmuje się przesyłaniem, więc musi być uruchomiony z włączoną opcją „Zezwalaj na połączenia lokalne”. Dlatego też CLI nigdy nie potrzebuje Twoich kluczy dostępu.

Czy mogę go używać w CI lub na serwerze?

Tylko tam, gdzie działa Aktar, bo CLI komunikuje się z nim na tej samej maszynie. Na agencie buildów z macOS lub Windows sprawdza się dobrze, a na serwerze z Linuksem użyj CLI swojego dostawcy.

Jakie magazyny obsługuje?

Wszystko, co obsługuje Aktar: Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO i każdą usługę zgodną z S3. Zobacz przewodniki konfiguracji.

Czy mogą go używać Claude, Cursor i inni agenci AI?

Tak. aktar mcp to serwer MCP: dodaj go przez claude mcp add aktar -- aktar mcp --root ~/Projects (lub konfigurację JSON z dokumentacji), a twój agent będzie mógł przesyłać pliki, przeszukiwać twoje przesłania i tworzyć linki tymczasowe. --root to folder, z którego może przesyłać, sekrety takie jak klucze SSH i pliki .env nigdy nie są przesyłane, --allow-replace pozwala mu podmieniać plik z zachowaniem jego linku, a --read-only pomija wszystko, co zapisuje. Dla agentów bez MCP aktar skill wypisuje skill, który uczy ich obsługi CLI.

Gdzie jest przechowywany token?

W ~/.config/aktar/cli.json na Macu (%APPDATA%\aktar\cli.json na Windows), do odczytu tylko przez Twojego użytkownika. aktar logout go usuwa, a wygenerowanie tokenu ponownie w Aktarze rozłącza wszystkich klientów.