@involvex/youtube-music-cli 0.0.44 → 0.0.46

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.0.46](https://github.com/involvex/youtube-music-cli/compare/v0.0.45...v0.0.46) (2026-02-24)
+
+### Bug Fixes
+
+- keep autoplay running and document completions ([9356c5d](https://github.com/involvex/youtube-music-cli/commit/9356c5db6583cd926a78af15302cdac5bde65aab))
+
+## [0.0.45](https://github.com/involvex/youtube-music-cli/compare/v0.0.44...v0.0.45) (2026-02-24)
+
+### Features
+
+- add volume fade duration setting for smoother playback transitions ([936e3e2](https://github.com/involvex/youtube-music-cli/commit/936e3e2c7ae043b26dd48a1cd6f2d26cb11b0ae2))
+
 ## [0.0.44](https://github.com/involvex/youtube-music-cli/compare/v0.0.43...v0.0.44) (2026-02-23)
 
 ### Features

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@involvex/youtube-music-cli",
-    "version": "0.0.44",
+    "version": "0.0.46",
     "description": "- A Commandline music player for youtube-music",
     "repository": {
         "type": "git",

package/dist/source/cli.js

@@ -157,6 +157,7 @@ async function runDirectPlaybackCommand(flags) {
     const playbackOptions = {
         volume: flags.volume ?? config.get('volume'),
         audioNormalization: config.get('audioNormalization'),
+        volumeFadeDuration: config.get('volumeFadeDuration'),
     };
     let track;
     if (flags.playTrack) {

package/dist/source/components/settings/Settings.js

@@ -21,11 +21,13 @@ const EQUALIZER_PRESETS = [
     'bright',
     'warm',
 ];
+const VOLUME_FADE_PRESETS = [0, 1, 2, 3, 5];
 const SETTINGS_ITEMS = [
     'Stream Quality',
     'Audio Normalization',
     'Gapless Playback',
     'Crossfade Duration',
+    'Volume Fade Duration',
     'Equalizer Preset',
     'Notifications',
     'Discord Rich Presence',
@@ -47,6 +49,7 @@ export default function Settings() {
     const [audioNormalization, setAudioNormalization] = useState(config.get('audioNormalization') ?? false);
     const [gaplessPlayback, setGaplessPlayback] = useState(config.get('gaplessPlayback') ?? true);
     const [crossfadeDuration, setCrossfadeDuration] = useState(config.get('crossfadeDuration') ?? 0);
+    const [volumeFadeDuration, setVolumeFadeDuration] = useState(config.get('volumeFadeDuration') ?? 0);
     const [equalizerPreset, setEqualizerPreset] = useState(config.get('equalizerPreset') ?? 'flat');
     const [notifications, setNotifications] = useState(config.get('notifications') ?? false);
     const [discordRpc, setDiscordRpc] = useState(config.get('discordRichPresence') ?? false);
@@ -85,6 +88,13 @@ export default function Settings() {
         setCrossfadeDuration(next);
         config.set('crossfadeDuration', next);
     };
+    const cycleVolumeFadeDuration = () => {
+        const currentIndex = VOLUME_FADE_PRESETS.indexOf(volumeFadeDuration);
+        const nextIndex = currentIndex === -1 ? 0 : (currentIndex + 1) % VOLUME_FADE_PRESETS.length;
+        const next = VOLUME_FADE_PRESETS[nextIndex] ?? 0;
+        setVolumeFadeDuration(next);
+        config.set('volumeFadeDuration', next);
+    };
     const cycleEqualizerPreset = () => {
         const currentIndex = EQUALIZER_PRESETS.indexOf(equalizerPreset);
         const nextPreset = EQUALIZER_PRESETS[(currentIndex + 1) % EQUALIZER_PRESETS.length];
@@ -142,36 +152,39 @@ export default function Settings() {
             cycleCrossfadeDuration();
         }
         else if (selectedIndex === 4) {
-            cycleEqualizerPreset();
+            cycleVolumeFadeDuration();
         }
         else if (selectedIndex === 5) {
-            toggleNotifications();
+            cycleEqualizerPreset();
         }
         else if (selectedIndex === 6) {
-            toggleDiscordRpc();
+            toggleNotifications();
         }
         else if (selectedIndex === 7) {
-            toggleDownloadsEnabled();
+            toggleDiscordRpc();
         }
         else if (selectedIndex === 8) {
-            setIsEditingDownloadDirectory(true);
+            toggleDownloadsEnabled();
         }
         else if (selectedIndex === 9) {
-            cycleDownloadFormat();
+            setIsEditingDownloadDirectory(true);
         }
         else if (selectedIndex === 10) {
-            cycleSleepTimer();
+            cycleDownloadFormat();
         }
         else if (selectedIndex === 11) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.IMPORT });
+            cycleSleepTimer();
         }
         else if (selectedIndex === 12) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.EXPORT_PLAYLISTS });
+            dispatch({ category: 'NAVIGATE', view: VIEW.IMPORT });
         }
         else if (selectedIndex === 13) {
-            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+            dispatch({ category: 'NAVIGATE', view: VIEW.EXPORT_PLAYLISTS });
         }
         else if (selectedIndex === 14) {
+            dispatch({ category: 'NAVIGATE', view: VIEW.KEYBINDINGS });
+        }
+        else if (selectedIndex === 15) {
             dispatch({ category: 'NAVIGATE', view: VIEW.PLUGINS });
         }
     };
@@ -181,7 +194,7 @@ export default function Settings() {
     const sleepTimerLabel = isActive && remainingSeconds !== null
         ? `Sleep Timer: ${formatTime(remainingSeconds)} remaining (Enter to cancel)`
         : 'Sleep Timer: Off (Enter to set)';
-    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Box, { borderStyle: "double", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Settings" }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 0 ? theme.colors.primary : undefined, color: selectedIndex === 0 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 0, children: ["Stream Quality: ", quality.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 1 ? theme.colors.primary : undefined, color: selectedIndex === 1 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 1, children: ["Audio Normalization: ", audioNormalization ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 2 ? theme.colors.primary : undefined, color: selectedIndex === 2 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 2, children: ["Gapless Playback: ", gaplessPlayback ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 3 ? theme.colors.primary : undefined, color: selectedIndex === 3 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 3, children: ["Crossfade: ", crossfadeDuration === 0 ? 'Off' : `${crossfadeDuration}s`] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 4 ? theme.colors.primary : undefined, color: selectedIndex === 4 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 4, children: ["Equalizer: ", formatEqualizerLabel(equalizerPreset)] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: ["Desktop Notifications: ", notifications ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 6 ? theme.colors.primary : undefined, color: selectedIndex === 6 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 6, children: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 7 ? theme.colors.primary : undefined, color: selectedIndex === 7 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 7, children: ["Download Feature: ", downloadsEnabled ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: isEditingDownloadDirectory && selectedIndex === 8 ? (_jsx(TextInput, { value: downloadDirectory, onChange: setDownloadDirectory, onSubmit: value => {
+    return (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsx(Box, { borderStyle: "double", borderColor: theme.colors.secondary, paddingX: 1, marginBottom: 1, children: _jsx(Text, { bold: true, color: theme.colors.primary, children: "Settings" }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 0 ? theme.colors.primary : undefined, color: selectedIndex === 0 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 0, children: ["Stream Quality: ", quality.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 1 ? theme.colors.primary : undefined, color: selectedIndex === 1 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 1, children: ["Audio Normalization: ", audioNormalization ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 2 ? theme.colors.primary : undefined, color: selectedIndex === 2 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 2, children: ["Gapless Playback: ", gaplessPlayback ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 3 ? theme.colors.primary : undefined, color: selectedIndex === 3 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 3, children: ["Crossfade: ", crossfadeDuration === 0 ? 'Off' : `${crossfadeDuration}s`] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 4 ? theme.colors.primary : undefined, color: selectedIndex === 4 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 4, children: ["Volume Fade:", ' ', volumeFadeDuration === 0 ? 'Off' : `${volumeFadeDuration}s`] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 5 ? theme.colors.primary : undefined, color: selectedIndex === 5 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 5, children: ["Equalizer: ", formatEqualizerLabel(equalizerPreset)] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 6 ? theme.colors.primary : undefined, color: selectedIndex === 6 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 6, children: ["Desktop Notifications: ", notifications ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 7 ? theme.colors.primary : undefined, color: selectedIndex === 7 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 7, children: ["Discord Rich Presence: ", discordRpc ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 8 ? theme.colors.primary : undefined, color: selectedIndex === 8 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 8, children: ["Download Feature: ", downloadsEnabled ? 'ON' : 'OFF'] }) }), _jsx(Box, { paddingX: 1, children: isEditingDownloadDirectory && selectedIndex === 9 ? (_jsx(TextInput, { value: downloadDirectory, onChange: setDownloadDirectory, onSubmit: value => {
                         const normalized = value.trim();
                         if (!normalized) {
                             setIsEditingDownloadDirectory(false);
@@ -190,9 +203,9 @@ export default function Settings() {
                         setDownloadDirectory(normalized);
                         config.set('downloadDirectory', normalized);
                         setIsEditingDownloadDirectory(false);
-                    }, placeholder: "Download directory", focus: true })) : (_jsxs(Text, { backgroundColor: selectedIndex === 8 ? theme.colors.primary : undefined, color: selectedIndex === 8 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 8, children: ["Download Folder: ", downloadDirectory] })) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 9 ? theme.colors.primary : undefined, color: selectedIndex === 9 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 9, children: ["Download Format: ", downloadFormat.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 10 ? theme.colors.primary : undefined, color: selectedIndex === 10
+                    }, placeholder: "Download directory", focus: true })) : (_jsxs(Text, { backgroundColor: selectedIndex === 9 ? theme.colors.primary : undefined, color: selectedIndex === 9 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 9, children: ["Download Folder: ", downloadDirectory] })) }), _jsx(Box, { paddingX: 1, children: _jsxs(Text, { backgroundColor: selectedIndex === 10 ? theme.colors.primary : undefined, color: selectedIndex === 10 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 10, children: ["Download Format: ", downloadFormat.toUpperCase()] }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 11 ? theme.colors.primary : undefined, color: selectedIndex === 11
                         ? theme.colors.background
                         : isActive
                             ? theme.colors.accent
-                            : theme.colors.text, bold: selectedIndex === 10, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 11 ? theme.colors.primary : undefined, color: selectedIndex === 11 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 11, children: "Import Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 12 ? theme.colors.primary : undefined, color: selectedIndex === 12 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 12, children: "Export Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 13 ? theme.colors.primary : undefined, color: selectedIndex === 13 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 13, children: "Custom Keybindings \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 14 ? theme.colors.primary : undefined, color: selectedIndex === 14 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 14, children: "Manage Plugins" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.colors.dim, children: "Arrows to navigate, Enter to select, Esc/q to go back" }) })] }));
+                            : theme.colors.text, bold: selectedIndex === 11, children: sleepTimerLabel }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 12 ? theme.colors.primary : undefined, color: selectedIndex === 12 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 12, children: "Import Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 13 ? theme.colors.primary : undefined, color: selectedIndex === 13 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 13, children: "Export Playlists \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 14 ? theme.colors.primary : undefined, color: selectedIndex === 14 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 14, children: "Custom Keybindings \u2192" }) }), _jsx(Box, { paddingX: 1, children: _jsx(Text, { backgroundColor: selectedIndex === 15 ? theme.colors.primary : undefined, color: selectedIndex === 15 ? theme.colors.background : theme.colors.text, bold: selectedIndex === 15, children: "Manage Plugins" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.colors.dim, children: "Arrows to navigate, Enter to select, Esc/q to go back" }) })] }));
 }

package/dist/source/services/config/config.service.js

@@ -43,6 +43,7 @@ class ConfigService {
             },
             gaplessPlayback: true,
             crossfadeDuration: 0,
+            volumeFadeDuration: 0,
             equalizerPreset: 'flat',
         };
     }

package/dist/source/services/player/player.service.d.ts

@@ -6,6 +6,7 @@ export type PlayOptions = {
     gaplessPlayback?: boolean;
     crossfadeDuration?: number;
     equalizerPreset?: EqualizerPreset;
+    volumeFadeDuration?: number;
 };
 export type MpvArgsOptions = PlayOptions & {
     volume: number;

package/dist/source/services/player/player.service.js

@@ -5,11 +5,16 @@ import { logger } from "../logger/logger.service.js";
 export function buildMpvArgs(url, ipcPath, options) {
     const gapless = options.gaplessPlayback ?? true;
     const crossfadeDuration = Math.max(0, options.crossfadeDuration ?? 0);
+    const fadeDuration = Math.max(0, options.volumeFadeDuration ?? 0);
     const eqPreset = options.equalizerPreset ?? 'flat';
     const audioFilters = [];
     if (options.audioNormalization) {
         audioFilters.push('dynaudnorm');
     }
+    if (fadeDuration > 0) {
+        audioFilters.push(`afade=t=in:st=0:d=${fadeDuration}`);
+        audioFilters.push(`afade=t=out:d=${fadeDuration}`);
+    }
     if (crossfadeDuration > 0) {
         audioFilters.push(`acrossfade=d=${crossfadeDuration}`);
     }

package/dist/source/services/web/web-server-manager.js

@@ -141,6 +141,7 @@ class WebServerManager {
     handleCommand(action) {
         logger.debug('WebServerManager', 'Executing command from client', { action });
         const playerService = getPlayerService();
+        const config = getConfigService();
         // Execute command and update internal state
         switch (action.category) {
             case 'PLAY': {
@@ -152,6 +153,7 @@ class WebServerManager {
                     const youtubeUrl = `https://www.youtube.com/watch?v=${action.track.videoId}`;
                     void playerService.play(youtubeUrl, {
                         volume: this.internalState.volume,
+                        volumeFadeDuration: config.get('volumeFadeDuration'),
                     });
                 }
                 break;
@@ -202,6 +204,7 @@ class WebServerManager {
                     const youtubeUrl = `https://www.youtube.com/watch?v=${this.internalState.currentTrack.videoId}`;
                     void playerService.play(youtubeUrl, {
                         volume: this.internalState.volume,
+                        volumeFadeDuration: config.get('volumeFadeDuration'),
                     });
                 }
                 break;

package/dist/source/stores/player.store.js

@@ -251,6 +251,7 @@ function PlayerManager() {
     }, [dispatch]);
     // Register event handler for mpv IPC events
     const eofTimestampRef = useRef(0);
+    const lastAutoNextRef = useRef(0);
     useEffect(() => {
         let lastProgressUpdate = 0;
         const PROGRESS_THROTTLE_MS = 1000; // Update progress max once per second
@@ -269,8 +270,10 @@ function PlayerManager() {
             if (event.eof) {
                 // Track ended — record timestamp so we can suppress mpv's spurious
                 // pause event that immediately follows EOF (idle state).
-                eofTimestampRef.current = Date.now();
+                const now = Date.now();
+                eofTimestampRef.current = now;
                 next();
+                lastAutoNextRef.current = now;
             }
             if (event.paused !== undefined) {
                 // mpv sends pause=true when a track ends and it enters idle mode.
@@ -402,6 +405,7 @@ function PlayerManager() {
                         gaplessPlayback: config.get('gaplessPlayback') ?? true,
                         crossfadeDuration: config.get('crossfadeDuration') ?? 0,
                         equalizerPreset: config.get('equalizerPreset') ?? 'flat',
+                        volumeFadeDuration: config.get('volumeFadeDuration') ?? 0,
                     });
                     logger.info('PlayerManager', 'Playback started successfully', {
                         attempt,
@@ -504,14 +508,45 @@ function PlayerManager() {
         config.set('volume', state.volume);
     }, [state.volume]);
     // Handle track completion
+    const autoAdvanceRef = useRef(false);
     useEffect(() => {
-        if (state.duration > 0 && state.progress >= state.duration) {
-            if (state.repeat === 'one') {
-                dispatch({ category: 'SEEK', position: 0 });
-            }
-            // next() for regular track completion is handled by the eof IPC event
+        if (state.duration <= 0) {
+            autoAdvanceRef.current = false;
+            return;
+        }
+        if (state.progress < state.duration) {
+            autoAdvanceRef.current = false;
+            return;
         }
-    }, [state.progress, state.duration, state.repeat, dispatch]);
+        if (state.repeat === 'one') {
+            dispatch({ category: 'SEEK', position: 0 });
+            return;
+        }
+        const hasNextTrack = state.queue.length > 0 &&
+            (state.repeat === 'all' ||
+                state.queuePosition < state.queue.length - 1 ||
+                (state.shuffle && state.queue.length > 1));
+        if (!hasNextTrack) {
+            return;
+        }
+        const now = Date.now();
+        if (now - lastAutoNextRef.current < 1500) {
+            return;
+        }
+        if (!autoAdvanceRef.current) {
+            autoAdvanceRef.current = true;
+            lastAutoNextRef.current = now;
+            dispatch({ category: 'NEXT' });
+        }
+    }, [
+        state.duration,
+        state.progress,
+        state.repeat,
+        state.queue.length,
+        state.queuePosition,
+        state.shuffle,
+        dispatch,
+    ]);
     return null;
 }
 export function PlayerProvider({ children }) {

package/dist/source/types/config.types.d.ts

@@ -23,6 +23,7 @@ export interface Config {
     audioNormalization?: boolean;
     gaplessPlayback?: boolean;
     crossfadeDuration?: number;
+    volumeFadeDuration?: number;
     equalizerPreset?: EqualizerPreset;
     notifications?: boolean;
     scrobbling?: {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@involvex/youtube-music-cli",
-	"version": "0.0.44",
+	"version": "0.0.46",
 	"description": "- A Commandline music player for youtube-music",
 	"repository": {
 		"type": "git",

package/readme.md

@@ -27,6 +27,7 @@ A powerful Terminal User Interface (TUI) music player for YouTube Music
 - 🖥️ **Headless Mode** - Run without TUI for scripting
 - 💾 **Downloads** - Save tracks/playlists/artists with `Shift+D`
 - 🏷️ **Metadata Tagging** - Auto-tag title/artist/album with optional cover art
+- ⚡️ **Shell Completions** - `ymc completions <bash|zsh|powershell|fish>` emits scripts you can source or save so the CLI (also available as `ymc`) tab-completes subcommands and flags
 
 ## Roadmap
 
@@ -161,6 +162,28 @@ youtube-music-cli skip
 youtube-music-cli back
 ```
 
+### Shell completions
+
+Generate shell completion helpers through the lightweight `ymc` alias that ships with the CLI. Run `ymc completions <bash|zsh|powershell|fish>` to print the completion script for your shell, then source it or persist it in your profile:
+
+```bash
+# Bash
+source <(ymc completions bash)
+ymc completions bash >> ~/.bash_completion
+
+# Zsh
+source <(ymc completions zsh)
+
+# PowerShell
+ymc completions powershell | Out-File -Encoding utf8 $PROFILE
+Invoke-Expression (ymc completions powershell)
+
+# Fish
+ymc completions fish > ~/.config/fish/completions/ymc.fish
+```
+
+If you installed the CLI globally with an alias or script name, make sure `ymc` points at the same binary before generating completions so that the script matches your install path.
+
 ### Options
 
 | Flag         | Short | Description                                  |