mnemoshare/mnemocli

By mnemoshare

Updated 5 days ago

MnemoShare standalone CLI

Image
Networking
Security
Databases & storage
0

5.7K

mnemoshare/mnemocli repository overview

mnemocli

Official CLI tool for MnemoShare - HIPAA-compliant secure file transfer.

Quick Start

# Pull the image
docker pull mnemoshare/mnemocli:latest

# Check version
docker run --rm mnemoshare/mnemocli --version

# Login
docker run --rm -it -v ~/.mnemoshare:/home/mnemocli/.mnemoshare mnemoshare/mnemocli login [email protected]

# Upload a file
docker run --rm -v ~/.mnemoshare:/home/mnemocli/.mnemoshare -v $(pwd):/workspace mnemoshare/mnemocli upload /workspace/file.pdf

# Download files
docker run --rm -v ~/.mnemoshare:/home/mnemocli/.mnemoshare -v $(pwd):/workspace mnemoshare/mnemocli download abc123def --output /workspace

What is mnemocli?

mnemocli is the command-line interface for MnemoShare, enabling secure file transfers from terminals, scripts, and CI/CD pipelines. It supports:

  • Secure uploads with AES-256-GCM encryption
  • Knowledge-based authentication (Q&A validation before transfers)
  • Multi-factor authentication (TOTP)
  • SSO/OAuth2 integration (Keycloak, Okta, Azure AD, Google Workspace)
  • Chunked transfers for large files (tested with 2GB+)
  • JWT refresh tokens for long-running automation (40-day sessions)

Tags

TagDescription
latestLatest stable release
0.5.1Current version with JWT refresh tokens
0.5.xVersion 0.5.x releases

Usage Examples

Basic Upload
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli upload /workspace/document.pdf
Upload with Q&A Answers
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli upload /workspace/report.pdf \
    --answer "purpose:Monthly Report" \
    --answer "department:Finance"
Automation (CI/CD)
# Login with environment variable
echo "$MNEMOSHARE_PASSWORD" | docker run --rm -i \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  mnemoshare/mnemocli login [email protected]

# Upload quietly (for scripts)
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli upload /workspace/*.pdf --quiet
Custom API Server
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli \
    --api-url "https://mnemoshare.example.com/api/v1" \
    upload /workspace/file.pdf

Native Installation

For better performance and convenience, install the native binary:

macOS (Homebrew):

brew install mnemoshare/tap/mnemocli

Debian/Ubuntu (APT):

curl -fsSL https://mnemoshare.github.io/apt/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/mnemoshare-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mnemoshare-archive-keyring.gpg] https://mnemoshare.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/mnemoshare.list
sudo apt update && sudo apt install mnemocli

Direct Download:

Image Details

PropertyValue
Base ImageAlpine 3.21
Size~15 MB
Usermnemocli (UID 1000)
Architectureslinux/amd64, linux/arm64
AttestationsSBOM, Provenance

Environment Variables

VariableDescription
MNEMOCLI_API_URLAPI server URL
MNEMOSHARE_CONFIG_DIRConfig directory (default: ~/.mnemoshare)

Documentation

Support

Official CLI tool for MnemoShare - HIPAA-compliant secure file transfer.

Quick Start

# Pull the image
docker pull mnemoshare/mnemocli:latest

# Check version
docker run --rm mnemoshare/mnemocli --version

# Login
docker run --rm -it -v ~/.mnemoshare:/home/mnemocli/.mnemoshare mnemoshare/mnemocli login [email protected]

# Upload a file
docker run --rm -v ~/.mnemoshare:/home/mnemocli/.mnemoshare -v $(pwd):/workspace mnemoshare/mnemocli upload /workspace/file.pdf

# Download files
docker run --rm -v ~/.mnemoshare:/home/mnemocli/.mnemoshare -v $(pwd):/workspace mnemoshare/mnemocli download abc123def --output /workspace

What is mnemocli?

mnemocli is the command-line interface for MnemoShare, enabling secure file transfers from terminals, scripts, and CI/CD pipelines. It supports:

  • Secure uploads with AES-256-GCM encryption
  • Knowledge-based authentication (Q&A validation before transfers)
  • Multi-factor authentication (TOTP)
  • SSO/OAuth2 integration (Keycloak, Okta, Azure AD, Google Workspace)
  • Chunked transfers for large files (tested with 2GB+)
  • JWT refresh tokens for long-running automation (40-day sessions)

Tags

TagDescription
latestLatest stable release
0.5.1Current version with JWT refresh tokens
0.5.xVersion 0.5.x releases

Usage Examples

Basic Upload
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli upload /workspace/document.pdf
Upload with Q&A Answers
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli upload /workspace/report.pdf \
    --answer "purpose:Monthly Report" \
    --answer "department:Finance"
Automation (CI/CD)
# Login with environment variable
echo "$MNEMOSHARE_PASSWORD" | docker run --rm -i \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  mnemoshare/mnemocli login [email protected]

# Upload quietly (for scripts)
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli upload /workspace/*.pdf --quiet
Custom API Server
docker run --rm \
  -v ~/.mnemoshare:/home/mnemocli/.mnemoshare \
  -v $(pwd):/workspace \
  mnemoshare/mnemocli \
    --api-url "https://mnemoshare.example.com/api/v1" \
    upload /workspace/file.pdf

Native Installation

For better performance and convenience, install the native binary:

macOS (Homebrew):

brew install mnemoshare/tap/mnemocli

Debian/Ubuntu (APT):

curl -fsSL https://mnemoshare.github.io/apt/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/mnemoshare-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mnemoshare-archive-keyring.gpg] https://mnemoshare.github.io/apt stable main" | sudo tee /etc/apt/sources.list.d/mnemoshare.list
sudo apt update && sudo apt install mnemocli

Direct Download:

Image Details

PropertyValue
Base ImageAlpine 3.21
Size~15 MB
Usermnemocli (UID 1000)
Architectureslinux/amd64, linux/arm64
AttestationsSBOM, Provenance

Environment Variables

VariableDescription
MNEMOCLI_API_URLAPI server URL
MNEMOSHARE_CONFIG_DIRConfig directory (default: ~/.mnemoshare)

Documentation

Support

License

Proprietary - See License Agreement

License

Proprietary - See License Agreement

Tag summary

Content type

Image

Digest

sha256:62ae4bcc6

Size

9.2 MB

Last updated

5 days ago

docker pull mnemoshare/mnemocli