push - cred

## Keyboard shortcuts

Press `←` or `→` to navigate between chapters

Press `S` or `/` to search in the book

Press `?` to show this help

Press `Esc` to hide this help

# push

Push secrets from your vault to a target platform.

## Basic Usage

Push all secrets to GitHub:

    cred push github

Push specific secrets only:

    cred push github DATABASE_URL JWT_SECRET

## Dry Run

Preview what will change before pushing:

    cred push github --dry-run

Preview specific keys:

    cred push github DATABASE_URL JWT_SECRET --dry-run

Nothing is uploaded when `--dry-run` is used.

## Options

Flag | Description
--- | ---
`--dry-run` | Preview changes without pushing
`--json` | Machine-readable output
`--non-interactive` | Fail instead of prompting

## Repository Detection

cred automatically detects your repository from git metadata when you’re inside a git repository.

If you’re not in a git repository, or need to push to a different repo:

    cred push github --repo owner/repo

## Incremental Updates

cred tracks which secrets have changed since the last push. Only modified secrets are updated remotely, making pushes efficient.

## Workflow Example

    # Add a secret
    cred secret set DATABASE_URL "postgres://..."

    # Preview the push
    cred push github --dry-run

    # Push when ready
    cred push github

## Updating Secrets

To update a secret:

    # Update locally
    cred secret set JWT_SECRET "new-secret-value"

    # Preview changes
    cred push github --dry-run

    # Apply
    cred push github

Only the changed secret will be updated at the target.