Name: AI-Safe Secrets
Author: Kim Kay

바이브 코딩 시 사용되는 .env는 보안에 취약하다. Tene는 .env 없이 AI가 시크릿 정보를 다룰 수 있도록 한다.

## 한 줄 소개

Tene는 "AI agents can use secrets without ever seeing them"이라는 문장을 그대로 제품 철학으로 보여주는 도구다. AI 에이전트가 시크릿을 써야 하는 상황은 지원하되, 그 값을 직접 읽지는 못하게 만드는 오픈소스·로컬 우선 시크릿 관리 방식에 가깝다.[^1]

![áá³áá³ááµá«áá£áº 2026-04-22 22](https://images.tilnote.io/pages/efb4564d-72f4-4280-9a09-2f46f560c264.webp)

*`.env` 파일은 비밀이 아니며 AI가 읽을 수 있다는 점을 강조하면서, Tene가 비밀 정보를 암호화해 AI 에이전트가 내용은 보지 못한 채 사용할 수 있도록 돕는 과정을 소개하는 이미지입니다.`*

## 무엇을 해결하는가

요즘 개발 환경에서는 AI 에이전트가 프로젝트 파일을 폭넓게 읽는다. 이때 가장 단순한 시크릿 저장 방식인 `.env`도 함께 읽히기 쉽고, 결국 API 키나 토큰이 평문으로 노출될 수 있다.[^1]

Tene는 이 지점을 정면으로 겨냥한다. 핵심은 "앱은 시크릿을 사용해야 하지만, AI는 시크릿 값을 몰라도 된다"는 분리다. 즉, 개발 편의성과 비밀 보호를 동시에 맞추려는 접근이다.[^1]

## 작동 방식

Tene는 시크릿을 로컬에서 암호화해 저장하고, 실제 값은 실행 시점에만 환경변수로 주입한다.[^1]

짧게 보면 흐름은 이렇다.

```bash
tene run
```

이 방식이면 애플리케이션은 기존처럼 환경변수를 받아 정상 동작하고, AI 에이전트는 프로젝트 파일을 읽더라도 실제 비밀값 자체는 확인하기 어렵다.[^1]

## 주요 기능

![áá³áá³ááµá«áá£áº 2026-04-22 23](https://images.tilnote.io/pages/e41f5de0-9ce3-4a87-bee4-f48a3da162c1.webp)

*`.env` 파일이 AI에 노출되는 문제를 해결하기 위해, Tene가 비밀 정보를 암호화하고 runtime injection으로 안전하게 주입하는 방식을 소개하는 화면입니다. 암호화된 vault, `.env` 마이그레이션, 원클릭 설정, AI agent rules 같은 핵심 기능을 한눈에 보여줍니다.*

가장 눈에 띄는 기능은 로컬 암호화 저장소다. Tene는 XChaCha20-Poly1305와 Argon2id를 기반으로 시크릿을 보호하고, 로컬 SQLite 암호화 vault에 저장한다.[^1]

설정 과정도 단순한 편이다. 설치 후 초기화하고 시크릿을 저장하면 되며, 가입이나 별도 대시보드, 복잡한 설정 파일이 필요 없다는 점을 강하게 내세운다.[^1]

기존 `.env`를 옮기는 흐름도 준비되어 있다.

```bash
tene import .env
```

이미 `.env` 중심으로 운영하던 프로젝트라면, 이 명령으로 기존 값을 암호화 vault로 이동시키는 식의 전환이 가능하다.[^1]

또 하나 흥미로운 부분은 AI 도구 연동이다. `tene init`은 Claude Code, Cursor, Windsurf, Gemini, Codex용 컨텍스트 파일을 자동으로 만들어 준다.[^1]

```bash
tene init
```

## 도입 흐름

도입 흐름은 아주 짧다. 설치하고, 프로젝트를 초기화하고, 시크릿을 저장한 뒤, `tene run`으로 개발을 이어가는 구조다.[^1]

*터미널 화면에 “Before tene: .env is visible to every AI agent.”라는 문장이 표시되어, AI 에이전트 환경에서 .env 파일 노출 문제를 강조한다. 어두운 콘솔 UI를 통해 보안 설정의 중요성을 직관적으로 보여주는 이미지다.*

정리하면 Install → Project Initialize → Store secrets → Develop with secrets 순서다. 복잡한 보안 시스템을 새로 도입한다기보다, 기존 개발 습관을 크게 바꾸지 않으면서 `.env`의 약점을 줄이는 방식이라고 볼 수 있다.[^1]

## 보안 특징

![áá³áá³ááµá«áá£áº 2026-04-22 23](https://images.tilnote.io/pages/1deffe02-3960-4f21-9c97-6d597a4ff56e.webp)

*로컬 기기에서만 동작하는 암호화 아키텍처를 보여주는 화면으로, Argon2id·XChaCha20-Poly1305·256-bit 암호화와 SQLite vault 구성을 강조한다. 네트워크 호출 0회, 12 words 복구 키, 오픈소스 검증 가능성을 함께 안내한다.*

*어두운 터미널 화면에 “Don't trust me. Open the vault yourself.”라는 문구가 표시되어, 직접 확인과 검증의 중요성을 강조한다.*

Tene의 보안 메시지는 분명하다. 서버가 없고, 시크릿은 로컬에만 저장되며, 무료 티어 기준 네트워크 호출도 없다고 설명한다.[^1]

이 말의 의미는 단순히 "암호화를 쓴다"에서 끝나지 않는다. 중앙 서버 의존성을 줄이고, 시크릿 이동 경로 자체를 최소화해 노출 면을 줄이겠다는 설계로 읽힌다.[^1]

또한 오픈소스이기 때문에, 실제 구현을 GitHub에서 확인할 수 있다는 점도 신뢰 포인트다. 보안 도구는 주장보다 구현 검증 가능성이 더 중요하다는 점에서 이 부분은 의미가 있다.[^1][^2]

## 비교 포인트

Tene가 강조하는 비교 축은 분명하다. 일반 `.env` 방식과 비교하면, 평문 노출 위험을 줄이고 런타임 주입으로 전환한다는 점이 가장 큰 차이다.[^1]

![áá³áá³ááµá«áá£áº 2026-04-22 23](https://images.tilnote.io/pages/8b91693b-00e9-460f-b000-1d62e9d27ca5.webp)

*Tene와 .env, Doppler, Vault, Infisical을 비교한 표로, AI로부터 비밀 정보를 숨기면서 로컬 환경에서 무료로 사용할 수 있는 점을 강조한다. 주요 기능과 가격을 한눈에 정리한 비교 이미지다.*

Doppler, Vault, Infisical 같은 도구들과 비교할 때는 local-first, 서버 없음, signup 없음, runtime injection, open source 같은 속성을 전면에 둔다.[^1] 즉, "팀 단위 통합 시크릿 플랫폼"보다는 "AI 시대의 로컬 개발 시크릿 보호"에 더 초점을 맞춘 제품으로 이해하는 편이 맞다.

## 참고 링크

공식 사이트: https://www.tene.sh/[^1]

GitHub: https://github.com/tomo-kay/tene[^2]

## 참고

[^1]: [Your .env is not a secret.AI can read it.](https://www.tene.sh/)

Tene는 AI가 시크릿 값을 보지 못한 채 앱이 비밀을 쓰게 돕는 로컬 우선 도구다.
- `.env`는 AI가 읽을 수 있어 위험하며, Tene는 시크릿을 로컬에서 암호화해 저장한다.
- 실행할 때만 환경변수로 주입해, 앱은 그대로 동작하고 비밀값 노출은 줄인다.
- 서버·가입 없이 쓰는 오픈소스 도구로, 기존 `.env`를 쉽게 가져오고 AI 도구 연동도 지원한다.

Tene 소개 AI 에이전트용 로컬 시크릿 관리 도구

평문 `.env` 파일은 한동안 로컬 개발의 무난한 관례처럼 여겨졌다. 하지만 이 글은 AI 코딩 도우미가 작업 공간의 파일을 개발 맥락으로 읽기 시작하면서 상황이 달라졌다고 주장한다. 비밀값이 `.env` 안에 있으면, AI 지원 개발 과정에서 모델 컨텍스트, 도구 출력, 대화 기록, 제안, 로그 등으로 자연스럽게 흘러들어갈 수 있다.[^1]

## 왜 `.gitignore`만으로는 부족한가

글의 핵심 중 하나는 `.gitignore`가 파일이 Git에 커밋되는 것만 막아준다는 점이다. 이 설정은 로컬 AI 도구가 프로젝트를 분석하면서 해당 파일을 읽는 것까지 막아주지 못한다. 즉, 비밀값이 저장소에는 올라가지 않더라도 작업 공간을 스캔하는 도우미에게는 그대로 노출될 수 있다.[^1]

## tene는 이 문제를 어떻게 다루는가

글은 tene를 더 안전한 워크플로로 소개한다. tene는 비밀값을 프로젝트 안의 평문 파일에 두지 않고, 암호화된 SQLite vault에 저장한 뒤 명령을 실행할 때만 주입한다. 핵심 패턴은 `tene run -- <cmd>`이며, 이 방식에서는 비밀값을 메모리에서 복호화해 실행 중인 프로세스에 런타임 환경 변수로 전달한다.[^1]

실질적인 아이디어는 단순하다. 애플리케이션이 필요할 때는 비밀값을 사용할 수 있지만, 그것이 저장소 안에 읽기 쉬운 파일 형태로 오래 남아 있지는 않는다. 그만큼 AI 도우미가 작업 맥락의 일부로 비밀값을 읽게 될 가능성도 줄어든다.[^1]

## 실제로 무엇이 달라지는가

글은 몇 가지 장점을 강조한다. 먼저 비밀값이 AI의 컨텍스트 창에 들어갈 가능성이 줄어든다. 또한 디스크 위에 평문 비밀 파일이 남지 않는다. 그 결과, 백업 파일이나 오래된 회전 키처럼 파일 어딘가에 남아 있던 정보까지 함께 노출되는 사고 가능성도 낮아진다. 글에 따르면 `--env dev`, `--env staging`, `--env prod` 같은 옵션으로 여러 환경도 기본적으로 지원하며, 기존 `.env` 파일을 가져온 뒤 원본을 삭제하고 tene를 통해 앱을 실행하는 방식으로 마이그레이션도 비교적 간단하다.[^1]

데모 영상: 

```linkcard
{"url":"https://www.tene.sh/demo/the-full-story-demo.gif","title":"https://www.tene.sh/demo/the-full-story-demo.gif","description":"","image":""}
```

또한 대부분의 애플리케이션은 보통 `dotenv` import를 제거하는 정도 외에는 큰 코드 변경이 필요 없다고 설명한다. 애플리케이션은 여전히 런타임에 일반적인 환경 변수를 읽기 때문이다.[^1]

## `.env`와 tene 비교

`.env`를 쓰면 비밀값이 작업 공간 안의 평문 파일로 저장되므로, 프로젝트 파일을 들여다보는 AI 도구가 이를 읽을 수 있다. 반면 tene에서는 비밀값이 암호화된 vault에 저장되고, 실행 시점에만 실행 프로세스에 노출된다.[^1]

![áá³áá³ááµá«áá£áº 2026-04-23 10](https://images.tilnote.io/pages/26c69b80-09d7-4428-9413-508b8bea7cdf.webp)

*`tene`와 `.env files`를 항목별로 비교한 표로, 저장 방식·보안·멀티 환경 지원·복구 방식 등의 차이를 한눈에 보여준다. `tene`는 암호화된 SQLite vault 기반으로, `.env` 파일 대비 더 안전한 비밀값 관리 방식을 강조한다.*

`.env` 방식은 보통 디스크 위에 파일이 존재해야 로딩할 수 있다. tene는 명령 래퍼를 통해 런타임에 값을 주입한다. 또한 `.env`에서는 환경별 설정이 수동이거나 여러 파일에 흩어지기 쉬운 반면, 글은 tene의 환경 분리를 기본 기능으로 제시한다.[^1]

## 구체적인 예시

로컬 개발에서는 `tene run -- npm start`처럼 실행해, 비밀값이 주입된 상태로 앱을 시작할 수 있다.[^1]

CI 환경에서는 `TENE_MASTER_PASSWORD`를 설정한 뒤 `tene run --no-keychain -- npm test` 같은 방식으로 실행하는 예시를 보여준다.[^1]

애플리케이션 내부의 접근 방식도 익숙한 형태를 유지한다. 예를 들어 Node.js에서는 `process.env.STRIPE_KEY`, Go에서는 `os.Getenv("STRIPE_KEY")`, Python에서는 `os.environ["STRIPE_KEY"]`처럼 읽으면 된다.[^1]

## 정리

이 글은 다소 분명한 관점을 가진 주장이다. 그래도 핵심 메시지는 명확하다. AI 지원 개발 환경에서는 평문 `.env` 파일이 새로운 노출 경로가 될 수 있다. 도우미가 작업 공간 파일을 컨텍스트로 읽기 때문이다. 글은 tene가 비밀값을 런타임 전까지 암호화된 상태로 유지하고, 일반적인 AI 읽기 경로 바깥에 두는 방식으로 더 안전한 대안이 될 수 있다고 본다.[^1]

## 참고

[^1]: [tene vs .env -- stop AI agents from reading your secrets](https://www.tene.sh/vs/dotenv)

AI 코딩 도우미를 쓰는 개발 환경에서는 평문 `.env`보다 tene 같은 런타임 주입 방식이 더 안전하다.
- `.gitignore`는 Git 커밋만 막을 뿐, AI 도구가 작업 공간의 `.env`를 읽는 것은 막지 못한다.
- tene는 비밀값을 평문 파일 대신 암호화된 vault에 저장하고, 앱 실행 순간에만 환경 변수로 넣어 준다.
- 그래서 디스크와 AI 컨텍스트에 비밀값이 남을 가능성을 줄이면서, 여러 환경과 기존 앱 마이그레이션도 비교적 쉽게 지원한다.

tene vs .env - AI 시대에 평문 환경 파일이 위험한 이유

![áá³áá³ááµá«áá£áº 2026-04-23 11](https://images.tilnote.io/pages/c73bb97a-e46e-4666-93eb-4dd313920880.webp)

*터미널 화면에서 `tene`로 비밀값을 암호화해 가져오고, `.env` 파일을 삭제한 뒤에도 앱이 동일한 환경변수로 실행되는 과정을 보여준다. 평문 `.env` 없이도 로컬에서 secrets를 안전하게 관리하는 워크플로를 설명하는 예시다.*

## 한줄 요약

`tene`는 평문 `.env`의 비밀값을 암호화된 vault로 옮긴 뒤, 실행 시에는 기존과 같은 환경변수로 주입해 앱 코드를 바꾸지 않게 해주는 도구다.[^1]

## 이 글의 문제의식

* 평문 `.env`는 실수로 저장소에 커밋되기 쉽다.[^1]

* AI 코딩 세션이나 자동화 환경에서도 파일 내용이 그대로 노출될 수 있다.[^1]

* 핵심은 비밀값이 디스크에 평문으로 남지 않게 하면서도, 앱 사용 방식은 바꾸지 않는 것이다.[^1]

## 60초 마이그레이션 절차

* 설치

```bash
curl -sSfL https://tene.sh/install.sh | sh
```

* 프로젝트에서 vault 초기화

```bash
tene init
```

* 이 과정에서 마스터 비밀번호를 설정하고, `.tene/vault.db`가 생성되며, 12단어 BIP-39 복구 mnemonic이 출력된다.[^1]

* 기존 `.env` 가져오기

```bash
tene import .env
```

* 각 `KEY=VALUE`가 암호화된 레코드로 저장된다.[^1]

* 평문 `.env` 삭제

```bash
rm .env
```

* 기존 실행 명령을 `tene run`으로 감싸서 실행

```bash
tene run -- npm start
```

* 앱은 그대로 `process.env.KEY` 같은 방식으로 값을 읽을 수 있다.[^1]

```linkcard
{"url":"https://www.tene.sh/demo/dotenv-gone-demo.gif","title":"https://www.tene.sh/demo/dotenv-gone-demo.gif","description":"","image":""}
```

## 내부 동작/보안 방식 요약

* 마스터 비밀번호에서 Argon2id(64MB, 3 iterations)로 256-bit master key를 만든다.[^1]

* 이 master key에서 HKDF-SHA256으로 실제 암호화 키를 파생한다.[^1]

* vault는 SQLite 기반이며, 데이터는 XChaCha20-Poly1305로 암호화된다.[^1]

* 키는 macOS Keychain, Linux libsecret, Windows Credential Vault 같은 OS keychain에 캐시된다.[^1]

* 가져오기 과정에서 평문 값은 메모리에서 암호화되고, 이후 남기지 않는 방향으로 동작한다는 점이 이 도구의 핵심이다.[^1]

## 운영 시 주의사항

* 12단어 복구 mnemonic은 반드시 안전한 곳에 보관해야 한다. 비밀번호를 잃으면 사실상 이 문구가 유일한 복구 수단이다.[^1]

* `tene get KEY`는 평문을 stdout으로 출력하므로, AI 코딩 세션에서는 `tene list`를 쓰는 편이 안전하다.[^1]

* CI 같은 비대화형 환경에서는 OS keychain을 기대하면 안 되므로 `--no-keychain`과 `TENE_MASTER_PASSWORD`를 함께 사용해야 한다.[^1]

* 이때 CI에 넣는 마스터 비밀번호는 vault를 처음 만들 때 사용한 값과 같아야 한다.[^1]

## 환경별 분리 사용법

* 기본 환경은 `default`다.[^1]

* 스테이징, 운영 환경을 따로 만들 수 있다.[^1]

```bash
tene env create staging
tene env create prod
```

* 특정 환경에만 값 저장

```bash
tene set DATABASE_URL ... --env staging
```

* 특정 환경으로 실행

```bash
tene run --env prod -- node server.js
```

* 같은 프로젝트 안에서도 환경을 분리해 운영할 수 있어, `.env.production`, `.env.staging` 식의 파일 관리 부담을 줄이기 좋다.[^1]

## 핵심 장점 정리

* 평문 `.env`를 없애 비밀값 노출 위험을 줄인다.[^1]

* 앱 코드 수정 없이 바로 옮길 수 있다.[^1]

* 실행 시점에는 기존 환경변수 방식 그대로 유지된다.[^1]

* 언어와 무관하게 사용할 수 있다.[^1]

* 로컬 개발, 스테이징, 운영 환경을 한 도구 안에서 나눠 관리할 수 있다.[^1]

## 출처

[^1]: [Migrating from .env to an encrypted vault in 60 seconds](https://www.tene.sh/blog/migrate-env-60s)

tene는 평문 .env를 암호화된 vault로 옮기고, 실행할 때 같은 환경변수로 넣어주는 도구다.
- .env를 import한 뒤 삭제해도 tene run으로 앱 코드를 바꾸지 않고 그대로 실행할 수 있다.
- 비밀값은 Argon2id, HKDF, XChaCha20-Poly1305 기반으로 보호되고 OS 키체인도 활용한다.
- 로컬·CI·staging·prod 환경을 나눠 관리할 수 있지만, 복구 문구와 마스터 비밀번호는 꼭 안전하게 보관해야 한다.

AI-Safe Secrets

목차

책 소개