Himanshu-Sangshetti/twinfold

어떤 프로젝트인가요?

핵심 기능

• 01중복 파일을 이름과 메타데이터는 유지하면서 디스크 블록을 공유하는 APFS 클론으로 변환합니다.
• 02변경하기 전에 중복 파일 묶음과 확보할 수 있는 공간을 모두 보여 줍니다.
• 03사본을 바꿔 넣기 전에 바이트 단위로 비교하고 메타데이터를 확인합니다.
• 04모든 실행 내역을 History에 기록하고 한 단계로 되돌릴 수 있습니다.
• 05scan, reclaim, undo 명령을 제공하는 커맨드라인 도구를 제공합니다.
• 06MCP 서버로 실행되어 AI 에이전트가 확인을 거친 뒤 중복 파일을 검색하고 공간을 확보할 수 있습니다.

활용 사례

• 여러 프로젝트에 반복해서 들어 있는 node_modules 또는 virtualenv 패키지가 차지하는 공간을 확보합니다.
• 여러 폴더에 저장된 중복 다운로드 파일이나 동영상 사본을 잃지 않고 정리합니다.
• 계획을 승인한 뒤 AI 에이전트가 프로젝트 폴더의 중복 파일을 찾아 공간을 확보하도록 합니다.

빠른 시작

1. 1

   리포지토리를 클론합니다

   git clone https://github.com/Himanshu-Sangshetti/twinfold && cd twinfold
2. 2

   명령줄 도구를 빌드하고 PATH에 복사합니다

   swift build -c release && cp .build/release/twinfold /usr/local/bin/
3. 3

   폴더를 스캔해 동일한 파일을 공유하면 공간을 얼마나 절약할 수 있는지 확인합니다(변경 사항 없음)

   twinfold scan

사용 전 알아둘 점

• !macOS 14 이상 및 APFS 볼륨이 필요합니다.
• !앱은 Apple 공증을 받지 않았으므로 처음 실행할 때 macOS에서 경고가 표시됩니다.
• !자동 저장 및 메뉴 막대 기능을 사용하려면 유료 Pro 라이선스가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

twinfold은(는) 무엇인가요?

파일을 삭제하지 않고 동일한 파일을 저장 공간을 공유하는 APFS 클론으로 바꿔 디스크 공간을 확보하는 macOS 앱 및 CLI입니다. Twinfold는 여러 프로젝트에 있는 같은 node_modules나 중복 다운로드 파일처럼 Mac에서 동일한 파일을 찾아 추가 사본을 APFS 클론으로 변환합니다. 각 파일은 이름, 날짜, 권한을 그대로 유지하면서 사본끼리 디스크 블록을 공유하므로, 파일을 삭제하지 않고도 공간을 확보할 수 있습니다. 공유 파일을 나중에 수정하면 해당 파일에만 변경 사항이 적용됩니다.

twinfold은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

twinfold은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

twinfold은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. twinfold의 마지막 커밋은 2026년 10월 25일입니다.

twinfold은(는) 어디에 사용할 수 있나요?

여러 프로젝트에 반복해서 들어 있는 node_modules 또는 virtualenv 패키지가 차지하는 공간을 확보합니다. 여러 폴더에 저장된 중복 다운로드 파일이나 동영상 사본을 잃지 않고 정리합니다. 계획을 승인한 뒤 AI 에이전트가 프로젝트 폴더의 중복 파일을 찾아 공간을 확보하도록 합니다.

twinfold는 어떻게 설치하나요?

리포지토리를 클론합니다: git clone https://github.com/Himanshu-Sangshetti/twinfold && cd twinfold 명령줄 도구를 빌드하고 PATH에 복사합니다: swift build -c release && cp .build/release/twinfold /usr/local/bin/ 폴더를 스캔해 동일한 파일을 공유하면 공간을 얼마나 절약할 수 있는지 확인합니다(변경 사항 없음): twinfold scan

twinfold은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Himanshu-Sangshetti/twinfold