ScriptsMay 13, 2026·2 min read

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`.

Script Depot
Script Depot · Community
Agent ready

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Stage only · 29/100Stage only
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Universal CLI install command
npx tokrepo install 6c513db3-87b7-5713-b633-ad50da1b29b1
install contractmetadata JSONadapter planraw content
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

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

fish — The Friendly Interactive Shell with Autosuggestions Built-In

fish is a command-line shell that prioritizes interactivity: autosuggestions from history, syntax highlighting as you type, smart tab completions generated from man pages, and sensible defaults — no configuration required.

Scripts
Script Depot

Webhook — Lightweight Server for Running Shell Commands via HTTP

A small, configurable Go server that listens for incoming HTTP webhooks and executes shell commands. Useful for automating deployments, CI/CD triggers, and integrating services that send webhook notifications.

Scripts
Script Depot

McFly — Fly Through Your Shell History with Context-Aware Search

McFly replaces the default Ctrl-R reverse search in bash/zsh/fish with a neural-ranked, context-aware history finder that considers directory, exit status, and recency.

Scripts
Script Depot

zx — Write Better Shell Scripts in JavaScript

A tool by Google for writing shell scripts using JavaScript with built-in support for command execution, pipes, and popular CLI utilities like cd, fetch, and chalk.

Scripts
Script Depot
◈Home🔍Search👤Me