업데이트로 돌아가기
New releaseAug 27, 2026

cottage v0.7.0

팀을 위한 현대적인 git 기반 age 암호화 비밀 관리자입니다.

공유

The cottage logo

Cottage Verify Cottage Rotate Crates.io Version PyPI Version NPM Version Docker Image Version

cottage는 팀이 git 저장소에서 age로 암호화된 시크릿을 관리할 수 있게 해주는 GitOps 도구입니다.

시크릿을 암호화/복호화하고, 수신자를 관리하며, 시크릿을 저장소 밖에 두면서도 VCS를 통해 쉽게 공유할 수 있는 간단한 워크플로를 제공합니다. cottage는 또한 암호화된 시크릿의 가려진 미리보기를 생성하여 가시성을 높이고, 영구 및 임시 복호화 워크플로를 모두 지원하며, 시크릿이 평문으로 커밋되지 않도록 보장합니다.

Intro Demo

  1. 기능
  2. 설치
  3. 에디터 통합
    1. VS Code 확장
    2. Cursor 및 Eclipse 확장
    3. Vim 플러그인
  4. AI 에이전트 통합
  5. 빠른 시작
  6. GitOps
  7. Git 훅
  8. 경로 접두사
  9. 접근 제어
    1. 규칙
    2. 검증
  10. 업스트림으로서의 모든 프로바이더
    1. 예제 플러그인
  11. 모든 기기와 동기화
  12. 더 알아보기
  13. 문제 해결
  14. 비교
    1. age vs 기타 암호화
    2. cottage vs SOPS
    3. cottage vs dotenvx
    4. cottage vs agebox

기능

  • 노출 안전: Rust의 타입 시스템을 사용하여 버그로 인해 실수로 시크릿이 노출되는 일이 절대 없도록 보장합니다.
  • 팀 친화적: 공개 키(수신자)는 저장소에 공유하고, 개인 키(신원)는 로컬에 보관합니다.
  • 접근 제어: 어떤 시크릿을 어떤 수신자에 대해 암호화할지 제어하는 간단한 허용/거부 규칙을 제공합니다.
  • .gitignore 관리: .gitignore를 자동으로 업데이트하여 암호화되지 않은 시크릿이 저장소에 들어가지 않도록 합니다.
  • 미리보기: 암호화된 시크릿의 타임스탬프가 포함된 마스킹된 미리보기를 생성하여 가시성을 높입니다.
  • 풍부한 diff: git diff를 깔끔하고 검토 가능하게 유지하며, ctg diff는 로컬에서 수정된 시크릿과 추적 중인 암호화된 대응 파일의 diff를 보여줍니다.
  • 체크섬 검증: 암호화된 시크릿과 수신자 목록이 메타데이터와 일치하는지 검증하여 변조를 방지합니다.
  • Git 훅: 커밋 전에 시크릿을 자동으로 확인/암호화하고 체크아웃 후에 복호화하는 git 훅을 손쉽게 설정할 수 있습니다.
  • 경로 접두사: 선택적으로 암호화된 시크릿과 메타데이터를 복호화된 파일 옆이 아닌 전용 디렉터리에 저장할 수 있습니다.
  • 영구 시크릿 워크플로: ctg decrypt/sync는 복호화된 시크릿을 디스크에 유지합니다.
  • 스마트 정리 수명 주기: ctg run(단축 명령 ctgx)과 ctg edit은 작업 전에 시크릿을 복호화하며, 사전에 이미 존재하던 경우 디스크에 유지하고 그렇지 않은 경우 작업 후 자동으로 정리합니다.
  • 완료 시 정리: ctg encrypt --clean, ctg run --clean, ctg edit --clean은 이전에 존재했던 경우에도 복호화된 파일이 디스크에서 정리되도록 보장합니다.
  • 환경 변수 주입 워크플로: ctg env는 복호화된 시크릿을 환경 변수로 주입하여 명령을 실행하며, 디스크에 전혀 기록하지 않습니다.
  • 안전한 시크릿 파이핑: ctg cat은 메모리에서 복호화하여 stdout으로 출력하므로 다른 도구로 직접 stdin 파이핑할 수 있습니다. ctg tee는 평문을 디스크에 기록하지 않고 stdin을 PATH로 암호화합니다. ctg rotate는 평문을 디스크에 기록하지 않고 현재 수신자에 대해 기존 시크릿을 다시 암호화합니다.
  • 정리: ctg clean은 로컬 저장소에서 모든 복호화된 시크릿을 삭제하여 AI 에이전트를 조금 더 안심하고 실행할 수 있게 해줍니다.
  • jj 및 비-git 디렉터리 지원: ctg init은 어떤 디렉터리든 시크릿 저장소로 변환합니다.
  • 모든 제공자와 동기화: API가 있는 모든 제공자를 업스트림으로 구성하고 git pull/diff/push처럼 ctg pull/diff/push를 사용할 수 있습니다.
  • 모든 기기와 동기화: cottage로 암호화되어 git 저장소에서 관리되는 시크릿은 Cottage Sync를 통해 여러 기기 간에 동기화할 수 있습니다.

설치

바이너리를 직접 다운로드

또는 패키지 레지스트리에서 설치:

# rust: cargo-binstall/cargo
cargo binstall --locked cottage
cargo install --locked cottage

# python: pip/uv/uvx
pip install cottage
uv pip install cottage
uvx --from cottage ctg --version

# node: yarn/pnpm/npx
yarn global add @sayanarijit/cottage
pnpm add -g @sayanarijit/cottage
npx -p @sayanarijit/cottage ctg --version

도커 이미지로도 사용할 수 있습니다:

# Docker
docker run --rm -v $PWD:/app sayanarijit/cottage --version

# Podman
podman run --rm -v $PWD:/app quay.io/sayanarijit/cottage --version

또는 GitHub에서 최신 릴리스를 다운로드하세요.

에디터 통합

VS Code 확장

Cottage VS Code 확장을 사용하여 ctg를 설치하고, Copilot 안전 훅을 추가하고, 탐색기에서 파일을 암호화하고, 편집기 워크플로를 통해 .cott.age 파일을 열 수 있습니다.

Cottage VS Code Extension Demo

Visual Studio Marketplace에서 설치하거나, vscode-plugin-cottage에서 로컬로 빌드하여 설치하세요.

Cursor 및 Eclipse 확장

VSX 파일을 다운로드하여 Cursor 또는 Eclipse IDE에 설치하세요. VS Code 확장과 유사하게 작동합니다.

Vim 플러그인

cottage.vim 플러그인을 사용하여 Vim 또는 Neovim에서 시크릿을 암호화/복호화하세요.

Cottage Neovim Demo

AI 에이전트 통합

아래의 모든 통합은 AI 에이전트가 ctg/ctgx를 직접 실행하거나 시크릿 파일을 보거나 편집하는 것을 방지합니다. 여기에는 .cottage/ 내부의 모든 항목, 모든 *.cott.* 파일(암호화된 *.cott.age 블롭 및 마스킹된 *.cott.toml 미리보기), 그리고 디스크에 여전히 *.cott.age 대응 파일이 존재하는 모든 복호화된 파일이 포함됩니다.

빠른 시작

프로젝트 초기화:

mkdir project && cd project

git init  # Optional, cottage works better with git but it's not required
ctg init  # Sets up the .cottage directory and necessary files

tree -a
# .
# ├ .cottage/         <- Auto-generated by `ctg init`
# │ └ recipients/     <- This is where your team keeps the public keys of all the recipients.
# │     └ sayanarijit <- Your public key. Commit it. To use an existing public key, just copy that key here.
# ├ .git/...
# └ .gitattributes    <- Added `*.cott.age binary linguist-generated filter=cottage-encrypted -diff` to avoid polluting git diff

# Your private key is stored safely in `~/.config/cottage/identity/<dirname>/<timestamp>.key`.
# You can run `ctg clean --all` anytime to clean up everything cottage ever did.

Create or edit a secret:

# `ctg edit` decrypts the file before opening in $EDITOR and re-encrypts upon save.
# If the decrypted file was not present on disk before running `ctg edit`, it is cleaned up afterwards.
# If it was already present, it is kept on disk.
ctg edit secret.yml

카테고리