# atuinsh/atuin

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/atuinsh-atuin).**

28,342 stars · 777 forks · Rust · mit

## Links

- GitHub: https://github.com/atuinsh/atuin
- Homepage: https://atuin.sh
- awesome-repositories: https://awesome-repositories.com/repository/atuinsh-atuin.md

## Topics

`bash` `fish` `history` `rust` `shell` `zsh`

## Description

Atuin is a command-line tool that replaces standard shell history with a searchable, encrypted SQLite database. By hooking into shell initialization scripts, it provides an interactive, keyboard-driven interface for real-time command filtering and retrieval. The platform ensures data privacy through a client-side encryption layer, securing sensitive history and configuration data before it is synchronized across multiple machines.

Beyond history management, Atuin functions as an executable documentation platform that enables teams to create and share interactive runbooks. These documents use a block-based editor to combine rich text with live terminal commands, database queries, and API interactions. Users can compose complex automation workflows by chaining these modular blocks, which support dynamic template variable injection and script execution to maintain consistent operational procedures across different environments.

The system includes a background synchronization service that maintains consistent shell aliases, environment variables, and dotfile settings across devices. Teams can collaborate within shared workspaces, utilizing versioned runbooks and integrated access controls to manage standardized tasks. The platform also features an AI assistant that can interpret natural language instructions to modify document content, allowing for efficient updates to automated procedures.

## Tags

### Development Tools & Productivity

- [Interactive Runbooks](https://awesome-repositories.com/f/development-tools-productivity/interactive-runbooks.md) — Provides an interactive block-based environment for authoring and executing operational runbooks. ([source](https://docs.atuin.sh/desktop/))
- [Shell History Databases](https://awesome-repositories.com/f/development-tools-productivity/shell-history-databases.md) — Replaces standard shell history with a SQLite database for enhanced context and search. ([source](https://docs.atuin.sh/))
- [Shell History Managers](https://awesome-repositories.com/f/development-tools-productivity/shell-history-managers.md) — Centralizes and synchronizes command-line history across multiple machines using a secure, searchable database.
- [Executable Documentation](https://awesome-repositories.com/f/development-tools-productivity/executable-documentation.md) — Combines rich text with live terminal commands and API calls to create interactive, executable runbooks.
- [Executable Documentation Environments](https://awesome-repositories.com/f/development-tools-productivity/executable-documentation-environments.md) — A document-based environment that combines rich text with live terminal commands, database queries, and script execution for automated workflows.
- [Shell History Search Engines](https://awesome-repositories.com/f/development-tools-productivity/shell-history-search-engines.md) — Enables fast, context-aware searching of shell command history. ([source](https://docs.atuin.sh/))
- [Shell History Synchronizers](https://awesome-repositories.com/f/development-tools-productivity/shell-history-synchronizers.md) — Synchronizes shell history across multiple devices for a unified command experience. ([source](https://docs.atuin.sh/))
- [Automation Workflows](https://awesome-repositories.com/f/development-tools-productivity/automation-workflows.md) — Enables teams to share and execute versioned, block-based operational procedures within a collaborative environment.
- [Workflow Composition](https://awesome-repositories.com/f/development-tools-productivity/workflow-composition.md) — Allows chaining multiple automation blocks to execute complex sequences with shared context. ([source](https://docs.atuin.sh/desktop/blocks/))
- [Dotfile Managers](https://awesome-repositories.com/f/development-tools-productivity/dotfile-managers.md) — Enables synchronization of shell configuration files across environments. ([source](https://docs.atuin.sh/guide/dotfiles/))
- [Shell Integration Tools](https://awesome-repositories.com/f/development-tools-productivity/shell-integration-tools.md) — Integrates with shell initialization scripts to capture command execution events and provide custom key bindings for interactive workflows.
- [Automation Task Orchestration](https://awesome-repositories.com/f/development-tools-productivity/automation-task-orchestration.md) — Organizes diverse automation tasks into specialized blocks for system interaction and metrics integration. ([source](https://docs.atuin.sh/desktop/blocks/))
- [Environment Configuration Managers](https://awesome-repositories.com/f/development-tools-productivity/environment-configuration-managers.md) — Maintains consistent shell aliases, environment variables, and dotfile settings across multiple development machines.
- [Multi-Language Script Runners](https://awesome-repositories.com/f/development-tools-productivity/multi-language-script-runners.md) — Executes scripts using multiple interpreters to perform data processing and automation tasks. ([source](https://docs.atuin.sh/desktop/blocks/executable/script/))
- [Reusable Runbook Embedders](https://awesome-repositories.com/f/development-tools-productivity/reusable-runbook-embedders.md) — Allows embedding reusable runbooks from local or remote sources to maintain consistent procedures. ([source](https://docs.atuin.sh/desktop/blocks/executable/sub-runbook/))
- [Shell History Importers](https://awesome-repositories.com/f/development-tools-productivity/shell-history-importers.md) — Centralizes command history by importing files from various shell formats. ([source](https://docs.atuin.sh/reference/import/))
- [Template Processors](https://awesome-repositories.com/f/development-tools-productivity/template-processors.md) — Enables dynamic content injection using template syntax within documents. ([source](https://docs.atuin.sh/desktop/getting-started/))
- [Terminal User Interfaces](https://awesome-repositories.com/f/development-tools-productivity/terminal-user-interfaces.md) — Provides a keyboard-driven interface for advanced filtering, navigation, and management of command-line history and tasks.
- [Cross-Device Synchronization Services](https://awesome-repositories.com/f/development-tools-productivity/cross-device-synchronization-services.md) — A background synchronization service that maintains consistent command history and environment configurations across multiple machines and shell sessions.
- [Environment Variable Managers](https://awesome-repositories.com/f/development-tools-productivity/environment-variable-managers.md) — Provides tools to create and manage environment variables for shell consistency. ([source](https://docs.atuin.sh/guide/dotfiles/))
- [Keyboard Shortcuts](https://awesome-repositories.com/f/development-tools-productivity/keyboard-shortcuts.md) — Assign custom filter modes to specific keys or disable default triggers during shell initialization to personalize command-line interactions. ([source](https://docs.atuin.sh/configuration/key-binding/))
- [Runbook Versioning Tools](https://awesome-repositories.com/f/development-tools-productivity/runbook-versioning-tools.md) — Ensures stability by pinning embedded runbooks to specific versions or releases. ([source](https://docs.atuin.sh/desktop/blocks/executable/sub-runbook/))
- [Shell Alias Managers](https://awesome-repositories.com/f/development-tools-productivity/shell-alias-managers.md) — Ensures consistent command shortcuts across synchronized shell environments. ([source](https://docs.atuin.sh/guide/dotfiles/))
- [State Synchronization](https://awesome-repositories.com/f/development-tools-productivity/state-synchronization.md) — Supports persistent, shared variables across documents for collaborative workflows. ([source](https://docs.atuin.sh/desktop/blocks/executable/variable/))
- [Workflow Data Pipelines](https://awesome-repositories.com/f/development-tools-productivity/workflow-data-pipelines.md) — Enables passing structured data results between automated workflow steps. ([source](https://docs.atuin.sh/desktop/blocks/))
- [Workspace Management](https://awesome-repositories.com/f/development-tools-productivity/workspace-management.md) — Organizes documents into cloud-synced or local workspaces. ([source](https://docs.atuin.sh/desktop/workspaces/))

### User Interface & Experience

- [Terminal User Interfaces](https://awesome-repositories.com/f/user-interface-experience/terminal-user-interfaces.md) — Provides an interactive, keyboard-driven UI layer that hooks directly into shell sessions for real-time command filtering and selection.
- [Navigation Controls](https://awesome-repositories.com/f/user-interface-experience/navigation-controls.md) — Manage search results using keyboard shortcuts for cursor movement, item selection, deletion, and prefix-based command execution within the interface. ([source](https://docs.atuin.sh/configuration/key-binding/))

### Security & Cryptography

- [Client-Side Encryption](https://awesome-repositories.com/f/security-cryptography/client-side-encryption.md) — Secures sensitive command history and configuration data locally before transmission to ensure privacy during cloud-based synchronization.
- [SSH Connection Managers](https://awesome-repositories.com/f/security-cryptography/ssh-connection-managers.md) — Manages remote host connections and identity keys for secure, shared access. ([source](https://docs.atuin.sh/desktop/blocks/network/ssh/))

### Artificial Intelligence & ML

- [AI Content Management](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-content-management.md) — Update document content by using natural language commands to instruct an AI assistant to read, insert, replace, or remove specific blocks. ([source](https://docs.atuin.sh/desktop/ai-assistant/))
- [AI Interaction Approval](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-interaction-approval.md) — Review and authorize changes to documents requested by the AI assistant, with automatic approval for read-only operations that do not alter content. ([source](https://docs.atuin.sh/desktop/ai-assistant/))
- [Prompt Engineering](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-engineering.md) — Improve AI assistant performance by providing clear context, referencing specific block names, and ensuring the assistant understands the current document state. ([source](https://docs.atuin.sh/desktop/ai-assistant/))

### Business & Productivity Software

- [Collaborative Automation Workspaces](https://awesome-repositories.com/f/business-productivity-software/collaborative-automation-workspaces.md) — A shared workspace environment that enables teams to manage, version, and execute interactive runbooks with integrated access control and variable sharing.

### DevOps & Infrastructure

- [Container Orchestration](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration.md) — Deploys self-hosted server instances using container orchestration. ([source](https://docs.atuin.sh/self-hosting/docker/))
- [Database Backup Utilities](https://awesome-repositories.com/f/devops-infrastructure/database-backup-utilities.md) — Automates regular database snapshots within containerized environments. ([source](https://docs.atuin.sh/self-hosting/docker/))
- [Background Synchronization](https://awesome-repositories.com/f/devops-infrastructure/background-synchronization.md) — Maintains a persistent background process that manages encrypted data replication between local storage and remote cloud hubs.
- [Daemon Management](https://awesome-repositories.com/f/devops-infrastructure/daemon-management.md) — Control the background synchronization process by enabling autostart, setting sync frequency, and configuring communication via network ports or sockets. ([source](https://docs.atuin.sh/configuration/config/))
- [Kubernetes Inspection Tools](https://awesome-repositories.com/f/devops-infrastructure/kubernetes-inspection-tools.md) — Facilitates cluster state inspection through predefined and custom Kubernetes commands. ([source](https://docs.atuin.sh/desktop/blocks/executable/kubernetes/))

### Software Engineering & Architecture

- [Workflow Automation](https://awesome-repositories.com/f/software-engineering-architecture/workflow-automation.md) — Organizes workflows into modular, executable units that support script execution, API interactions, and dynamic template variable injection.

### Data & Databases

- [Relational History Stores](https://awesome-repositories.com/f/data-databases/relational-history-stores.md) — Uses a local relational database to store command history with rich metadata for efficient querying and structured data retrieval.
- [Database Query Interfaces](https://awesome-repositories.com/f/data-databases/database-query-interfaces.md) — Integrates parameterized database queries directly into documents for structured data retrieval. ([source](https://docs.atuin.sh/desktop/blocks/databases/))