コマンドライン
aktarでターミナルからアップロード
コマンド1つでリンクが1つ。aktar upload report.pdfを実行すると、Aktarアプリ経由でファイルが自分のバケットに送られ、URL、Markdown、または詳細なJSONが出力されます。スクリプト、CIジョブ、Typoraのようなエディタのために作りました。
npm install -g @getaktar/cli brew install getaktar/tap/aktar-cliインストールせずに試すこともできます：npx @getaktar/cli upload file.png
コマンド
-
aktar upload <file>…1つ以上のファイルをアップロードし、完了した順にファイルごとに1行ずつリンクを出力します。
-
--format markdownURLの代わりに、Markdown、HTML、またはAktarで作ったカスタムテンプレートの形式で出力します。
-
--jsonURL、すべての形式、オブジェクトキー、サイズ、ファイルの有効期限をまとめてJSONで出力します。
-
-d --folder --expiresアップロード先を名前で指定したり、フォルダにアップロードしたり、1日、7日、14日、30日後にバケットがファイルを削除するよう設定したりできます。
-
--clipboardクリップボードにあるファイルや画像をアップロードします。
-
--name cover1つのファイルを別の名前でアップロードします。その名前がアップロード先のパステンプレートとAktarの履歴で使われます。
-
--qr aktar qr各リンクの下にQRコードを出力し、スマートフォンで開けるようにします。
aktar qrは、任意のリンクや履歴のアップロードのQRコードを表示します。 -
"reused": true同じファイルがすでにバケットにある場合、Aktarはもう一度アップロードせずにそのリンクを返し、
aktarはそのことをstderrに表示します。 -
aktar replaceアップロード ID、リンク、キーを指定して、リンクを保ったままファイルを置き換えます。Aktar for Mac 0.14.0 または Windows 0.7.0 が必要です。
-
--short aktar shortアップロード先の短縮サービスで作った短縮リンクを出力します。
aktar shortは履歴のアップロードに短縮リンクを作成します。Mac版Aktar 0.17.0またはWindows版0.10.0が必要です。 -
aktar mcp aktar skillClaude、Cursor、VS Code、CodexなどのAIエージェントが、MCPサーバーまたはエージェントスキルを通じて、ファイルのアップロード、アップロードの検索、リンクの作成をできるようにします。
-
aktar loginAktarの設定に表示されるトークンを、動作を確認したうえで保存します。
-
status destinations history接続状況、アップロード先の一覧、検索できるアップロード履歴を表示します。
1分でセットアップ
- Mac版またはWindows版のAktarで設定 → 連携を開き、ローカル接続を許可をオンにします。
- 表示されたトークンをコピーします。
aktar loginを実行し、トークンを貼り付けます。これで完了です。以降、aktar uploadはAktarで選択中のアップロード先を使います。
Typoraの画像を自分のバケットに
aktarをTyporaのカスタム画像アップローダーに設定すると、ドキュメントに貼り付けた画像がすべて自分のバケットにアップロードされ、そのリンクがMarkdownに書き込まれます。
Typoraを設定するスクリプトで使いやすく
リンクは1行に1つずつ標準出力に、それ以外はすべて標準エラー出力に書き出されるので、URL=$(aktar upload build.zip)がそのまま動きます。--jsonを付ければ詳細な情報がすべて得られ、終了コードで結果がわかります。CIでは、ログインする代わりにAKTAR_TOKENを設定してください。
| 終了コード | |
|---|---|
0 | すべてアップロードされた |
1 | 1つ以上のアップロードが失敗した（ほかは成功） |
2 | 引数が正しくないかファイルが見つからないため、何もアップロードされなかった |
3 | Aktarに接続できない、トークンが正しくない、またはポート上のアプリがAktarであることを証明できなかった |
キーはAktarの中に
CLIがストレージの認証情報を見ることはありません。ファイルは127.0.0.1上のAktarアプリに送られ、Aktarがキーチェーンまたは資格情報マネージャーに保存されたキーを使ってアップロードします。
AktarのローカルAPIは自分でオンにするまでオフで、ほかのコンピュータからの接続は一切受け付けず、すべてのリクエストにトークンが必要です。CLIはトークンを自分だけが読めるファイルに保存し、送信する前に、ポート上のアプリが本当にAktarかどうかを確認します。
動作環境
- Mac版Aktar 0.18.0以降またはWindows版Aktar 0.11.0以降（アップロード先を1つ以上設定済み。aktar 0.5.0以前はMac版Aktar 0.4.0以降で動作）
- Node.js 18以降（Homebrewなら自動でインストールされます）
- アップロード済みファイルのリンクの再利用：Mac版Aktar 0.10.0またはWindows版Aktar 0.3.0
-
aktar replace: aktar 0.3.0 と Aktar for Mac 0.14.0 または Windows 0.7.0 -
aktar mcpとaktar skill: aktar 0.4.0 - 短縮リンク: aktar 0.5.0 と Mac版Aktar 0.17.0 または Windows版 0.10.0
- オープンソース（MIT）、GitHubで公開
よくある質問
CLIはAktarアプリなしでも使えますか？
いいえ。CLIはアプリのリモコンのようなものです。ストレージのキーを保管してアップロードを行うのはAktarなので、ローカル接続を許可をオンにした状態でAktarを起動しておく必要があります。CLIがアクセスキーを一切必要としないのもそのためです。
CIやサーバーで使えますか？
CLIは同じマシン上のAktarと通信するので、使えるのはAktarが動いている環境だけです。MacやWindowsのビルドエージェントなら問題なく使えます。Linuxサーバーでは、プロバイダ公式のCLIを使ってください。
どのストレージに対応していますか？
Aktarが対応しているものすべてです。Amazon S3、Cloudflare R2、Backblaze B2、DigitalOcean Spaces、MinIO、そしてあらゆるS3互換サービスに対応しています。設定ガイドをご覧ください。
ClaudeやCursorなどのAIエージェントから使えますか？
はい。aktar mcpはMCPサーバーです。claude mcp add aktar -- aktar mcp --root ~/Projects(またはドキュメントのJSON設定)で追加すると、エージェントがファイルのアップロード、アップロードの検索、一時リンクの作成を行えます。--rootはアップロード元にしてよいフォルダーで、SSH鍵や.envファイルのような秘密情報はアップロードされません。--allow-replaceでリンクを保ったままのファイルの置き換えを許可でき、--read-onlyで書き込みを伴うものをすべて外せます。MCPを使えないエージェント向けには、CLIの使い方を教えるスキルをaktar skillが出力します。
トークンはどこに保存されますか？
Macでは~/.config/aktar/cli.json（Windowsでは%APPDATA%\aktar\cli.json）に保存され、自分のユーザーだけが読み取れます。aktar logoutで削除でき、Aktarでトークンを再生成するとすべてのクライアントの接続が解除されます。