diff options
| author | Michelle Tilley <michelle@michelletilley.net> | 2026-03-11 23:33:30 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2026-03-11 23:33:30 -0700 |
| commit | bde6814411696f23e09f9d4a67fdc1e1fef55263 (patch) | |
| tree | f1f99f27f9467792a969a7622f5c3feebfeb0b97 /docs | |
| parent | fix: ctrl-c not exiting ai (#3256) (diff) | |
| download | atuin-bde6814411696f23e09f9d4a67fdc1e1fef55263.zip | |
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
Diffstat (limited to '')
| -rw-r--r-- | docs/docs/ai/introduction.md | 10 | ||||
| -rw-r--r-- | docs/docs/faq.md | 12 |
2 files changed, 16 insertions, 6 deletions
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. |