Community코딩 & 개발github.com

lowestprime/codex-exporter

OpenAI Codex 앱 스레드 JSONL을 깔끔한 마크다운으로 내보내고 아카이브합니다. 프론트매터, 내보내기 맵, apply_patch의 편집된 파일 카드, 비밀 정보 삭제, 검증된 유니코드 클립보드, 그리고 $로 호출 가능한 Codex 스킬을 제공합니다.

codex-exporter란 무엇인가요?

이 스킬은 OpenAI Codex 앱에서 생성된 스레드 JSONL 파일을 구조화된 마크다운 문서로 내보내고 아카이브하는 전문 도구입니다. 개발자 및 AI 에이전트 사용자가 Codex 대화 기록을 영구적으로 보존하고, 편집된 파일 카드(apply_patch 기반)를 추출하며, 프론트매터와 내보내기 맵을 통해 명확한 문서 구조를 유지할 수 있도록 지원합니다. 또한, 비밀 정보(API 키, 토큰 등)를 자동으로 삭제하여 보안을 강화하고, 검증된 유니코드 클립보드를 통해 클립보드 데이터의 무결성을 보장합니다. `$ codex-exporter` 형식으로 Codex 앱 내에서 직접 호출 가능하며, CLI 도구로서도 작동하여 유연한 사용이 가능합니다. 이 스킬은 Codex를 사용하는 모든 개발자에게 유용하며, 특히 장기적인 프로젝트 문서화와 협업 환경에서 빛을 발합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
Part ofMobile
npx skills add lowestprime/codex-exporter

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

codex-exporter은(는) 무엇을 하나요?

OpenAI Codex 앱 스레드 JSONL을 깔끔한 마크다운으로 내보내고 아카이브합니다. 프론트매터, 내보내기 맵, apply_patch의 편집된 파일 카드, 비밀 정보 삭제, 검증된 유니코드 클립보드, 그리고 $로 호출 가능한 Codex 스킬입니다.

개요

이 스킬은 OpenAI Codex 앱에서 생성된 대화 스레드(JSONL 형식)를 분석하여 사람이 읽고 관리하기 쉬운 마크다운 파일로 변환합니다. 주요 기능은 다음과 같습니다:

  • 프론트매터(Frontmatter): 스레드 메타데이터(날짜, 모델, 사용자 등)를 YAML 형식의 프론트매터로 추출합니다.
  • 내보내기 맵(Export Map): 내보내진 모든 파일의 목록과 위치를 포함한 맵을 생성합니다.
  • 편집된 파일 카드(Edited File Cards): apply_patch 도구를 통해 수정된 파일의 변경 사항을 시각적인 카드 형태로 보여줍니다.
  • 비밀 정보 삭제(Secret Redaction): API 키, 비밀번호 등 민감한 정보를 자동으로 찾아 [REDACTED]로 대체합니다.
  • 검증된 유니코드 클립보드(Verified Unicode Clipboard): 클립보드로 복사되는 텍스트가 유니코드 인코딩 문제 없이 정확하게 전송되도록 검증합니다.
  • $ 호출 가능: Codex 앱 내에서 $ codex-exporter 명령어로 직접 실행할 수 있습니다.

사용 방법

Codex 앱 내에서 호출

Codex 채팅 창에서 다음 명령어를 입력하세요:

$ codex-exporter export <thread-id>

<thread-id>는 내보내려는 Codex 스레드의 ID입니다. 생략하면 현재 활성 스레드가 사용됩니다.

CLI 도구로 사용

npx codex-exporter export ./path/to/thread.jsonl -o ./output/

옵션

옵션설명기본값
-o, --output출력 디렉토리./export/
--redact-secrets비밀 정보 삭제 활성화true
--no-redact비밀 정보 삭제 비활성화-
--verify-clipboard클립보드 검증 활성화true
-h, --help도움말 표시-

설치

npm 패키지로 설치:

npm install -g codex-exporter

또는 npx를 통해 직접 실행:

npx codex-exporter --help

출력 예시

내보내기 결과는 다음과 같은 구조의 마크다운 파일이 생성됩니다:

---
thread_id: abc123
date: 2023-10-01T12:00:00Z
model: gpt-4
total_messages: 42
---

# 내보내기 맵

| 파일 | 경로 |
|------|------|
| main.py | ./output/abc123/main.py |
| utils.py | ./output/abc123/utils.py |

# 대화 기록

## 사용자

어떻게 하면 이 코드를 최적화할 수 있나요?

## 어시스턴트

`apply_patch`를 사용하여 `main.py`를 다음과 같이 수정했습니다:

### 편집된 파일: main.py

```diff
- def slow_function():
+ def optimized_function():
    # ...

...


## 라이선스

MIT License

관련 스킬