Retyc

Send end-to-end encrypted file transfers and manage your Retyc encrypted storage spaces from your AI agent, via the official open-source Retyc CLI.

Documentation

Retyc logo

CI Release License: MIT

Retyc CLI

Official command-line interface for Retyc - send transfers and manage datarooms directly from your terminal. With RetycFS, mount your datarooms as a local folder on Linux. Also runs as a local MCP server: connect your AI agent and control Retyc in plain language.

Retyc CLI demo

What is Retyc?

Retyc is a European sovereign file storage platform with end-to-end post-quantum encryption. Data stays in Europe, GDPR-compliant by design.

retyc-cli lets you integrate Retyc transfers and datarooms into your scripts, pipelines, and workflows - no browser required.


Installation

Pre-compiled binaries

Download the binary for your platform from the latest release.

Releases are signed with cosign (keyless). To verify a binary, download it with retyc_sha256_checksums.txt and retyc_sha256_checksums.txt.sigstore.json, then:

cosign verify-blob \
  --certificate-identity 'https://github.com/retyc/retyc-cli/.github/workflows/release.yml@refs/tags/vX.Y.Z' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  --bundle retyc_sha256_checksums.txt.sigstore.json retyc_sha256_checksums.txt
sha256sum --check --ignore-missing retyc_sha256_checksums.txt

Linux packages (deb/rpm)

# Debian / Ubuntu
curl -fsSLO https://github.com/retyc/retyc-cli/releases/download/vX.Y.Z/retyc_X.Y.Z_amd64.deb
sudo apt install ./retyc_X.Y.Z_amd64.deb

# Fedora / RHEL / Rocky
sudo dnf install https://github.com/retyc/retyc-cli/releases/download/vX.Y.Z/retyc-X.Y.Z-1.x86_64.rpm

# openSUSE
sudo zypper install https://github.com/retyc/retyc-cli/releases/download/vX.Y.Z/retyc-X.Y.Z-1.x86_64.rpm

With go install

go install -tags prod github.com/retyc/retyc-cli@latest

From source

git clone https://github.com/retyc/retyc-cli.git
cd retyc-cli
go build -tags prod -ldflags "-X github.com/retyc/retyc-cli/cmd.Version=$(git describe --tags --always)" -o retyc .

With Docker

# GitHub Container Registry
docker pull ghcr.io/retyc/retyc-cli:latest
# Docker Hub
docker pull retyc/retyc-cli:latest

Quick start

# 1. Authenticate (opens a browser tab, no password stored)
retyc auth login

# 2. Send a file
retyc transfer create report.pdf

# 3. List your transfers
retyc transfer ls

# 4. Download a transfer
retyc transfer download <transfer-id>

Security

  • Authentication: OIDC device flow (no password ever stored locally)
  • File data + metadata: end-to-end encrypted with AGE post-quantum hybrid keys
  • Private key caching (Linux only): the decrypted AGE identity is stored in the kernel session keyring and is never written to disk.
  • Transport: TLS enforced by default

MCP Server

retyc-cli runs as a Model Context Protocol server — connect it to your AI agent and control Retyc in plain language:

"Create a dataroom called 'Release v2', upload ./dist/, and add alice@example.com as editor." "Send all PDFs in ./reports/ to bob@example.com, expire in 7 days." "List my latest transfers and download the most recent one into ~/Downloads/."

Full integration guide (Claude Desktop, Cursor, Windsurf, example prompts): doc/mcp.md


RetycFS, the Retyc file system

RetycFS mounts your datarooms as a local folder on Linux. Any program can open, edit and save the files in it: ls, cp, a file manager, an editor, a script.

mkdir -p ~/retyc
retyc fs mount retyc://<dataroom-id> ~/retyc   # one dataroom, the root of ~/retyc
retyc fs mount --all ~/retyc                   # or every dataroom, one folder each

Full guide: doc/retycfs.md


Documentation

TopicLink
Full commands referencedoc/commands.md
RetycFS (mount datarooms as a folder, Linux)doc/retycfs.md
MCP server + tools referencedoc/mcp.md
Docker usagedoc/docker.md
Claude Desktop bundle (MCPB)doc/mcpb.md
CI / CD integrationdoc/ci-cd.md
Configuration & env varsdoc/configuration.md

Development

# Run in dev mode
go run . --help

# Run tests
go test -race ./...

# Production build
go build -tags prod -ldflags "-X github.com/retyc/retyc-cli/cmd.Version=v0.1.0" -o retyc .

License

MIT - © Retyc / TripleStack SAS