From bde6814411696f23e09f9d4a67fdc1e1fef55263 Mon Sep 17 00:00:00 2001 From: Michelle Tilley Date: Wed, 11 Mar 2026 23:33:30 -0700 Subject: feat: Initialize Atuin AI by default with `atuin init` (#3255) * Run Atuin AI's `init` during main `init` for bash, zsh, and fish * Note that logging into Hub will enable sync * Add instructions for users with existing sync accounts * Ensure daemon respects `auto_sync` setting * Update docs on disabling Atuin AI --- docs/docs/ai/introduction.md | 10 ++++------ docs/docs/faq.md | 12 ++++++++++++ 2 files changed, 16 insertions(+), 6 deletions(-) (limited to 'docs') diff --git a/docs/docs/ai/introduction.md b/docs/docs/ai/introduction.md index 0c235428..1c154992 100644 --- a/docs/docs/ai/introduction.md +++ b/docs/docs/ai/introduction.md @@ -1,18 +1,16 @@ # Atuin AI -Atuin AI is a subcommand that enables shell command generation and other information lookup via an LLM directly from your terminal. It is completely opt-in, and will not change the behavior of Atuin at all if you choose not to use it. +Atuin AI is a subcommand that enables shell command generation and other information lookup via an LLM directly from your terminal. Atuin AI requires an account on [Atuin Hub](https://hub.atuin.sh/), and you'll be prompted to login upon first use of the binary. ## Getting Started -Atuin AI currently supports zsh, bash, and fish shells. To get started, add the following to your shell's initialization file: +Atuin AI currently supports zsh, bash, and fish shells. Your shell's usual `atuin init` call will automatically bind the question mark key to the Atuin AI UI (only when the prompt is empty). -```bash -eval "$(atuin ai init)" -``` +!!! note "Disabling Atuin AI" -Once you've set it up and restarted your shell, you can invoke Atuin AI by pressing question mark (`?`) on an empty terminal line. + You can disable the default question mark key binding by passing `--disable-ai` to your shell's `atuin init` call. ## Settings diff --git a/docs/docs/faq.md b/docs/docs/faq.md index f5e867e7..32338ec9 100644 --- a/docs/docs/faq.md +++ b/docs/docs/faq.md @@ -37,6 +37,18 @@ eval "$(atuin init zsh --disable-up-arrow)" See [key binding](../configuration/key-binding.md) for more +## How do I remove the default question mark binding for Atuin AI? + +Open your shell config file, find the line containing `atuin init`. + +Add `--disable-ai` + +EG: + +``` +eval "$(atuin init zsh --disable-ai)" +``` + ## How do I edit a command instead of running it immediately? Press tab! By default, enter will execute a command, and tab will insert it ready for editing. -- cgit v1.3.1