• Командний рядок
  • v0.6.0

Вивантаження з термінала за допомогою aktar

Одна команда, одне посилання: aktar upload report.pdf надсилає файл у ваш власний бакет через програму Aktar і виводить його URL-адресу, Markdown або повний JSON. Створено для скриптів, завдань CI і редакторів на кшталт Typora.

Або спробуйте без інсталяції: npx @getaktar/cli upload file.png

aktar upload у терміналі виводить посилання, зображення Markdown і JSON

  • aktar upload <file>…

    Вивантажує один або кілька файлів і виводить по посиланню на кожен файл, щойно той завершиться.

  • --format markdown

    Виводить замість звичайної URL-адреси Markdown, HTML або ваш власний шаблон з Aktar.

  • --json

    Виводить усе у форматі JSON: URL-адресу, усі формати, ключ об’єкта, розмір і час, коли файл буде видалено.

  • -d · --folder · --expires

    Вибирає ціль за назвою, вивантажує в папку або доручає бакету видалити файл через 1, 7, 14 чи 30 днів.

  • --clipboard

    Вивантажує файл або зображення з буфера обміну.

  • --name cover

    Вивантажує один файл під іншою назвою, яку використовують шаблон шляху цілі та історія Aktar.

  • --qr · aktar qr

    Виводить під кожним посиланням QR-код, щоб відкрити його на телефоні. aktar qr показує код для будь-якого посилання або для вивантаження з історії.

  • "reused": true

    Якщо такий самий файл уже є в бакеті, Aktar повертає його посилання замість повторного вивантаження, а aktar повідомляє про це в stderr.

  • aktar replace

    Записує новий файл поверх вивантаження й зберігає його посилання; вивантаження вказують за ID, посиланням або ключем. Потрібна програма Aktar для Mac 0.14.0 або Windows 0.7.0.

  • --short · aktar short

    Виводить коротке посилання з власного сервісу скорочення посилань цілі. aktar short створює його для вивантаження з історії. Потрібен Aktar для Mac 0.17.0 або Windows 0.10.0.

  • aktar mcp · aktar skill

    Дає ШІ-агентам, як-от Claude, Cursor, VS Code і Codex, змогу вивантажувати файли, шукати у ваших вивантаженнях і створювати посилання, як MCP-сервер або через навичку агента.

  • aktar login

    Зберігає токен із параметрів Aktar, попередньо перевіривши, що він працює.

  • status · destinations · history

    Показує з’єднання, ваші цілі та історію вивантажень із пошуком.

Налаштування за хвилину

  1. Дозвольте локальні з’єднання

    В Aktar для Mac або Windows відкрийте Параметри > Інтеграції й увімкніть Дозволити локальні з’єднання.
  2. Скопіюйте токен

    Скопіюйте показаний там токен.
  3. Запустіть aktar login

    Виконайте aktar login і вставте його. От і все: тепер aktar upload використовує ціль, вибрану в Aktar.

Створено для скриптів

Посилання йдуть у стандартний вивід, по одному в рядку, а все інше в стандартний потік помилок, тож URL=$(aktar upload build.zip) просто працює. --json дає всі подробиці, а код виходу повідомляє, що сталося. У CI задайте AKTAR_TOKEN замість входу.

Код виходуКод виходу
0Усе вивантажено
1Принаймні одне вивантаження не вдалося, решта пройшли
2Неправильні аргументи або відсутній файл, нічого не вивантажено
3Aktar недоступний, токен неправильний або програма на порту не змогла довести, що вона Aktar

Зображення з Typora у вашому власному бакеті

Призначте aktar власним вивантажувачем зображень у Typora, і кожне зображення, яке ви вставляєте в документ, вивантажиться у ваш бакет, а посилання буде записано в Markdown.

Налаштувати Typora

Ваші ключі лишаються в Aktar

CLI ніколи не бачить облікових даних вашого сховища. Він надсилає файли програмі Aktar на 127.0.0.1, а вона вивантажує їх за допомогою ключів зі Зв’язки ключів або Диспетчера облікових даних.

Локальний API Aktar вимкнено, доки ви його не ввімкнете, він ніколи не приймає з’єднань з інших комп’ютерів, і кожен запит потребує вашого токена. CLI зберігає його у файлі, який можете прочитати лише ви, і перед надсиланням перевіряє, що програма на порту справді Aktar.

Вимоги

  • Aktar для Mac версії 0.18.0 або Aktar для Windows 0.11.0 чи новіший, з принаймні однією ціллю (aktar 0.5.0 і давніші працюють з Aktar для Mac 0.4.0 або новішим)
  • Node.js 18 або новіший (Homebrew інсталює його за вас)
  • Повторне використання посилань на вже вивантажені файли: Aktar для Mac 0.10.0 або Aktar для Windows 0.3.0
  • aktar replace: aktar 0.3.0 і Aktar для Mac 0.14.0 або Windows 0.7.0
  • aktar mcp і aktar skill: aktar 0.4.0
  • Короткі посилання: aktar 0.5.0 та Aktar для Mac 0.17.0 або Windows 0.10.0
  • Відкритий код (MIT) на GitHub

Запитання

Чи працює CLI без програми Aktar?

Ні. Це пульт керування програмою: Aktar зберігає ключі сховища й виконує вивантаження, тож вона має бути запущена з увімкненим параметром «Дозволити локальні з’єднання». Саме тому CLI ніколи не потребує ваших ключів доступу.

Чи можна використовувати його в CI або на сервері?

Лише там, де працює Aktar, бо CLI звертається до неї на тому самому комп’ютері. На агенті збирання з Mac чи Windows це добре працює; на Linux-сервері використовуйте CLI свого провайдера.

Які сховища підтримуються?

Усі, що й в Aktar: Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO і будь-який S3-сумісний сервіс. Див. посібники з налаштування.

Чи можуть ними користуватися Claude, Cursor та інші ШІ-агенти?

Так. aktar mcp - це MCP-сервер: додайте його командою claude mcp add aktar -- aktar mcp --root ~/Projects (або JSON-конфігурацією з документації), і ваш агент зможе вивантажувати файли, шукати у ваших вивантаженнях і створювати тимчасові посилання. --root задає теку, з якої він може вивантажувати, секрети на кшталт SSH-ключів і файлів .env ніколи не вивантажуються, --allow-replace дозволяє замінювати файл зі збереженням посилання, а --read-only прибирає все, що щось записує. Для агентів без MCP aktar skill виводить навичку, яка вчить їх користуватися CLI.

Де зберігається токен?

У ~/.config/aktar/cli.json на Mac (%APPDATA%\aktar\cli.json у Windows), і прочитати його може лише ваш користувач. aktar logout видаляє його, а повторне створення токена в Aktar від’єднує всіх клієнтів.