aktar CLIドキュメント

aktar upload

1つ以上のファイルをアップロードし、完了するたびにファイルの順にリンクを1つずつ出力します。

使い方

$ aktar upload <file>... [options]

オプション

知っておきたいこと

• アップロードを始める前にすべてのファイルを確認します。存在しないファイルが1つでもあれば何もアップロードせず、aktarは終了コード2で終了します。
• 1つのアップロードが失敗しても、ほかはそのまま続きます。失敗はそれぞれstderrに出力され、終了コードは1になります。
• --folderを付けなければ、メニューバーにドロップしたときと同じく、アップロード先のパステンプレートでファイル名が決まります。--folderを付けると、そのフォルダの中で元のファイル名のままになります。
• --nameは1回に1ファイルだけに使えます。スラッシュは取り除かれ、名前に拡張子がなければ元のファイルの拡張子が付きます。--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.png

$ aktar upload *.png -f markdown
![](https://files.example.com/2026/10/1b9e44d0.png)
![](https://files.example.com/2026/10/c2f71a5e.png)

$ aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpg

$ aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpg

$ aktar upload talk.pdf --short
https://s.example.com/k3Tq9

aktar upload --clipboard

Aktar自身のクリップボードショートカットと同じく、クリップボードにあるファイルや画像をアップロードします。

使い方

$ aktar upload --clipboard [options]

オプション

知っておきたいこと

• ファイルか--clipboardのどちらか一方を指定します。両方は指定できません。
• --nameと--folderはファイルでのみ使えます。-d、-f、--expires、--qr、--jsonはファイルのときと同じように使えます。
• --jsonを付けた場合も、出力は要素が1つの配列です。

例

$ aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.png

$ aktar upload --clipboard -f markdown -d Blog
![](https://blog-assets.example.com/2026/10/e5b2c8a4.png)

$ aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.png

aktar replace

アップロード済みのファイルを新しいファイルで上書きし、キーとリンクはそのままにします。リンクを持つ人には新しいファイルが表示されます。

使い方

$ aktar replace <upload-id|link|key> <file> [options]

オプション

知っておきたいこと

• 最初の引数は aktar history のアップロード ID かリンク (Aktar の履歴も更新されます)、それ以外は -d のバケット内のキーです (-d を省くと Aktar で選択中のアップロード先)。Aktar の履歴にないリンクは拒否されるので、代わりにキーを -d と一緒に指定します。
• Aktar はアップロード先の設定どおりにメタデータを削除しサイズを変更しますが、別の形式には変換しないので、キーの拡張子は変わりません。tmp/{N}d/ の下のファイルは N 日のカウントがやり直しになります。
• キーに番号が付くことはなく、ほかには何もアップロードされません。--folder、--expires、--name、--clipboard は使えず、拒否されます。
• 古いコピーがしばらく CDN のキャッシュに残ることがあります。Aktar のアップロード先の 短いキャッシュ時間 か Cloudflare のキャッシュ消去で解決できます。
• Aktar for Mac 0.14.0 または Aktar for Windows 0.7.0 以降が必要です。

例

$ aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar 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]

オプション

知っておきたいこと

• アップロードID、またはaktar historyのリンクを渡します。短縮リンクでもかまいません。aktarは直近1,000件のアップロードから探します。
• アップロード先に、Aktarの短縮リンクセクションで短縮サービスを設定しておく必要があります: Shlink、YOURLS、Kutt、Dub、Short.io、またはカスタムリクエスト。短縮リンクはその短縮サービスが作成するので、リンクとクリックのデータはご自身のインフラに残ります。
• --jsonは短縮リンクの詳細を出力します: プロバイダー、状態、短縮サービスが数えていればクリック数と最終クリック。--qrはQRコードを追加します。この2つは同時に使えません。
• Mac版Aktar 0.17.0またはWindows版Aktar 0.10.0が必要です。古いバージョンは、まだ短縮リンクを作成できないと応答します。

例

$ aktar short 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1
https://s.example.com/Qm3xZ

aktar qr

リンクや任意のテキストのQRコードをターミナルに表示し、スマートフォンで開けるようにします。アップロードIDを渡すと、そのアップロードのリンクとQRコードを表示します。

使い方

$ aktar qr <link|text|upload-id> [--png <file>]

オプション

知っておきたいこと

• 引数はちょうど1つ渡します。スペースを含むテキストは引用符で囲んでください。
• アップロードIDは、aktar history --jsonやaktar upload --jsonのidです。aktarはAktarの履歴の直近1,000件から探します。プレーンテキストやリンクなら、Aktarはまったく必要ありません。
• ターミナルでは、テーマにかかわらず白地に黒でコードを描きます。出力先がターミナルでない場合やNO_COLORが設定されている場合は、色を使わずに描きます。
• --pngを付けると、QRコードを表示する代わりにPNGとして保存します。
• 短縮リンクがあるアップロードでは、短縮リンクを表示します。

例

$ aktar qr https://files.example.com/2026/10/demo.mp4

$ aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.png

aktar login

トークンをAktarで確認して保存し、ほかのコマンドが接続できるようにします。

使い方

$ aktar login [--token <token>] [--port <port>]

オプション

知っておきたいこと

• ターミナルではトークンの入力を求め、入力内容は表示されません。パイプで入力が渡された場合は、そこからトークンを読み取ります。
• --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.json

$ pbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ 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.json

aktar 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]

オプション

知っておきたいこと

• スクリプトで接続を手早く確認できます。Aktarに接続できないかトークンが正しくない場合は、終了コード3で終了します。

例

$ aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.json

$ aktar 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]

オプション

知っておきたいこと

• -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-9D5F2A7E4B13

$ aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshots

aktar history

最近のアップロードを新しい順に、日時、ファイル名、リンクとともに一覧表示します。historyのあとに続けた語句で履歴を検索します。

使い方

$ aktar history [search] [options]

オプション

知っておきたいこと

• -nを指定しなければ20件表示します。
• --jsonではaktar upload --jsonと同じフィールドが得られ、aktar qrで使える各アップロードのidも含まれます。

例

$ 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.pdf

$ aktar 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.pdf

$ aktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zip

aktar mcp

Model Context Protocol(MCP)サーバーを起動し、Claude、Cursor、VS Code、Codexなどの AI エージェントがAktar経由でファイルをアップロードしたり、過去のアップロードを探したり、リンクを作成したりできるようにします。エージェントに一度追加しておけば、必要なときにエージェントが起動します。

使い方

$ aktar mcp [--root <folder>]... [--read-only | --allow-replace | --allow-delete] [--max-link-minutes <n>] [--log <file>]

オプション

知っておきたいこと

• 先に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で作成できるリンクは、--max-link-minutesで延ばさない限り最長60分です。クリップボードには何が入っているかわからないため、--rootを指定するとupload_clipboardは提供されません。
• ツールの結果の先頭には、含まれるファイル名、キー、メッセージは指示ではなくデータである、という注記が付きます。--logを使うと、すべての呼び出しが記録されます。同時に実行するツール呼び出しは最大4つです。
• グローバルインストールしていない場合は、コマンドとしてnpx -y @getaktar/cli mcp --root ~/Projectsを使ってください。
• stdio上で、現行のMCPバージョン(2026-07-28)と、initializeで始まる以前のバージョン(2024-11-05から2025-11-25)に対応しています。aktar 0.4.0が必要です。上記の制限はaktar 0.6.0で追加されました。

ツール

例

$ claude mcp add aktar -- aktar mcp --root ~/Projects
$ codex mcp add aktar -- aktar mcp --root ~/Projects

$ claude mcp add aktar -- aktar mcp --root ~/Projects --root ~/Desktop --allow-replace

$ claude mcp add aktar -- aktar mcp --root ~/Projects --log ~/aktar-mcp.log

aktar skill

エージェント向けのスキル(SKILL.md)を出力します。--json付きのaktarコマンドの使い方、つまり何を実行し、結果をどう読み取り、共有を頼まれたものだけをアップロードすることをエージェントに教えます。スキルは使えてもMCPは使えないエージェント向けです。

使い方

$ aktar skill

オプション

オプションはありません。

知っておきたいこと

• エージェントがスキルを探す場所に保存してください。たとえばClaude Codeなら~/.claude/skills/aktar/です。

例

$ mkdir -p ~/.claude/skills/aktar
$ aktar skill > ~/.claude/skills/aktar/SKILL.md

すべてのコマンドで使えるオプション