# fish-ai — Fish Shell AI Shortcuts (Plugin)

> fish-ai adds LLM shortcuts to the Fish shell: comment↔command, typo fixing, and autocomplete via hotkeys; install it with `fisher install`.

## Install

Save as a script file and run:

## Quick Use

```bash
fisher install realiserad/fish-ai
mkdir -p ~/.config
cat > ~/.config/fish-ai.ini <<'INI'
[openai]
provider = openai
api_key = <YOUR_API_KEY>
model = gpt-4o
INI
# restart fish, then use the plugin hotkeys (see README).
```

## Intro

fish-ai adds LLM shortcuts to the Fish shell: comment↔command, typo fixing, and autocomplete via hotkeys; install it with `fisher install`.

**Best for:** terminal-heavy Fish users who want faster command building and fixes

**Works with:** Fish shell, fisher, multiple LLM providers (Anthropic/OpenAI/etc.)

**Setup time:** 5-10 minutes

### Key facts (verified)

- GitHub: 530 stars · 48 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `fisher install realiserad/fish-ai`.

## Main

- Use the plugin for two high-leverage loops: turn a comment into a command (or the reverse) and repair broken commands without leaving the terminal.

- Keep provider config explicit in `fish-ai.ini` so your shell behavior is reproducible across machines and CI shells.

- Treat it like a terminal copilot: use it with verbose tools (`git`, `kubectl`, `curl`) where flags are easy to forget and hard to type.

### Source-backed notes

- README lists installation via fisher: `fisher install realiserad/fish-ai`.
- README says it supports turning comments into commands, fixing broken commands (thefuck-style), and autocomplete via keyboard shortcuts.
- README describes a config file at `$XDG_CONFIG_HOME/fish-ai.ini` (default `~/.config/fish-ai.ini`) to select providers and models.

### FAQ

- **Do I need to switch terminals?**: No — it’s a Fish plugin and runs via hotkeys inside your shell per README.
- **Where do I set API keys?**: In `fish-ai.ini` under your chosen provider section (README shows multiple providers).
- **Is it compatible with other plugins?**: README notes it does not interfere with popular plugins like `fzf.fish` and `tide`.

## Source & Thanks

> Source: https://github.com/Realiserad/fish-ai
> License: MIT
> GitHub stars: 530 · forks: 48

---

<!-- ZH -->

## Quick Use

```bash
fisher install realiserad/fish-ai
mkdir -p ~/.config
cat > ~/.config/fish-ai.ini <<'INI'
[openai]
provider = openai
api_key = <YOUR_API_KEY>
model = gpt-4o
INI
# restart fish, then use the plugin hotkeys (see README).
```

## Intro

fish-ai 为 Fish shell 增加 LLM 快捷能力：注释↔命令转换、错命令修复、热键补全等；通过 `fisher install` 安装，并用 `~/.config/fish-ai.ini` 配置 provider 与模型。

**Best for:** 大量用终端、想用快捷键提升命令效率的 Fish 用户

**Works with:** Fish shell；fisher；多种 LLM 提供方（Anthropic/OpenAI 等）

**Setup time:** 5-10 minutes

### Key facts (verified)

- GitHub：530 stars · 48 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`fisher install realiserad/fish-ai`。

## Main

- 优先把它用在两类高频场景：注释→命令/命令→注释转换，以及错命令修复；减少离开终端去查资料的次数。

- 在 `fish-ai.ini` 里显式配置 provider/model，让团队或多机器环境里行为一致、可复现。

- 把它当“终端副驾”：面对 `git`/`kubectl`/`curl` 这类参数复杂的工具时，用它补全与生成会更划算。

### Source-backed notes

- README 写明通过 fisher 安装：`fisher install realiserad/fish-ai`。
- README 描述核心能力：注释↔命令转换、错命令修复（类似 thefuck）、以及通过快捷键触发的补全建议。
- README 指出配置文件路径为 `$XDG_CONFIG_HOME/fish-ai.ini`（默认 `~/.config/fish-ai.ini`），用于选择 provider 与模型。

### FAQ

- **需要换终端或套壳吗？**：不需要。README 说明它是 Fish 插件，通过快捷键在 shell 内使用。
- **API key 在哪里配？**：在 `fish-ai.ini` 的 provider 配置段里填写（README 给出多个 provider 示例）。
- **会不会和别的插件冲突？**：README 提到不会干扰 `fzf.fish`、`tide` 等常见插件。

## Source & Thanks

> Source: https://github.com/Realiserad/fish-ai
> License: MIT
> GitHub stars: 530 · forks: 48


---
Source: https://tokrepo.com/en/workflows/fish-ai-fish-shell-ai-shortcuts-plugin
Author: Script Depot