CLI Commands
Complete reference for mftctl command-line interface.
Global Options
bash
mftctl [global-options] <command> [command-options]
Global Options:
--config <path> Config file path (default: ~/.config/mft/config.yaml)
--debug Enable debug logging
--quiet Suppress output except errors
--help Show help
--version Show versionTransfer Commands
send
Send a file to recipient(s).
bash
mftctl send [options] <file> <recipient>
Options:
--progress Show progress bar
--timeout <duration> Transfer timeout (default: 5m)
--protocol <name> Transfer protocol (default: auto)
--compress Enable compression
--retry <count> Retry count (default: 3)
--resume Resume interrupted transfer
--mode <mode> Connection mode: direct|relay|queue
Examples:
mftctl send ./file.txt alice@example.com
mftctl send --progress ./large.tar.gz bob@example.com
mftctl send --compress --resume ./data.json alice@example.com,bob@example.comreceive
Receive incoming transfer(s).
bash
mftctl receive [options]
Options:
--dir <path> Output directory (default: current directory)
--overwrite Overwrite existing files
--parallel <count> Parallel receive count (default: 2)
Examples:
mftctl receive
mftctl receive --dir ~/Downloads
mftctl receive --parallel 4status
Check transfer status.
bash
mftctl status [options] [transfer-id]
Options:
--watch Watch status changes
--json Output as JSON
Examples:
mftctl status abc123
mftctl status --watchConfiguration Commands
config init
Initialize configuration.
bash
mftctl config init
Creates: ~/.config/mft/config.yamlconfig set
Set configuration value.
bash
mftctl config set <key> <value>
Examples:
mftctl config set server.url https://mft.example.com
mftctl config set transfer.timeout 10mconfig get
Get configuration value.
bash
mftctl config get <key>
Examples:
mftctl config get server.url
mftctl config get transfer.timeoutCertificate Commands
certificates issue
Issue new certificate.
bash
mftctl certificates issue [options]
Options:
--ca-url <url> CA server URL
--validity <duration> Certificate validity (default: 8760h)
--renew-auto Enable auto-renewal
Examples:
mftctl certificates issue
mftctl certificates issue --ca-url https://ca.example.comcertificates renew
Renew certificate.
bash
mftctl certificates renew [options]
Options:
--force Force renewal
Examples:
mftctl certificates renew
mftctl certificates renew --forcecertificates list
List certificates.
bash
mftctl certificates list [options]
Options:
--json Output as JSON
Examples:
mftctl certificates list
mftctl certificates list --jsonPlugin Commands
plugin install
Install plugin.
bash
mftctl plugin install <plugin-name>
Examples:
mftctl plugin install s3-storage
mftctl plugin install auth-oidcplugin list
List installed plugins.
bash
mftctl plugin list
Examples:
mftctl plugin listplugin remove
Remove plugin.
bash
mftctl plugin remove <plugin-name>
Examples:
mftctl plugin remove s3-storageNext Steps
- Configuration - Configuration options
- Plugin API - Plugin development