secryn-cli 0.1.1

Secryn CLI — manage your secrets from the terminal

Secryn CLI

Command-line interface for Secryn — manage your secrets, projects, and API keys without leaving the terminal.

Installation

Via pipx (recommended)

pipx install secryn-cli

From source

cd packages/cli
pipx install -e .

Via pip + venv

cd packages/cli
python3 -m venv .venv
.venv/bin/pip install -e .
ln -sf $(pwd)/.venv/bin/sc ~/.local/bin/sc

One-liner install script

curl -fsSL https://raw.githubusercontent.com/P4ciuf/secryn/main/packages/cli/install.sh | bash

Requires Python 3.10+.

Quick Start

# Login to your Secryn instance
sc auth login --email [e-mail] --password "your-password"

# Or use a custom API URL
sc --api-url https://api.secryn.xyz/api/v1 auth login

The CLI stores configuration and session cookies in ~/.config/secryn/.

Commands

Authentication

sc auth login                                   # Interactive login
sc auth login --email <email> --password <pw>   # Non-interactive
sc auth logout                                  # Logout and clear cookies
sc auth whoami                                  # Show authenticated user
sc auth whoami --json                           # JSON output

Projects

sc projects list                        # List all projects
sc projects list --json                 # JSON output
sc projects create --name <name>        # Create a project
sc projects create --name <name>        # With description
  --description <desc>
sc projects delete --id <id>            # Delete (with confirmation)
sc projects delete --id <id> -f         # Skip confirmation

Secrets

sc secrets list --project-id <id>             # List secrets
sc secrets list --project-id <id> --json      # JSON output
sc secrets get --id <id>                      # Show secret (masked)
sc secrets get --id <id> --show-value         # Show in plain text
sc secrets get --id <id> --json               # JSON output
sc secrets create --project-id <id>           # Create a secret
  --name <name> --value <value>
  --notes <notes>                             # Optional notes
sc secrets update --id <id>                   # Partial update
  --name <new> --value <new>
  --notes <new>
sc secrets delete --id <id>                   # Delete secret
sc secrets delete --id <id> -f                # Skip confirmation
sc secrets export --project-id <id>           # Export as .env (stdout)
sc secrets export --project-id <id>           # Export to file
  -o .env

API Keys

sc api-keys list                        # List all keys
sc api-keys list --json                 # JSON output
sc api-keys create --name <name>        # Create key (read+write)
sc api-keys create --name <name>        # Create with specific permissions
  --permissions read
sc api-keys delete --id <id>            # Delete key
sc api-keys delete --id <id> -f         # Skip confirmation

User & Config

sc user info                # Show user profile
sc config                   # Show config paths and values
sc version                  # Show CLI version

Global Options

Option	Description
--api-url <url>	Override API base URL (default: http://localhost:3000)
--json	Output in JSON format (where supported)
--force, -f	Skip confirmation for destructive commands
--help	Show help for any command or subcommand

Environment Variables

Variable	Description
SECRYN_API_URL	Alternative to --api-url
SECRYN_HOME	Custom config directory

Configuration Files

The CLI stores its state in ~/.config/secryn/:

File	Content
config.json	API URL, user ID, email
cookies.json	JWT session cookies (httpOnly)

License

Apache 2.0 — see LICENSE.