几秒钟即可开始使用
CLI 已内置于 Owlfiles macOS 版中。它使用 Owlfiles 应用本身的可执行文件，并复用你已经在应用中配置的连接和保存的登录信息，无需额外设置。
在终端中使用完整路径运行：
/Applications/Owlfiles.app/Contents/MacOS/Owlfiles connections为了减少输入，可以添加一个 Shell 别名。如果使用默认的 zsh，请将以下内容添加到 ~/.zshrc，然后打开新的终端窗口：
# 添加到 ~/.zshrc，然后打开新的终端窗口
alias owlfiles="/Applications/Owlfiles.app/Contents/MacOS/Owlfiles"之后只需输入 owlfiles 即可。下方示例均假设已设置此别名。
指定文件位置
大多数命令使用 <连接>:<路径> 格式的地址，其中 连接 是 owlfiles connections 显示的名称。
MyNAS:/Documents/report.pdf— 位于名为“MyNAS”的连接中的文件。GDrive:1zeRs1TUOYxMwVdYJdHF_ikAaRCMYMcwp— Google Drive 使用 ID 作为路径。local:~/Desktop或~/Desktop— Mac 上的文件。如果未指定连接，该地址会被视为本地磁盘路径。
如果连接名称包含空格，请使用引号括住整个地址，例如 “my NAS:/Documents”。对于云服务，可以使用文件 ID 代替路径；ID 会显示在 ls 命令的结果中。
常用命令
每条命令在成功时返回退出状态 0，失败时返回非零状态，并将错误写入标准错误输出，因此 CLI 很适合在 Shell 脚本中使用。
# 列出所有连接（名称和协议）
owlfiles connections
# 列出文件夹内容（-a 包含隐藏文件）
owlfiles ls "my NAS:/Documents"
owlfiles ls -a MyGoogleDrive:'1WlBH4KpOcIWgNKVVBRmUd5'
# 查看文件信息 / 元数据（类型、大小、修改日期）
owlfiles info "my NAS:/Documents/report.pdf"
# 按关键字搜索（不区分大小写）
owlfiles search "my NAS:/Documents" invoice
owlfiles search Dropbox report.pdf
# 创建文件夹
owlfiles mkdir "my NAS:/Documents/Archive"
# 跨连接复制（NAS → 云端时使用文件 ID）
owlfiles cp "my NAS:/Documents/report.pdf" GDrive:'1WlBH4KpOBl8WXj31pOcIW'
owlfiles cp /Users/me/Desktop/photo.jpg "my NAS:/Photos"
# 移动 / 重命名，也支持跨连接操作
owlfiles mv "my NAS:/Documents/report.pdf" MyOneDrive:'CF8821A253295DA6!142'
# 删除（不会显示确认提示，请谨慎使用）
owlfiles rm "my NAS:/Documents/old.txt"
# 查看完整命令说明
owlfiles --help使用须知
名称和登录
运行 owlfiles connections 可查看准确的连接名称。名称包含空格时，请使用引号括住。如果某个连接要求登录，请先在 Owlfiles 应用中打开一次；之后 CLI 会复用相同的已保存登录信息。
本地文件与沙盒
Owlfiles 运行在 macOS App Sandbox 中。只有在 Owlfiles 应用中打开过一次本地磁盘上的文件夹后，CLI 才能访问该文件夹。远程连接和云端连接中的文件不受此限制。