- Dòng lệnh
- v0.6.0
Tải lên từ terminal với aktar
Một lệnh, một liên kết: aktar upload report.pdf gửi tệp đến bucket của riêng bạn thông qua ứng dụng Aktar và in ra URL, Markdown hoặc JSON đầy đủ. Dành cho script, tác vụ CI và trình soạn thảo như Typora.
Hoặc dùng thử mà không cần cài đặt: npx @getaktar/cli upload file.png
aktar upload trong terminal, in ra liên kết, ảnh Markdown và JSON
aktar upload <file>…
Tải lên một hoặc nhiều tệp và in ra một liên kết cho mỗi tệp ngay khi tệp đó xong.
--format markdown
In ra Markdown, HTML hoặc mẫu tùy chỉnh của bạn trong Aktar thay vì URL thuần.
--json
In mọi thứ dưới dạng JSON: URL, mọi định dạng, khóa đối tượng, kích thước và thời điểm tệp hết hạn.
-d · --folder · --expires
Chọn đích theo tên, tải lên vào một thư mục, hoặc để bucket xóa tệp sau 1, 7, 14 hoặc 30 ngày.
--clipboard
Tải lên tệp hoặc hình ảnh trong bộ nhớ tạm.
--name cover
Tải lên một tệp duy nhất dưới tên khác, tên này được dùng cho mẫu đường dẫn của đích và lịch sử của Aktar.
--qr · aktar qr
In mã QR dưới mỗi liên kết để mở trên điện thoại.
aktar qrhiển thị mã cho bất kỳ liên kết nào, hoặc cho một tệp tải lên trong lịch sử."reused": true
Khi cùng một tệp đã có trong bucket, Aktar trả lại liên kết sẵn có thay vì tải lên lần nữa, và
aktarghi chú điều đó trên stderr.aktar replace
Ghi một tệp mới đè lên tệp đã tải lên và giữ nguyên liên kết, theo ID tải lên, liên kết hoặc khóa. Cần Aktar cho Mac 0.14.0 hoặc Windows 0.7.0.
--short · aktar short
In liên kết ngắn từ dịch vụ rút gọn riêng của đích.
aktar shorttạo liên kết ngắn cho một tệp trong lịch sử. Cần Aktar cho Mac 0.17.0 hoặc Windows 0.10.0.aktar mcp · aktar skill
Cho phép các tác nhân AI như Claude, Cursor, VS Code và Codex tải tệp lên, tìm trong các tệp bạn đã tải lên và tạo liên kết, dưới dạng máy chủ MCP hoặc bằng skill cho tác nhân.
aktar login
Lưu token từ Cài đặt của Aktar, sau khi kiểm tra token hoạt động.
status · destinations · history
Hiển thị kết nối, các đích của bạn và lịch sử tải lên có thể tìm kiếm.
Thiết lập trong một phút
- Trong Aktar cho Mac hoặc Windows, mở Cài đặt > Tích hợp và bật Cho phép kết nối cục bộ.
Sao chép token
Sao chép token hiển thị ở đó.Chạy aktar login
Chạyaktar loginvà dán token vào. Vậy là xong:aktar uploadgiờ dùng đích đang được chọn trong Aktar.
Dành cho script
Liên kết được ghi ra standard output, mỗi dòng một liên kết, còn mọi thứ khác ra standard error, nên URL=$(aktar upload build.zip) chạy được ngay. --json cho bạn đầy đủ chi tiết, và exit code cho biết điều gì đã xảy ra. Trong CI, hãy đặt AKTAR_TOKEN thay vì đăng nhập.
| Exit code | Exit code |
|---|---|
| 0 | Mọi thứ đã được tải lên |
| 1 | Ít nhất một tệp tải lên thất bại; các tệp khác vẫn thành công |
| 2 | Tham số sai hoặc thiếu tệp; không có gì được tải lên |
| 3 | Không kết nối được với Aktar, token sai, hoặc ứng dụng trên cổng đó không chứng minh được nó là Aktar |
Ảnh Typora, trên bucket của riêng bạn
Đặt aktar làm trình tải ảnh tùy chỉnh của Typora, và mọi ảnh bạn dán vào tài liệu sẽ được tải lên bucket của bạn, với liên kết được ghi vào Markdown.
Thiết lập TyporaKhóa của bạn ở lại trong Aktar
CLI không bao giờ thấy thông tin xác thực kho lưu trữ của bạn. Nó gửi tệp đến ứng dụng Aktar trên 127.0.0.1, và Aktar tải lên bằng các khóa trong Chuỗi khóa hoặc Trình quản lý thông tin xác thực.
API cục bộ của Aktar tắt cho đến khi bạn bật, không bao giờ chấp nhận kết nối từ máy tính khác, và mọi yêu cầu đều cần token của bạn. CLI lưu token trong một tệp chỉ bạn đọc được, và kiểm tra ứng dụng trên cổng đó đúng là Aktar trước khi gửi token.
Yêu cầu
- Aktar cho Mac 0.18.0 hoặc Aktar cho Windows 0.11.0 trở lên, với ít nhất một đích (aktar 0.5.0 trở về trước hoạt động với Aktar cho Mac 0.4.0 trở lên)
- Node.js 18 trở lên (Homebrew sẽ tự cài cho bạn)
- Dùng lại liên kết của tệp đã tải lên: Aktar cho Mac 0.10.0 hoặc Aktar cho Windows 0.3.0
-
aktar replace: aktar 0.3.0 và Aktar cho Mac 0.14.0 hoặc Windows 0.7.0 -
aktar mcpvàaktar skill: aktar 0.4.0 - Liên kết ngắn: aktar 0.5.0 và Aktar cho Mac 0.17.0 hoặc Windows 0.10.0
- Mã nguồn mở (MIT) trên GitHub
Câu hỏi
CLI có hoạt động khi không có ứng dụng Aktar không?
Tôi có thể dùng trong CI hoặc trên máy chủ không?
CLI hỗ trợ những kho lưu trữ nào?
Claude, Cursor hay các tác nhân AI khác có dùng được không?
aktar mcp là một máy chủ MCP: thêm nó bằng claude mcp add aktar -- aktar mcp --root ~/Projects (hoặc cấu hình JSON trong tài liệu), rồi tác nhân của bạn có thể tải tệp lên, tìm trong các tệp đã tải lên và tạo liên kết tạm thời. --root là thư mục nó được tải lên từ đó, các bí mật như khóa SSH và tệp .env không bao giờ được tải lên, --allow-replace cho phép nó thay một tệp mà vẫn giữ liên kết, còn --read-only bỏ mọi thứ có ghi dữ liệu. Với các tác nhân không có MCP, aktar skill in ra một skill hướng dẫn chúng dùng CLI.Token được lưu ở đâu?
~/.config/aktar/cli.json trên Mac (%APPDATA%\aktar\cli.json trên Windows), chỉ người dùng của bạn đọc được. aktar logout sẽ xóa nó, và tạo lại token trong Aktar sẽ ngắt kết nối mọi client.Tích hợp
Ngay nơi bạn đang làm việc.
- Aktar cho RaycastTải lên nội dung clipboard hoặc tệp đã chọn, tìm trong lịch sử kèm ảnh thu nhỏ và duyệt các bucket. Nhờ Raycast AI tạo liên kết 2 giờ cho một tệp.Lệnh và thiết lập
- Máy chủ MCP cho agent AIClaude, Cursor, VS Code và Codex tải tệp lên, tìm trong lịch sử tải lên và tạo liên kết, còn khóa của bạn vẫn nằm trong Aktar.Thiết lập agent
- Bucket của bạn, ngay trong ObsidianDán, kéo thả hoặc chuyển tệp đính kèm vào bucket của riêng bạn. Khóa vẫn nằm trên thiết bị.Cách plugin hoạt động
