- Командная строка
- 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
Показывает подключение, ваши места назначения и историю загрузок с поиском.
Настройка за минуту
- В Aktar для Mac или Windows откройте Настройки > Интеграции и включите Разрешить локальные подключения.
Скопируйте токен
Скопируйте показанный там токен.Запустите aktar login
Выполнитеaktar loginи вставьте его. Готово: теперьaktar uploadиспользует место назначения, выбранное в Aktar.
Создано для скриптов
Ссылки выводятся в стандартный вывод, по одной на строку, а все остальное в стандартный поток ошибок, поэтому URL=$(aktar upload build.zip) просто работает. --json дает все подробности, а код выхода сообщает, что произошло. В CI задайте AKTAR_TOKEN вместо входа.
| Код выхода | Код выхода |
|---|---|
| 0 | Все загружено |
| 1 | Как минимум одна загрузка не удалась, остальные прошли |
| 2 | Неверные аргументы или файл не найден, ничего не загружено |
| 3 | Aktar недоступен, токен неверный или приложение на порту не смогло доказать, что оно 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?
Можно ли использовать его в CI или на сервере?
Какие хранилища поддерживаются?
Могут ли ими пользоваться 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 отключает всех клиентов.Интеграции
Там, где вы уже работаете.
- Aktar для RaycastЗагружайте буфер обмена или выбранные файлы, ищите по истории с миниатюрами и просматривайте бакеты. Попросите Raycast AI дать ссылку на файл на 2 часа.Команды и настройка
- MCP-сервер для ИИ-агентовClaude, Cursor, VS Code и Codex загружают файлы, ищут по вашим загрузкам и создают ссылки, а ключи остаются в Aktar.Настроить агента
- Ваш бакет прямо в ObsidianВставляйте, перетаскивайте или переносите вложения в свой бакет. Ключи остаются на устройстве.Как работает плагин
