• Командная строка
  • 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

    Выводит Markdown, HTML или ваш собственный шаблон из Aktar вместо простого URL.

  • --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 отключает всех клиентов.