주요 단축키
다음 표는 Windows와 Linux의 기본 단축키입니다. 입력 칸이나 다른 창에 초점이 있으면 해당 화면이 키를 먼저 처리할 수 있습니다. 현재 화면의 전체 도움말은 F1로 확인하세요.
CLI 시작
명령줄 도구 이름은 tastefiles-cli입니다. 실행 파일이 있는 폴더에서 실행하거나 PATH에 등록해 사용합니다. 명령과 옵션은 설치된 버전의 도움말로 확인하세요. 아래 예시의 경로는 실제 작업 경로로 바꾸며, 공백이 있는 경로는 따옴표로 감쌉니다.
tastefiles-cli --help
tastefiles-cli copy --help
tastefiles-cli presets
tastefiles-cli detect "D:/work/project"
미리 보기 후 복사
첫 명령은 파일을 기록하지 않는 모의 실행입니다. 결과를 검토한 뒤 -n을 제거해 실제 복사를 실행합니다. 이 예시에서 마지막 경로는 대상 폴더입니다.
tastefiles-cli copy "D:/work/project" "E:/backup" --preset auto -n
tastefiles-cli copy "D:/work/project" "E:/backup" --preset auto
tastefiles-cli copy "D:/photos" "E:/photos" --ext jpg,png --newer 30d -n
검색과 압축
tastefiles-cli find "main rs" --dir "D:/work/project"
tastefiles-cli search "TODO" --glob "*.rs" --dir "D:/work/project"
tastefiles-cli zip "D:/work/project" "E:/project-source.zip" --preset auto
tastefiles-cli unzip "E:/project-source.zip" --list
청소와 백업 미리 보기
clean은 기본적으로 후보와 용량을 보여 줍니다. 아래 청소 명령에는 실제 삭제 옵션이 없습니다. 백업 명령은 앱에서 저장한 프로필 이름을 사용합니다.
tastefiles-cli clean "D:/work" --min-size 100M
tastefiles-cli rules
tastefiles-cli backup "프로젝트 백업" -n
tastefiles-cli backup --log
`move`는 필터로 제외한 원본도 삭제할 수 있으며, 삭제 옵션과 확인 생략 옵션은 결과를 되돌릴 수 없게 만들 수 있습니다. 자동화 전에 해당 명령의 도움말과 미리 보기 결과를 확인하세요. 암호나 라이선스 키를 명령 문자열에 넣으면 터미널 기록에 남을 수 있으므로 공개 예시에는 실제 값을 사용하지 마세요.
자동화 결과 확인
--json은 표준 출력에 JSON 결과를 내고 진행 안내는 표준 오류로 보냅니다. 종료 코드도 함께 확인하세요. 기본적으로 0은 성공, 1은 일부 실패나 확인 중단이며 찾기에서는 결과 없음, 비교에서는 차이 있음을 뜻할 수 있습니다. 2는 잘못된 인자나 경로 등으로 작업을 시작하지 못한 경우입니다.
보조 단축키와 macOS
macOS에서는 Command 기반 전역 조합을 사용하므로 표의 Ctrl 조합은 해당 조합의 Command 키로 사용할 수 있습니다. 파일 창의 선택·외부 도구 키는 입력 초점과 OS 키 처리의 영향을 받습니다. 실제 macOS 키보드의 기능 키는 시스템 설정에 따라 Fn이 필요할 수 있습니다. 앱 F1 도움말의 Ctrl 표기와 실제 macOS 동작은 다를 수 있어 해당 환경에서 확인하세요.
CLI 명령 전체 목록
각 명령에 --help를 붙여 해당 버전의 옵션을 확인합니다. 아래 목록은 0.2.23의 명령과 옵션을 기준으로 합니다.
전송의 주요 옵션은 --include, --exclude, --preset, --gitignore, --ext, --regex, --min-size, --max-size, --newer, --older, --no-hidden입니다. --overwrite, --symlinks, --empty-dirs, --contents, --threads와 --max-rate는 결과와 처리 방식에 영향을 주므로 설치판 도움말의 허용 값을 확인합니다. --stream과 --native는 큰 파일 처리 방식을 선택하며, --no-atomic과 --no-times는 안전 쓰기와 수정 시각 보존을 바꿉니다. -n 또는 --dry-run은 미리 보기이며 --yes는 확인 생략이므로 첫 자동화에 임의로 추가하지 마세요.
Linux와 macOS의 예시는 D:/work 대신 /home/<사용자>/work 또는 /Users/<사용자>/work처럼 실제 폴더로 바꿉니다. Linux 패키지와 macOS 앱 번들에서 CLI가 별도로 설치되지 않았다면 배포 파일 안의 CLI 위치를 먼저 확인하세요.
Esc와 입력 초점
Esc는 진행 중인 모든 파일 작업을 일괄 취소하는 키가 아닙니다. 파일 작업을 멈추려면 작업 패널의 해당 작업에서 취소를 선택하고 결과를 확인하세요. F5는 새로 고침이며 일반 파일 복사는 도구 모음 또는 Ctrl+C/Ctrl+V를 사용합니다. 압축 내부에서 선택 항목을 풀려면 도구 모음의 복사를 사용합니다.
