AgentSkillsCN

syncing-atuin

为代码与API编写清晰易懂、便于维护的文档。当您需要撰写README文件、API文档、代码注释，或应用户要求对代码进行文档化时，本技能将为您提供专业支持。

SKILL.md
--- frontmatter
name: syncing-atuin
description: |
  This skill should be used when the user encounters Atuin sync issues,
  "atuin status" 4XX errors, encryption key mismatch, daemon problems,
  "atuin history delete" errors, or asks about shell history backup or
  cleanup. Covers zsh-autosuggestion TUI rendering conflicts, Korean
  history bulk deletion, last_sync_time troubleshooting, and history
  database maintenance.

Atuin 히스토리 동기화

Atuin 쉘 히스토리 동기화 및 모니터링 가이드입니다.

Known Issues

Atuin v1 API deprecated

  • •atuin status 명령어가 4XX 에러 반환 가능
  • •v2 API 사용 중, last_sync_time 파일이 CLI sync에서 자동 업데이트되지 않음
  • •동기화 자체는 정상 작동

atuin history delete 서브커맨드 미존재 (v18.11.0)

  • •atuin history 하위에 delete 명령어가 없음
  • •한글 포함 항목 일괄 삭제: atuin-clean-kr 스크립트 사용
  • •DB 경로: ~/.local/share/atuin/history.db

빠른 참조

히스토리 정리

bash
# 한글 포함 항목 미리보기
atuin-clean-kr --dry-run

# 한글 포함 항목 일괄 삭제 (백업 후 삭제)
atuin-clean-kr

상태 확인

bash
# 동기화 상태 (4XX 에러 발생 가능)
atuin status

# 마지막 동기화 시간 확인
cat ~/.local/share/atuin/last_sync_time

# 수동 동기화
atuin sync

주요 파일 위치

파일용도
~/.config/atuin/config.tomlAtuin 설정
~/.local/share/atuin/데이터 디렉토리
~/.local/share/atuin/last_sync_time마지막 동기화 타임스탬프

모니터링 (Hammerspoon)

Hammerspoon 메뉴바에서 Atuin 동기화 상태 모니터링 가능:

  • •정상: 초록색
  • •경고 (1시간 이상 미동기화): 노란색
  • •에러: 빨간색

자주 발생하는 문제

  1. •atuin status 4XX: v1 API deprecated, 동기화는 정상
  2. •encryption key 불일치: 계정별 고유 키, 마이그레이션 불가
  3. •zsh 한글 레이아웃 깨짐: zsh-autosuggestion + 한글 경로 조합 문제 (근본 원인: zsh-autosuggestion)
  4. •한글 포함 히스토리 TUI 렌더링 깨짐: zsh-autosuggestion이 한글 포함 명령어를 제안할 때 발생, SQLite 직접 삭제로 해결

레퍼런스