Repository navigation
Releases
Releases · getaktar/cli
Aktar CLI 0.6.0
Security
- Before sending the token,
aktarnow asks the app on the port to prove it
has the same token, so if Aktar isn't running and another program listens
on its port, it gets neither the token nor your files. Needs Aktar for Mac
0.18.0 or Aktar for Windows 0.11.0 or later; with an older Aktar,aktar
stops and asks you to update aktar mcponly uploads files from--root, or else from the folder it
runs in. Started in your home folder or at the top of the disk without
--root, it uploads no local files and says to add--rootaktar mcpnever uploads secrets, wherever they are: SSH and private keys,
.envfiles, cloud and package manager credentials, Aktar's own config,
the Keychain, browser profiles and password databases. Files with several
hard links are refused tooreplace_fileis no longer offered by default, since it overwrites a file
like a delete would: add--allow-replace(or--allow-delete)upload_clipboardis left out when--rootis given, since the clipboard
can hold anythingcreate_temporary_linkmakes links of at most 60 minutes; raise it with
--max-link-minutes- Tool results start with a note that file names, keys and messages in them
are data, not instructions, and lose control and text-direction characters aktar mcpopens each file once and reads it from there, so it can't be
swapped for another file after it was checked. On Windows, network and
device paths (\\host\share) are refused before anything touches them- Text from Aktar (file names, links, errors) is printed without control
characters, so a crafted file name can't send escape sequences to your
terminal aktar login --tokenwarns that the token can be seen by other programs
and stays in your shell history
Added
aktar mcp --log <file>appends each tool call to a file, to see later
what an agent didaktar mcpruns at most 4 tool calls at once
Changed
- The MCP setup examples, the skill and the MCP Registry entry pass
--root
Needs Aktar for Mac 0.18.0 or Aktar for Windows 0.11.0 or later. Release post: https://getaktar.com/changelog/0.18.0/
Aktar CLI 0.5.0
Added
- Short links, with the link shortener set up on a destination in Aktar:
aktar upload --shortmakes one even if the destination's rules would
skip it,--no-shortmakes none. The printed link, every--formatand
the--qrcode use the short link. If Aktar can't make it, the original
link is printed and stderr says why aktar short <upload-id|link>: makes a short link for an upload in
history (or prints the one it has), with--jsonand--qrshortUrlinaktar upload --jsonandaktar history --json(null when
there's none), and short links inaktar history.aktar qr <upload-id>
shows the short link when the upload has one, andaktar replacefinds
uploads by their short link too- MCP:
upload_fileandupload_clipboardtakeshort,search_uploads
and upload results haveshortUrl, and the newcreate_short_linktool
makes a short link for an upload (left out with--read-only)
Short links need Aktar for Mac 0.17.0 or Aktar for Windows 0.10.0.
npm install -g @getaktar/cli or brew install getaktar/tap/aktar-cli
aktar 0.4.0
Added
aktar mcp: a Model Context Protocol server on stdio for AI agents (Claude, Cursor, VS Code, Codex...). Tools:upload_file,upload_clipboard,replace_file,search_uploads,list_destinations,list_bucket,create_temporary_link,get_thumbnail,list_watched_folders,get_status, anddelete_uploadwith--allow-delete.--rootlimits uploads to folders,--read-onlyoffers only the tools that change nothing. Speaks the 2026-07-28 protocol and the earlierinitializeversions.aktar skill: prints an agent skill (SKILL.md) that teaches agents to use theaktarcommand, for agents without MCP.
claude mcp add aktar -- aktar mcpAktar CLI 0.3.0
Added
aktar replace <target> <file>: writes a new file over an upload, so its key and link stay the same.<target>is an upload ID or link fromaktar history, or a key in a destination's bucket with-d(the selected destination when left out). Prints the link likeaktar upload, with--format,--jsonand--qr. Needs Aktar for Mac 0.14.0 or Aktar for Windows 0.7.0- Uploads without
-dnow follow the destinations' Use For rules in Aktar for Mac 0.14.0 and later
Install: npm install -g @getaktar/cli or brew install getaktar/tap/aktar-cli
Aktar CLI 0.2.0
Added
aktar upload --name <name>: upload a single file under another name,
which is what the destination's path template and Aktar's history use.
The file's extension is added if the name has none. Works with--folderaktar upload --qr: prints a QR code of each link under it, drawn in the
terminal black on white whatever its themeaktar qr <text>: the QR code of a link or any text, or of an upload's
link given its ID fromaktar history.--png <file>saves it as a PNG- When Aktar reuses the link of a file that's already in the bucket instead
of uploading it again (Aktar for Mac 0.10.0, Windows 0.3.0),aktarsays
so on stderr, and--jsonhas"reused": true
Changed
- The README explains what Aktar handles per destination without any
options: WebP and AVIF images,{md5}and{sha256}in path templates,
and multipart uploads with resume for files past 5 GB
Install: npm i -g @getaktar/cli or brew install getaktar/tap/aktar-cli. Docs: https://getaktar.com/cli/
Aktar CLI 0.1.1
Changed
- The npm page shows the Aktar logo and a terminal demo, and links to https://getaktar.com/cli/ and the Homebrew formula (
brew install getaktar/tap/aktar-cli)
Aktar CLI 0.1.0
First release of the aktar command. Install with npm install -g @getaktar/cli (or run npx @getaktar/cli).
Added
aktar upload <files>: uploads through the Aktar app and prints one link per file, as a URL, Markdown, HTML or your custom template (--format), or everything as JSON (--json). Pick a destination by name or ID (--destination), upload into a folder (--folder), let the bucket delete the file after 1, 7, 14 or 30 days (--expires), or upload the clipboard (--clipboard)aktar loginandaktar logout, with the token from Aktar's Settings > Integrations, orAKTAR_TOKENandAKTAR_PORTaktar status,aktar destinationsandaktar history- Exit codes that tell failed uploads, bad arguments and connection problems apart
Requires Node.js 18 or later and Aktar for Mac 0.4.0 or later, or Aktar for Windows.