File Transfers

Uploading a File

#

CLI:

1
2

tantoc2[my-op]> agents use <hostname>
<hostname>> upload /local/path/to/file.txt /remote/path/on/target.txt

Web UI: Agent Detail page > File Upload section > select file and specify remote path > Upload.

The upload is queued as a task. The agent retrieves and writes the file on its next check-in.

Downloading a File

#

CLI:

1
2

tantoc2[my-op]> agents use <hostname>
<hostname>> download /remote/path/on/target.txt

Web UI: Agent Detail page > File Download section > specify remote path > Download.

Listing Transfers

#

1

tantoc2[my-op]> files list <agent-id>

Displays: ID, direction (upload/download), remote path, size, hash verification status, and completion status.

Retrieving Downloaded Content

#

After a download completes, retrieve the stored file:

1

tantoc2[my-op]> files fetch <agent-id> <transfer-id> /local/output/path

Transfer Details

#

1

tantoc2[my-op]> files info <agent-id> <transfer-id>

Returns full transfer metadata including hash verification result.

Hash Verification

#

Every file transfer includes automatic SHA-256 integrity verification:

1. The agent computes a SHA-256 hash of the file data
2. The teamserver independently computes a SHA-256 hash
3. The hash_verified field indicates whether hashes match

If hashes do not match, the transfer is flagged. Check with files info.

Size Limits

#

The dev agent enforces a 10MB file transfer size guard. Transfers exceeding this limit are rejected. Custom agents may define their own limits.