syncing-atuin

Diagnose Atuin sync issues, recover encryption keys, and clean Korean history entries.

4|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/greenheadHQ/nixos-config --skill syncing-atuin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: syncing-atuin
Source: https://github.com/greenheadHQ/nixos-config/tree/main/.claude/skills/syncing-atuin
Command: npx skills add https://github.com/greenheadHQ/nixos-config --skill syncing-atuin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Synchronizes Atuin shell history, helps recover encryption keys, and provides a cleanup workflow for Korean history entries via atuin-clean-kr.

Core Features & Use Cases

  • Detects Atuin sync issues and discrepancies in last_sync_time.
  • Guides safe recovery of encryption keys and cleanup of Korean-history entries when needed.
  • Use Case: When Atuin reports sync errors or key mismatches, follow the health-check and cleanup guidance to restore normal operation.

Quick Start

Run a quick Atuin sync health check to verify synchronization status and perform key recovery or the atuin-clean-kr cleanup when needed.

Frequently Asked Questions about syncing-atuin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Atuin shell history sync errors and encryption key mismatches?

To fix Atuin shell history sync errors and encryption key mismatches, run an Atuin sync health check to verify synchronization status and perform safe key recovery to restore normal operation.

Why does my Atuin last_sync_time show discrepancies on macOS?

Atuin last_sync_time discrepancies on macOS indicate sync failures that require a health check to diagnose synchronization issues and verify encryption keys before restoring proper history sync.

How do I clean up Korean history entries in Atuin safely?

To clean up Korean history entries in Atuin safely, use the atuin-clean-kr cleanup workflow which performs safe data cleanup with backups to prevent history loss during the removal process.

Does Atuin history synchronization work with nix-darwin and Home Manager?

Atuin history synchronization works with nix-darwin and Home Manager environments on macOS and NixOS, supporting verification of last_sync_time and encryption key recovery within these managed setups.

What is the best way to recover Atuin encryption keys without losing shell history?

The best way to recover Atuin encryption keys without losing shell history is to follow the health-check guidance for safe key recovery, ensuring backups are created before any cleanup or sync restoration.

Why is Atuin sync not working after changing my encryption key?

Atuin sync not working after changing your encryption key is caused by key mismatches that require running a sync health check to diagnose discrepancies and guide safe key recovery for restoring synchronization.