cottage

library0.6.2pypypiunverified

Cottage is a modern, git-based, age-encrypted secrets manager for teams. It uses age encryption with YAML files and git for version control. Current version is 0.6.2, with a slow release cadence.

devops security

pip install cottage

INSTALL

IMPORT

SIG · COTTAGE

cottage

devopspythonv0.6.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Cottage

✓ from cottage import Cottage

✗ from cottage import Cottage

Basic usage of Cottage to manage encrypted secrets.

import os from cottage import Cottage # Initialize with path to .cottage directory (git repo with encrypted secrets) cottage = Cottage(path='./secrets') # List secrets print(cottage.list_secrets()) # Read a secret (age decryption) secret = cottage.get_secret('mykey') print(secret) # Set a secret (encrypts and writes) cottage.set_secret('mykey', 'myvalue') # Delete a secret cottage.delete_secret('mykey')

Debug

Known issues

gotchaCottage requires age and git to be installed on the system. Missing either will cause runtime errors.

fix

Install age (e.g., brew install age) and ensure git is available.

affects: <1.0.0

gotchaThe .cottage directory must be a git repository. If not initialized, Cottage will error.

fix

Run `git init` inside the .cottage directory before using Cottage.

affects: <1.0.0

deprecatedThe `init` method for creating a new repository is deprecated. Use `Cottage.create()` instead.

fix

Use `Cottage.create(path)` to initialize a new secrets repository.

affects: >=0.5.0 <0.6.0

breakingIn version 0.6.0, the default key format changed from 'ssh-ed25519' to 'age-encrypted'. Existing repositories may need migration.

fix

Migrate by re-encrypting all secrets with the new format using `cottage.migrate_keys()`.

affects: >=0.6.0

Upgrade

Version history

0.6.2latest on PyPI · released Jun 6, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

27 hits · last 30 days

node

OpenAI (training)

Resources

No resource links recorded.