Atuin Toolkit

Complete IntelliSense, validation, and documentation for Atuin config.toml configuration

Atuin replaces your existing shell history with a SQLite database, recording additional context for your commands. It provides optional encrypted synchronization between machines through an Atuin server. This extension brings first-class editing support for Atuin config.toml configuration files directly into VS Code.

Features

IntelliSense Completions

Full autocompletion for all 13 Atuin config sections, their options, enum values, and defaults.

• Section headers - Autocomplete [section_name] with all known sections
• Section options - Context-aware option completion with types and defaults
• Enum values - Suggest valid values for search_mode, filter_mode, style, keymap_mode, and more
• Top-level options - Complete all 37 root-level configuration options

Hover Documentation

Hover over any section name or option to see its description, type, default value, allowed enum values, and a direct link to the Atuin documentation.

Diagnostics and Validation

Real-time validation catches configuration errors as you type:

• Unknown section names
• Unknown options within sections
• Invalid enum values (e.g. invalid search_mode or filter_mode)
• Type mismatches (string where boolean expected, etc.)

Snippets

Quick-start templates for common configurations:

Supported Sections

All 12 official Atuin config sections are supported with full option definitions, plus 37 top-level options:

daemon sync search stats keys preview theme logs ui ai dotfiles tmux

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for Atuin Toolkit
4. Click Install

Or install from the command line:

code --install-extension atoolz.atuin-vscode-toolkit

Requirements

• VS Code 1.85.0 or higher
• A TOML language extension (e.g., Even Better TOML) for syntax highlighting

The extension activates automatically when you open a file named config.toml inside an .atuin or atuin directory, or any file matching **/atuin/config.toml.

Configuration

No additional configuration needed. The extension works out of the box for Atuin config files.

Contributing

Contributions are welcome. Please open an issue or pull request on GitHub.

License

MIT