---
title: C1 — Command Shadows
---

Disabling `__fish_config_op_aliases` restores standard system behavior for
all of these commands.

    Command / Alias    Active behavior                       Disabled fallback
    ───────────────────────────────────────────────────────────────────────────
    ls                 eza -l -a --icons --hyperlink          system ls
    cat                bat syntax-highlighted; dirs → ls      /usr/bin/cat
    cd                 zoxide frecency-based navigation        fish builtin cd
    rm                 moves files to trash (recoverable)     command rm (permanent)
    less               $PAGER → ov → less → more → cat       system less
    du                 duf (disk overview) or dust (dir tree)  system du
    top                btop resource monitor                  system top
    ping               prettyping --nolegend animation        system ping
    ssh                kitten ssh in Kitty terminal           system ssh
    rg                 rg --hyperlink-format=kitty            system rg
    mkdir              verbose path-tree display on creation  mkdir -p silently
    bash               XDG bashrc + $SHELL reset on exit      system bash
    cp / mv            forced -i confirmation prompt          cp / mv unmodified
    wget               forced --continue (resume downloads)   system wget
    grep/fgrep/egrep   forced --color=auto                    system grep variants
    dir / vdir         forced --color=auto                    system dir / vdir
    help config        intercepts "help config" → config-help  fish builtin help
    claude             auto-links AGENTS.md as CLAUDE.md before launch  command claude
    edit               multi-editor launcher (GUI/term + fallbacks)  $EDITOR/nvim/nano/vi

When C1 is disabled, `rm` uses bare `command rm` with no wrapper — files
are permanently deleted, not trashed. There is no intermediate safety net.

`history` itself is never shadowed — every function in this config that
reads history depends on its stock builtin semantics. `pretty-history`
(same `aliases-tricks` toggle) is a separate command that prints history
with a timestamp prepended to every entry.

## Sub-categories

`__fish_config_op_aliases` sub-divides into six sub-categories, each with
its own `__fish_config_op_aliases_<slug>` toggle:

## filesystem

`ls`, `cat`, `cd`, `du`, `mkdir`, `rm`, `mv`, and `cd`/zoxide navigation --
the everyday filesystem-inspection and -modification shadows.

## search

`rg`, with its Kitty hyperlink formatting.

## network

`ping`, `ssh`, and `yt-dlp` -- shadows that talk to the network.

## monitor

`top` -> `btop`.

## shell-tools

`bash` (XDG bashrc + `$SHELL` reset), `less` (`$PAGER` fallback chain),
and the `help config` interception.

## dev-tools

`claude` (AGENTS.md/CLAUDE.md auto-linking) and `edit` (multi-editor
launcher), plus `agy`.

## For function authors

Calling one of these names bare from inside your own function means the
override runs whenever C1 (or its sub-category) is on — which may not be
what your function wants: a shadow can change stdout (`cat`'s syntax
highlighting, `mkdir`'s tree display), prompt interactively where none is
expected (`cp`/`mv`'s forced `-i`), or reshape output structurally (`ls`'s
icons/columns, `rg`'s hyperlink markers). If your function's logic depends
on stock behavior, bypass the shadow deterministically, regardless of the
toggle state:

    Shadow                  Bypass                        Why
    ─────────────────────────────────────────────────────────────────────────
    ls, cat, rm, less, du,  command <name>                Real external
    top, ping, ssh, rg,                                    binaries — a
    mkdir, bash, cp, mv,                                    real system command
    wget, grep/fgrep/egrep,                                exists to fall
    dir/vdir, claude                                        back to.
    cd                       builtin cd                    The one true
                                                             fish builtin
                                                             in this table.
    help config              __original_help $argv         `help` is neither
                                                             a builtin nor an
                                                             external binary
                                                             (embedded in the
                                                             fish binary
                                                             itself) — see
                                                             conf.d/help.fish
                                                             for why the
                                                             wrapper keeps its
                                                             own backup copy.
    edit                     (nothing to bypass to)         Purely our own
                                                             invention, no
                                                             stock command
                                                             exists. Call
                                                             $EDITOR/$VISUAL
                                                             yourself if you
                                                             want a plain
                                                             editor launch.

A function's own doc header records which of these it depends on: see the
`CLASSIFICATION` label (`uses-shadow(...)` / `bypasses-shadow(...)`),
documented in full at
[`docs/function-classification-schema.md`](../../function-classification-schema.md).