Обзор
aktar - это пульт управления приложением Aktar на том же компьютере. Вы передаете ему файлы, он отправляет их в Aktar на 127.0.0.1, а Aktar загружает их с теми местами назначения, ключами, шаблонами путей и настройками ссылок, которые вы уже задали. Ссылка возвращается в ваш терминал.
Что это
- Небольшая команда на Node.js для скриптов, CI-задач на вашем собственном Mac или компьютере с Windows и редакторов вроде Typora
- Способ загружать файлы и содержимое буфера обмена, показывать QR-коды и смотреть ваши места назначения и историю загрузок
- Бесплатно и с открытым исходным кодом (MIT), как и само приложение
Чем это не является
- Не самостоятельный инструмент: без запущенного Aktar он ничего не загрузит. Ключи от вашего хранилища у него никогда не хранятся
- Не для серверов на Linux и удаленных машин: он общается только с Aktar на том же компьютере. Там используйте CLI вашего провайдера хранилища
Требования
- Aktar для Mac 0.18.0 или Aktar для Windows 0.11.0 либо новее, хотя бы с одним местом назначения. aktar 0.5.0 и более ранние работают с Aktar для Mac 0.4.0 или новее
- Node.js 18 или новее (Homebrew установит его за вас)
-
Для
--name,--qrиaktar qrнужен aktar 0.2.0 или новее - Для повторного использования ссылки на уже загруженный файл нужны aktar 0.2.0 и Aktar для Mac 0.10.0 или Aktar для Windows 0.3.0
-
Для
aktar replaceнужны aktar 0.3.0 и Aktar для Mac 0.14.0 или Aktar для Windows 0.7.0 или новее -
Для
--short,--no-shortиaktar shortнужны aktar 0.5.0 и Aktar для Mac 0.17.0 или Aktar для Windows 0.10.0, а также сервис сокращения ссылок, настроенный для места назначения
Установка
Установите его один раз через npm или Homebrew. Оба способа добавляют команду aktar в ваш PATH.
Через npm (macOS и Windows)
npm install -g @getaktar/cliЧерез Homebrew (macOS)
brew install getaktar/tap/aktar-cliИли запустите один раз, ничего не устанавливая:
npx @getaktar/cli upload file.pngПроверьте, какая у вас версия:
aktar --version
0.6.0Подключение к Aktar
- В Aktar для Mac или Windows откройте Настройки › Интеграции и включите Разрешить локальные подключения. После этого Aktar слушает только
127.0.0.1, порт 47913, если вы не измените его там же. - Скопируйте токен, показанный под этим переключателем.
- Выполните
aktar loginи вставьте токен в ответ на запросToken:. При вводе он скрыт, а перед сохранением проверяется в Aktar, так что токен с опечаткой не сохранится.
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Где хранится токен
aktar login сохраняет токен и порт в ~/.config/aktar/cli.json на Mac (или в $XDG_CONFIG_HOME/aktar/cli.json, если эта переменная задана) и в %APPDATA%\aktar\cli.json в Windows. Прочитать файл может только ваш пользователь.
Перед отправкой токена aktar просит приложение на порту доказать, что у него тот же токен, не отправляя его. Поэтому если Aktar не запущен, а его порт слушает другая программа, она не получит ни токен, ни ваши файлы. Для этого нужен Aktar для Mac 0.18.0 или Aktar для Windows 0.11.0 либо новее; со старой версией Aktar aktar останавливается и просит обновиться.
aktar logout удаляет этот файл. Чтобы сразу отключить все клиенты, нажмите Создать заново рядом с токеном в Aktar, а затем снова выполните aktar login с новым токеном.
Скрипты и CI
На сборочной машине пропустите aktar login и задайте AKTAR_TOKEN (и AKTAR_PORT, если вы меняли порт). Они важнее сохраненного файла. Aktar должен быть запущен на этой машине в той же пользовательской сессии.
AKTAR_TOKEN="$AKTAR_SECRET" aktar upload dist/app.zip -d Builds| Переменная | Для чего она |
|---|---|
AKTAR_TOKEN | Токен из Настройки › Интеграции в Aktar. Используется вместо сохраненного. |
AKTAR_PORT | Порт локального API Aktar, если вы его меняли. --port важнее. |
NO_COLOR | Рисует QR-коды обычными символами вместо цветов терминала. |
XDG_CONFIG_HOME | Где находится папка конфигурации в macOS (по умолчанию ~/.config). В Windows используется %APPDATA%. |
Команды
Все команды обращаются к Aktar, кроме aktar qr с обычным текстом или ссылкой. Без -d файлы загружаются в место назначения, выбранное в строке меню Aktar, и появляются в истории Aktar, как и все остальные. aktar --help выводит тот же список. С Aktar для Mac 0.14.0 или Aktar для Windows 0.7.0 и новее загрузка без -d сначала следует правилам Использовать для мест назначения, так что изображение может уйти в место назначения для скриншотов, а сборка в другое.
aktar uploadaktar upload --clipboardaktar replaceaktar shortaktar qraktar loginaktar logoutaktar statusaktar destinationsaktar historyaktar mcpaktar skill
aktar upload
Загружает один или несколько файлов и выводит по одной ссылке на файл, по порядку, по мере завершения загрузки каждого.
Использование
aktar upload <file>... [options]Параметры
| Флаг | Значение | Описание |
|---|---|---|
-d, --destination | <name|id> | Место назначения для загрузки, по имени или ID. По умолчанию то, что выбрано в Aktar. |
-f, --format | <format> | Что выводить: url (по умолчанию), markdown, html или custom (ваш шаблон в Aktar). |
--name | <name> | Загрузить один файл под этим именем. Если у имени нет расширения, сохраняется расширение файла. |
--folder | <path> | Сохранить имя файла и загрузить его в эту папку. |
--expires | <days> | Бакет удалит файл через 1, 7, 14 или 30 дней. 0 сохраняет его. |
--short | Создать короткую ссылку сервисом места назначения, даже если его правила пропустили бы эту загрузку. | |
--no-short | В этот раз не создавать короткую ссылку. | |
--qr | Дополнительно вывести QR-код каждой ссылки. | |
--json | Вывести вместо ссылок JSON-массив со всеми сведениями о каждой загрузке. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Перед загрузкой проверяется каждый файл: если какого-то нет, ничего не загружается, и
aktarзавершается с кодом 2. - Если одна загрузка не удалась, остальные все равно выполняются. О каждой ошибке сообщается в stderr, а код завершения равен 1.
- Без
--folderимя файлу дает шаблон пути места назначения, как при перетаскивании в строку меню. С--folderфайл сохраняет свое имя внутри этой папки. --nameработает только с одним файлом за раз. Косые черты удаляются, а если у имени нет расширения, добавляется расширение файла:--name coverзагрузитIMG_4021.jpgкакcover.jpg. С--folderэто имя внутри папки.--expiresпринимает 1, 7, 14 или 30 (дней) либо 0, чтобы сохранить файл. Без этого параметра файл сохраняется, что бы ни было выбрано в Удалить через в Aktar. Для него нужны правила автоудаления Aktar в этом месте назначения, и его нельзя сочетать с--folder.--qrнельзя сочетать с--json, а--pngработает только сaktar qr.- В терминале во время загрузки файла прогресс показывается в stderr. Файл передается в Aktar потоком, поэтому его размер не важен, и ограничения по времени нет.
- Если для места назначения в Aktar настроен сервис сокращения ссылок, выводится короткая ссылка, и
--formatи--qrиспользуют ее.--shortсоздает ее, даже если правила места назначения пропустили бы эту загрузку,--no-shortне создает. Если Aktar не может ее создать, выводится исходная ссылка, а причина пишется в stderr.
Примеры
aktar upload screenshot.png
https://files.example.com/2026/10/7f3c2a91.pngaktar upload *.png -f markdown

aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpgaktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpgaktar upload talk.pdf --short
https://s.example.com/k3Tq9aktar upload --clipboard
Загружает файл или изображение из буфера обмена, как собственное сочетание клавиш Aktar для буфера обмена.
Использование
aktar upload --clipboard [options]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--clipboard | Загрузить содержимое буфера обмена вместо файлов. | |
-d, --destination | <name|id> | Место назначения для загрузки, по имени или ID. По умолчанию то, что выбрано в Aktar. |
-f, --format | <format> | Что выводить: url (по умолчанию), markdown, html или custom (ваш шаблон в Aktar). |
--expires | <days> | Бакет удалит файл через 1, 7, 14 или 30 дней. 0 сохраняет его. |
--short | Создать короткую ссылку сервисом места назначения, даже если его правила пропустили бы эту загрузку. | |
--no-short | В этот раз не создавать короткую ссылку. | |
--qr | Дополнительно вывести QR-код каждой ссылки. | |
--json | Вывести вместо ссылок JSON-массив со всеми сведениями о каждой загрузке. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Передайте файлы или
--clipboard, но не то и другое сразу. --nameи--folderработают только с файлами.-d,-f,--expires,--qrи--jsonработают так же, как с файлами.- С
--jsonвыводится все тот же массив, с одной записью.
Примеры
aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.pngaktar upload --clipboard -f markdown -d Blog
aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.pngaktar replace
Записывает новый файл поверх загрузки, так что ее ключ и ссылка остаются прежними. Все, у кого есть ссылка, увидят новый файл.
Использование
aktar replace <upload-id|link|key> <file> [options]Параметры
| Флаг | Значение | Описание |
|---|---|---|
-d, --destination | <name|id> | Для ключа: место назначения, в бакете которого он лежит, по имени или ID. По умолчанию то, что выбрано в Aktar. |
-f, --format | <format> | Что выводить: url (по умолчанию), markdown, html или custom (ваш шаблон в Aktar). |
--qr | Дополнительно вывести QR-код каждой ссылки. | |
--json | Вывести вместо ссылок JSON-массив со всеми сведениями о каждой загрузке. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Первый аргумент - ID загрузки или ссылка из
aktar history(запись в истории Aktar обновляется), иначе ключ в бакете места назначения-d(если его не указать, то места назначения, выбранного в Aktar). Ссылка, которой нет в истории Aktar, отклоняется: вместо нее передайте ее ключ с-d. - Aktar удаляет метаданные файла и меняет его размер так, как задано в месте назначения, но никогда не конвертирует его в другой формат, поэтому расширение ключа сохраняется. Для файла в
tmp/{N}d/отсчет N дней начинается заново. - К ключу никогда не добавляется номер, и больше ничего не загружается.
--folder,--expires,--nameи--clipboardздесь неприменимы и отклоняются. - Старые копии могут еще какое-то время оставаться в кэше CDN. С этим справляются Короткое время кэша места назначения или очистка кэша Cloudflare в Aktar.
- Нужен Aktar для Mac 0.14.0 или Aktar для Windows 0.7.0 или новее.
Примеры
aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdfaktar replace docs/guide.pdf guide.pdf -d Blog -f markdown
[guide.pdf](https://blog-assets.example.com/docs/guide.pdf)aktar short
Создает короткую ссылку для загрузки из истории с помощью сервиса сокращения ссылок ее места назначения и выводит ее. Если у загрузки она уже есть, выводится она.
Использование
aktar short <upload-id|link> [--json | --qr]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--json | Вывести сведения о короткой ссылке в JSON: сервис, статус и переходы. | |
--qr | Также вывести QR-код короткой ссылки. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Передайте ID загрузки или ссылку из
aktar history; короткая ссылка тоже подойдет.aktarищет среди последних 1000 загрузок. - Для места назначения нужен сервис сокращения ссылок в разделе Короткие ссылки в Aktar: Shlink, YOURLS, Kutt, Dub, Short.io или свой запрос. Короткую ссылку создает этот сервис, поэтому ваши ссылки и данные о переходах остаются в вашей инфраструктуре.
--jsonвыводит сведения о короткой ссылке: сервис, статус, а также переходы и последний переход, если сервис их считает.--qrдобавляет ее QR-код. Их нельзя совмещать.- Нужен Aktar для Mac 0.17.0 или Aktar для Windows 0.10.0. Более старые версии отвечают, что пока не создают короткие ссылки.
Примеры
aktar short 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1
https://s.example.com/Qm3xZaktar qr
Показывает в терминале QR-код ссылки или любого текста, чтобы открыть его на телефоне. Если передать ID загрузки, показывает ссылку этой загрузки и ее QR-код.
Использование
aktar qr <link|text|upload-id> [--png <file>]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--png | <file> | Сохранить QR-код в PNG-файл вместо вывода на экран. |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Передайте ровно один аргумент, а текст с пробелами заключите в кавычки.
- ID загрузки - это
idизaktar history --jsonилиaktar upload --json.aktarищет его среди последних 1000 загрузок в истории Aktar; для обычного текста или ссылки Aktar вообще не нужен. - В терминале код рисуется черным по белому, какой бы ни была тема. Если вывод идет не в терминал или задана
NO_COLOR, он рисуется без цветов. --pngсохраняет QR-код в PNG вместо вывода на экран.- Для загрузки с короткой ссылкой показывает короткую ссылку.
Примеры
aktar qr https://files.example.com/2026/10/demo.mp4aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.pngaktar login
Проверяет токен в Aktar и сохраняет его, чтобы остальные команды могли подключаться.
Использование
aktar login [--token <token>] [--port <port>]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--token | <token> | Токен вместо запроса. |
--port | <port> | Порт Aktar, сохраняется вместе с токеном. По умолчанию 47913. |
Полезно знать
- В терминале команда запрашивает токен и скрывает то, что вы вводите. Если ввод передан через конвейер, токен читается оттуда.
--tokenпозволяет обойтись без запроса, но пока команда выполняется, токен видят другие программы, и он попадает в историю оболочки, поэтомуaktarпредупреждает об этом. Передача через конвейер илиAKTAR_TOKENэтого избегают.- Токен, который Aktar отклонил, не сохраняется, а код завершения равен 3.
Примеры
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.jsonpbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.jsonaktar предупреждает, что токен был виден.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.jsonaktar logout
Удаляет сохраненные токен и порт.
Использование
aktar logoutПараметры
Без параметров.
Полезно знать
AKTAR_TOKEN, если он задан, продолжает работать и послеaktar logout.- Другие клиенты при этом не отключаются. Для этого создайте токен в Aktar заново.
Примеры
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
Показывает, к какому Aktar вы подключены, через какой порт, какое место назначения выбрано в Aktar и где находится файл конфигурации.
Использование
aktar status [--json]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--json | Вывести JSON вместо текста. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Быстрый способ проверить подключение в скрипте: команда завершается с кодом 3, если Aktar недоступен или токен неверный.
Примеры
aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.jsonaktar status --json
{
"app": "Aktar",
"version": "0.10.0",
"build": "28",
"apiVersion": 1,
"defaultDestinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
"outputFormat": "url",
"port": 47913
}aktar destinations
Выводит список ваших мест назначения с провайдером, бакетом и ID. * отмечает то, что выбрано в Aktar.
Использование
aktar destinations [--json]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--json | Вывести JSON вместо текста. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Передавайте в
-dимя или ID. Имена сравниваются без учета регистра; ID работает всегда, даже после переименования. --jsonвыдает для каждогоid,name,provider,providerName,bucket,publicBaseURLиisDefault.
Примеры
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-9D5F2A7E4B13aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshotsaktar history
Выводит недавние загрузки, сначала новые: дату, имя файла и ссылку. Слова после history ищутся в истории.
Использование
aktar history [search] [options]Параметры
| Флаг | Значение | Описание |
|---|---|---|
-n, --limit | <n> | Сколько загрузок вывести. По умолчанию 20. |
-d, --destination | <name|id> | Только загрузки в это место назначения, по имени или ID. |
--json | Вывести JSON вместо текста. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Выводится 20 загрузок, если не передать
-n. --jsonвыдает те же поля, что иaktar upload --json, включаяidкаждой загрузки дляaktar qr.
Примеры
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.pdfaktar 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.pdfaktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zipaktar mcp
Запускает сервер Model Context Protocol (MCP), чтобы ИИ-агенты, такие как Claude, Cursor, VS Code и Codex, могли загружать файлы через Aktar, находить прошлые загрузки и создавать ссылки. Добавьте его в агента один раз; агент запустит его сам, когда он понадобится.
Использование
aktar mcp [--root <folder>]... [--read-only | --allow-replace | --allow-delete] [--max-link-minutes <n>] [--log <file>]Параметры
| Флаг | Значение | Описание |
|---|---|---|
--root | <folder> | Загружать файлы только из этой папки. Повторите флаг для других папок. По умолчанию: папка, в которой запущен сервер, или никакая, если это домашняя папка или корень диска. |
--read-only | Предлагать только инструменты, которые ничего не меняют в бакете: поиск, списки, временные ссылки и миниатюры. | |
--allow-replace | Также предлагать replace_file, который перезаписывает файл в бакете. | |
--allow-delete | Также предлагать delete_upload, который удаляет файл из бакета, и replace_file. | |
--max-link-minutes | <n> | Максимальный срок действия временной ссылки в минутах. По умолчанию 60, не больше 10080 (7 дней). |
--log | <file> | Дописывать каждый вызов инструмента (время, инструмент, аргументы, результат) в этот файл, доступный для чтения только вам. |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Полезно знать
- Сначала выполните
aktar login. Сервер читает сохраненный токен при каждом вызове, поэтому повторный вход работает без перезапуска агента. - Загрузка публикует файл: любой, у кого есть ссылка, сможет его открыть. Агенты спрашивают разрешение перед вызовом инструмента, если вы не разрешите заранее.
- Файлы загружаются только из папок, указанных в
--root, а без него из папки, в которой запущен сервер. Если это ваша домашняя папка или корень диска, как бывает у некоторых приложений, локальные файлы не загружаются, пока вы не добавите--root.--root ~разрешает всю домашнюю папку, если вам действительно это нужно. Пути разрешаются, включая символические ссылки, до проверки. - Секреты не загружаются никогда, где бы они ни лежали: SSH и закрытые ключи, файлы
.env, учетные данные облаков и менеджеров пакетов (~/.aws,~/.kube,~/.npmrcи другие), конфигурация самого Aktar, Связка ключей, профили браузеров и базы паролей. Файлы с несколькими жесткими ссылками тоже отклоняются. Чтобы поделиться таким файлом, загрузите его сами черезaktar upload. --read-onlyоставляет только инструменты, которые ничего не меняют в бакете.replace_fileперезаписывает файл, как и удаление, поэтому предлагается только с--allow-replace, аdelete_uploadтолько с--allow-delete(который также предлагаетreplace_file).create_temporary_linkсоздает ссылки не дольше 60 минут, если--max-link-minutesне разрешает больше.upload_clipboardне предлагается, если указан--root, ведь в буфере обмена может быть что угодно.- Результаты инструментов начинаются с пометки, что имена файлов, ключи и сообщения в них являются данными, а не инструкциями, а
--logзаписывает каждый вызов. Одновременно выполняется не более 4 вызовов инструментов. - Без глобальной установки используйте в качестве команды
npx -y @getaktar/cli mcp --root ~/Projects. - Он поддерживает текущую версию MCP (2026-07-28) и более ранние, начинающиеся с
initialize(с 2024-11-05 по 2025-11-25), через stdio. Нужен aktar 0.4.0; описанные выше ограничения появились в aktar 0.6.0.
Инструменты
| Инструмент | Что делает |
|---|---|
upload_file | Загружает файл и возвращает его ссылку, Markdown и HTML. Место назначения, имя, папка и срок действия необязательны. short запрашивает короткую ссылку или отказывается от нее. |
upload_clipboard | Загружает файл или изображение из буфера обмена. short запрашивает короткую ссылку или отказывается от нее. Не предлагается, если указан --root. |
replace_file | Записывает новый файл поверх загрузки или любого файла в бакете, сохраняя его ссылку. Только с --allow-replace или --allow-delete. Нужен Aktar для Mac 0.14.0 или Windows 0.7.0. |
create_short_link | Создает короткую ссылку для загрузки сервисом сокращения ссылок ее места назначения или возвращает уже существующую. Не предлагается с --read-only. Нужен Aktar для Mac 0.17.0 или Windows 0.10.0. |
search_uploads | Ищет по истории загрузок. |
list_destinations | Выводит места назначения и типы файлов, для которых используется каждое из них. |
list_bucket | Выводит папки и файлы бакета, включая файлы, загруженные не через Aktar. |
create_temporary_link | Создает ссылку, которая перестает работать через некоторое время (presigned URL). До этого момента любой, у кого она есть, может скачать файл, даже из закрытого бакета. Не дольше 60 минут, если --max-link-minutes не разрешает больше. |
get_thumbnail | Показывает агенту превью загрузки. Нужен Aktar для Mac 0.13.0 или Windows 0.6.0. |
list_watched_folders | Выводит отслеживаемые папки и их состояние. |
get_status | Проверяет соединение с Aktar. |
delete_upload | Удаляет загрузку из бакета. Только с --allow-delete. |
Примеры
claude mcp add aktar -- aktar mcp --root ~/Projects
codex mcp add aktar -- aktar mcp --root ~/Projectsclaude mcp add aktar -- aktar mcp --root ~/Projects --root ~/Desktop --allow-replaceclaude mcp add aktar -- aktar mcp --root ~/Projects --log ~/aktar-mcp.logaktar skill
Выводит навык агента (SKILL.md), который учит агентов пользоваться командой aktar с --json: что запускать, как читать результат и загружать только то, чем вы просили поделиться. Для агентов, которые используют навыки, но не MCP.
Использование
aktar skillПараметры
Без параметров.
Полезно знать
- Сохраните его там, где ваш агент ищет навыки, например в
~/.claude/skills/aktar/для Claude Code.
Примеры
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.mdПараметры для всех команд
| Флаг | Значение | Описание |
|---|---|---|
-h, --help | Показать список команд и параметров. | |
-v, --version | Показать версию aktar. | |
--port | <port> | Порт локального API Aktar, только для этой команды. Важнее AKTAR_PORT и сохраненного порта. |
Вывод
Форматы
-f выбирает, что выводится для каждой загрузки. Без него aktar выводит обычный URL, в каком бы формате ни копировала строка меню Aktar. Markdown и HTML встраивают изображения и дают ссылку на все остальное, так же как это делает Aktar.
| Формат | Вывод для photo.jpg |
|---|---|
-f url | https://files.example.com/2026/10/7f3c2a91.jpgСсылка (по умолчанию). |
-f markdown | Изображение в Markdown или ссылка в Markdown для остальных файлов. |
-f html | <img src="https://files.example.com/2026/10/7f3c2a91.jpg" alt="">Тег <img> или ссылка <a> для остальных файлов. |
-f custom | Ваш шаблон из настроек Aktar, с подставленными {url}, {filename} и другими переменными. |
stdout и stderr
В стандартный вывод попадают только ссылки, по одной на строку, в порядке файлов (и QR-коды, с --qr). Все остальное идет в стандартный поток ошибок: прогресс, ошибки и примечания вроде aktar: photo.jpg: already uploaded, reused the existing link. Поэтому url=$(aktar upload file) и aktar upload *.png > links.txt всегда получают чистые ссылки.
aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpgJSON
--json выводит массив с одной записью на каждый загруженный файл, когда загрузятся все. Неудачные загрузки в него не попадают (о них сообщается в stderr), поэтому проверяйте и код завершения.
aktar upload photo.jpg --json
[
{
"id": "0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1",
"filename": "photo.jpg",
"objectKey": "2026/10/7f3c2a91.jpg",
"url": "https://files.example.com/2026/10/7f3c2a91.jpg",
"shortUrl": null,
"destinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
"destinationName": "Screenshots",
"mimeType": "image/jpeg",
"size": 482113,
"createdAt": "2026-10-01T12:00:00Z",
"expiresAt": null,
"formats": {
"url": "https://files.example.com/2026/10/7f3c2a91.jpg",
"markdown": "",
"html": "<img src=\"https://files.example.com/2026/10/7f3c2a91.jpg\" alt=\"\">",
"custom": ""
},
"reused": false
}
]| Поле | Значение |
|---|---|
id | ID загрузки в истории Aktar. Его принимает aktar qr. |
filename | Имя файла, под которым его знает Aktar: собственное имя файла или --name. |
objectKey | Где файл лежит в бакете. |
url | Ссылка. |
shortUrl | Короткая ссылка или null, если ее нет. formats уже используют ее. |
destinationId | ID места назначения. |
destinationName | Имя места назначения. |
mimeType | Тип файла после возможной конвертации в Aktar. |
size | Размер в байтах в том виде, в каком файл сохранен. |
createdAt | Когда файл был загружен (ISO 8601, UTC). |
expiresAt | Когда бакет удалит файл, или null, если файл сохраняется. |
replacedAt | Когда файл в последний раз заменяли (ISO 8601, UTC). Отсутствует, пока файл не заменен, а также в версиях Aktar до Mac 0.14.0 и Windows 0.7.0. |
formats | Ссылка во всех четырех форматах: url, markdown, html и custom. |
reused | true, если ничего не загружалось, потому что такой же файл уже был на месте. Отсутствует в версиях Aktar до Mac 0.10.0 и Windows 0.3.0. |
shortLinkError | Почему Aktar не смог создать короткую ссылку; url тогда содержит исходную ссылку. Отсутствует, если все прошло хорошо. |
Коды завершения
| Код | Значение |
|---|---|
0 | Все прошло успешно. |
1 | Хотя бы одна загрузка или запрос не удались; остальные все равно выполнились. Сюда же относятся ошибки самого Aktar, например ненастроенное автоудаление. |
2 | Неверные аргументы, несуществующий файл или имя места назначения, которого нет в Aktar. Ничего не загружено. |
3 | Вход не выполнен, Aktar не запущен, его локальный API выключен, токен неверный или приложение на порту не смогло доказать, что оно Aktar (или слишком старое для этого). |
Рецепты
Скопируйте, поправьте имена файлов, готово. В каждом рецепте используется только то, что описано выше.
Сохранить ссылку в переменную
В стандартный вывод попадает только ссылка, поэтому подстановка команды получает ровно URL. || exit 1 останавливает скрипт, если загрузка не удалась.
url=$(aktar upload build/report.pdf) || exit 1
echo "Report: $url"
Report: https://files.example.com/2026/10/0e7d51b3.pdfЗагрузить сборку и отправить ссылку
Упакуйте сборку в zip, загрузите ее в место назначения с именем Builds под коротким хешем коммита и отправьте ссылку в любой вебхук, принимающий JSON (канал чата, трекер задач, ваш собственный эндпоинт). set -e остановит скрипт до отправки, если загрузка не удастся.
#!/bin/sh
set -e
zip -qr app.zip dist
url=$(aktar upload app.zip -d Builds --name "app-$(git rev-parse --short HEAD)")
curl -fsS -X POST "$WEBHOOK_URL" \
-H 'Content-Type: application/json' \
-d "{\"text\": \"New build: $url\"}"Цель в Makefile
make share загружает отчет под сегодняшней датой и сохраняет ссылку в .last-link. В Makefile $$ передает оболочке $, а строка команды начинается с табуляции.
Загрузчик изображений для Typora
В Typora откройте Settings > Image («Настройки › Изображение»), выберите в качестве загрузчика изображений Custom Command («Пользовательская команда») и введите полный путь к aktar (тот, что выводит which aktar), а за ним upload. Typora передает пути к изображениям и читает по одной ссылке на строку.
/opt/homebrew/bin/aktar uploadПошагово, с настройкой When Insert… («При вставке»): Загрузка изображений из Typora в S3.
Загрузка из Finder или «Быстрых команд»
На Mac добавьте действие Run Shell Script («Запустить скрипт оболочки») в быструю команду или в быстрое действие Automator, которое получает файлы в Finder, и настройте передачу ввода как аргументов. «Быстрые команды» и Automator не загружают PATH вашей оболочки, отсюда первая строка. Выберите файлы, запустите, и ссылки окажутся в буфере обмена.
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
aktar upload "$@" | pbcopy
osascript -e 'display notification "Link copied" with title "aktar"'Загружаются файлы, а не папки. Несколько файлов дают несколько ссылок, по одной на строку.
Временные файлы
Лог, запись экрана или что-то еще, что не должно храниться долго, пусть удалит бакет. Сначала месту назначения нужны правила автоудаления Aktar: настройте их один раз через Удалить через в строке меню Aktar или в настройках места назначения.
aktar upload crash.log --expires 1
aktar upload screen-recording.mov --expires 7 --qrФайлы со сроком хранения попадают в бакете в tmp/1d/, tmp/7d/ и так далее, и бакет удаляет их, даже когда Aktar не запущен.
Открыть ссылку на телефоне
--qr выводит под ссылкой QR-код; наведите камеру телефона на терминал. Чтобы показать его позже снова, передайте ID загрузки в aktar qr, здесь это последняя загрузка, подходящая под «demo».
aktar upload demo.mp4 --qr
aktar qr "$(aktar history demo -n 1 --json | jq -r '.[0].id')"Windows PowerShell
В PowerShell все работает так же. $LASTEXITCODE содержит код завершения, а ConvertFrom-Json читает --json.
Aktar в Claude Desktop, Cursor или VS Code
Приложениям, которые принимают JSON-конфигурацию для MCP-серверов (Claude Desktop, Cursor, Windsurf и другим), нужна эта запись. VS Code использует такую же запись в разделе servers файла .vscode/mcp.json. Затем попросите агента загрузить файл, найти скриншоты за прошлую неделю или создать временную ссылку.
Если приложение не находит aktar, укажите полный путь (which aktar) или npx с аргументами ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"]. После --root укажите папку, из которой агент может загружать файлы (в Windows, например, C:\\Users\\you\\Projects).
Что Aktar делает за вас
CLI только передает файлы; все остальное делает Aktar с настройками каждого места назначения. Поэтому все, что вы настроили в приложении, действует и для aktar upload без дополнительных параметров, а ссылка, которую вы получаете, ведет на файл в том виде, в каком он сохранен.
-
Шаблоны путей
Имя файлу дает путь объекта в месте назначения, с
{year},{uuid},{filename}и остальными переменными.{md5}и{sha256}называют файлы по их содержимому. -
Обработка изображений
Если место назначения конвертирует изображения в WebP или AVIF, сжимает их или меняет размер, с загрузками из CLI происходит то же самое, а ссылка ведет на конвертированный файл.
-
Метаданные фото
Метаданные изображений в настройках загрузки места назначения удаляют из фото геопозицию или все метаданные еще до того, как они покинут ваш компьютер.
-
Тот же файл, та же ссылка
Если включено Повторно использовать ссылки для дубликатов файлов, одинаковое содержимое в одном месте назначения получает уже существующую ссылку вместо повторной загрузки.
aktarсообщает об этом в stderr. -
Большие файлы
Большие файлы загружаются частями, без ограничения в 5 ГБ, повторно отправляются после обрыва соединения и продолжаются с того места, где остановились.
aktarпередает файл в Aktar потоком, поэтому никогда не загружает его в память целиком. -
Публичные или временные ссылки
Будет ли ссылка публичной или временной (presigned), которая работает и для приватного бакета, решает место назначения, как и в приложении.
Ссылки для дубликатов, обработка изображений, {md5} и {sha256} и загрузка частями появились в Aktar для Mac 0.10.0 и Windows 0.3.0: что нового в 0.10.0.
Решение проблем
Сообщения об ошибках aktar начинаются с aktar: и выводятся в stderr. Код завершения подсказывает, что это за проблема.
Aktar isn't running, or its local API is turned off
Откройте Aktar и проверьте, что в Настройки › Интеграции включено Разрешить локальные подключения. Если вы меняли там порт, передайте его через --port или AKTAR_PORT либо снова выполните aktar login --port. Код завершения 3.
Not connected to Aktar yet
Нет ни сохраненного токена, ни AKTAR_TOKEN. Выполните aktar login с токеном из Настройки › Интеграции в Aktar. Код завершения 3.
The token doesn't match Aktar's anymore
Токен был создан в Aktar заново или введен с ошибкой. Снова выполните aktar login с текущим токеном. Если задан AKTAR_TOKEN, он важнее сохраненного токена, поэтому обновите или удалите и его. Код завершения 3.
The app on port … couldn't prove it's Aktar
Что-то ответило на порту Aktar, но не смогло показать, что у него есть ваш токен, поэтому токен не был отправлен. Если Aktar запущен, его токен, скорее всего, изменился: снова выполните aktar login. Если Aktar не запущен, откройте его. Код завершения 3.
This version of Aktar can't prove it's Aktar
aktar 0.6.0 и новее проверяют приложение перед отправкой токена, а для этого нужен Aktar для Mac 0.18.0 или Aktar для Windows 0.11.0 либо новее. Обновите Aktar (он сам предлагает обновления), и команда снова заработает. Код завершения 3.
MCP: This server doesn't upload local files
Агент запустил aktar mcp в вашей домашней папке или в корне диска, а --root не указан. Добавьте в команду или конфигурацию сервера --root с папкой, из которой можно брать файлы, например aktar mcp --root ~/Projects, и перезапустите агента.
Auto-delete isn't set up for this destination
Для --expires нужны правила автоудаления в бакете. Настройте их один раз через Удалить через в строке меню Aktar или в настройках места назначения либо загружайте без --expires. Код завершения 1.
No destination named "…"
В сообщении перечислены имена, которые есть в Aktar. Проверьте написание, заключите имена с пробелами в кавычки (-d "Client work") или используйте ID из aktar destinations. Код завершения 2.
Большая загрузка идет долго
Это скорость провайдера хранилища: у aktar нет ограничения по времени для загрузок, а в терминале он показывает прогресс в stderr. Не закрывайте Aktar, пока загрузка не завершится. Если соединение оборвалось или Aktar закрылся (Aktar closed the connection before the request finished), загрузите тот же файл еще раз: Aktar для Mac 0.10.0 и Windows 0.3.0 продолжат с последней части.
aktar не запускается: SyntaxError или parseArgs
Ваш Node.js старше версии 18. Проверьте с помощью node --version и обновите его или установите aktar через Homebrew, который приносит собственный Node.js.
PowerShell сообщает, что выполнение сценариев отключено
Политика выполнения PowerShell блокирует скрипт, который npm устанавливает для aktar. Запускайте вместо него aktar.cmd или один раз разрешите локальные скрипты командой Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
