Glossary

Kunai commands, CLI flags, and feature terms defined in one place and synced from the CLI, so the vocabulary in the docs matches the vocabulary in the shell.

Who this is for: readers who hit an unfamiliar term on another docs page.

You will learn: short definitions for shell commands, launch flags, and feature names, generated from the same metadata as the CLI Reference and Feature tour.

Run bun run --cwd apps/docs generate after registry changes to refresh this page.

--anime: Anime mode (HiAnime default with provider fallback)
--calendar: Open the release calendar
--continue: Jump into Continue Watching
--debug: Verbose redacted logging to ./logs.txt
--debug-json: Debug + JSON event stream
--debug-session: Debug + full session trace
--discover: Open recommendations
--download: Download-only flow for a selected title (use with -S or -i; does not open the shell queue)
--download-path: Override the download directory
--dry-run: Print what would happen, change nothing
--handoff-url: Internal: open a kunai:// deep link
--help: Show this help
--history: Open watch history
--id: Open a specific title id or namespaced catalog id
--install-protocol-handler: Register the Linux-only kunai:// URL handler
--jump: Auto-pick the n-th search result (1-based, with -S)
--minimal: Minimal chrome
--mpv-clean: Ignore your mpv config for this run
--mpv-debug: Verbose mpv logging
--mpv-log-file: Write the mpv log to a file
--no-user-mpv-config: Same, explicit
--offline: Offline library only (no provider calls)
--open: Open a trusted kunai:// share link
--quick: Quick layout
--random: Open the random picks tray
--resume: Jump into Continue Watching
--search: Search for a title on launch
--setup: Run the setup wizard
--support-bundle: Write a redacted local support bundle and exit
--type: Content type for --id (tv = series)
--version: Print the version
--youtube: YouTube mode (YouTube provider)
--zen: Zen mode (bare, ani-cli-style)
/about: Show version and capability information
/analytics: Anonymous usage ping — status, payload, and consent
/analytics-show: Print the exact JSON that would be sent
/anime-calendar: Release schedule filtered to anime
/anime-mode: Switch into anime mode
/audio: Open the tracks panel at the audio section
/bookmark: Save or unsave the current title in your watchlist
/calendar: Anime and series release schedule
/clear-cache: Clear stream URL cache (and optionally provider failure memory)
/clear-history: Remove all watch history and progress
/continue: Open unfinished and recent watch progress
/details: Open the expanded title overview
/diagnostics: Open diagnostics
/docs: Open Kunai documentation
/download: Queue the selected title for offline download
/downloads: Inspect active, queued, and failed download jobs
/export-diagnostics: Export recent diagnostics to a redacted JSON file
/fallback: Stop waiting on the current provider and try the next compatible provider
/favorites: View your favorite titles
/filters: Show supported search filter syntax
/follow: Track future releases and notices for the current title
/help: Show shortcuts and command help
/history: Open watch history
/image-pane: Toggle the image and details companion pane
/library: Browse offline library and manage downloads
/mark-anime: Reclassify the current title as anime in your history (fixes a wrong label)
/mark-season-watched: Mark every episode in the current season up to the current episode as watched
/mark-series: Reclassify the current title as series in your history (fixes a wrong label)
/mark-unwatched: Clear the watched flag while keeping resume position
/mark-up-to-episode: Pick an episode and mark the whole season through that episode as watched
/mark-watched: Mark the current movie or episode as fully watched
/memory: Temporarily show runtime memory usage
/menu: Open the unified title control menu
/mute: Stop release notices for the current title
/next: Advance to the next episode
/next-season: Jump to the next season
/notifications: Review actionable app notices and recoverable queues
/pick-episode: Open the episode picker
/play-local: Switch the current episode to the verified offline download
/playlist-add: Add the current title to Up Next
/playlists: View and manage durable playlists
/presence: Open settings for Discord Rich Presence setup and status
/previous: Go to the previous episode
/provider: Open the providers hub (or tracks provider section while playing)
/providers: Switch the session provider or set defaults and priority
/quality: Open the tracks panel at the quality section
/queue-season: Queue remaining episodes in the current season
/quit: Exit Kunai
/random: Random recommendation tray without autoplay
/recommendation: Personalized recommendations and discovery
/recompute: Re-resolve on the current provider only: bypass stream cache and provider memory, then probe all VidKing sources
/recover: Refresh the current stream and resume this episode after a playback issue
/replay: Restart the current item from the beginning without refreshing the source
/report-issue: Open the GitHub issue page with diagnostics guidance
/reset-provider-health: Forget provider failures so auto-fallback can retry down providers
/search: Start a new search
/series-calendar: Release schedule filtered to series
/series-mode: Switch into series and movies mode
/settings: Open settings (relay, playback, shell, and more)
/setup: Configure downloads and offline defaults
/share: Copy a browser-safe HTTPS share link for the current title
/share-qr: Show a scannable HTTPS share QR and copy the full link
/source: Open the tracks panel at the source / servers section
/stats: Watch stats, streak, and top shows
/stop-after-current: Stop after current episode instead of continuing
/subtitle: Open the tracks panel at the subtitles section
/surprise: Surprise pick without autoplay
/sync: Experimental AniList progress and tracker list sync
/sync-connect-anilist: Link your AniList account to sync watch progress
/sync-connect-tmdb: Link your TMDB account to sync watchlist and favourites
/sync-disconnect: Remove linked sync accounts
/toggle-autoplay: Temporarily pause or resume autoplay for this playback chain
/toggle-autoskip: Temporarily pause or resume auto-skip for this session
/toggle-mode: Cycle catalog mode: series, anime, then YouTube
/trending: Load the cached trending discovery list
/unfollow: Stop explicit release tracking without muting the title
/up-next: View and manage the current playback order
/update: Check for a new Kunai version and show safe update guidance
/watch: Open a kunai:// share link from your clipboard
/watch-online: Switch the current episode back to online provider streaming
/watchlist: View and manage the built-in Watchlist
/youtube-mode: Switch into YouTube mode
AniList / TMDB sync: beta: Experimental opt-in AniList progress and tracker list membership sync; requires a disposable-account live smoke before release-ready status.
Diagnostics export: shipped: /diagnostics panel and redacted /export-diagnostics with DB-backed recent export.
Direct provider resolution: shipped: HTTP provider adapters in packages/providers, without browser automation.
Discord Rich Presence: shipped: Opt-in social status integration; off by default until configured.
Download quality floor: beta: Shared quality policy for download jobs via defaultDownloadQuality setting.
History continuation: shipped: Continue unfinished titles from History with catalog bounds and source preference.
install.sh / install.ps1: beta: Preferred native binary installers; Bun/npm secondary; source contributor-oriented.
kunai:// share links: shipped: Catalog-anchored share URLs via /share, /watch, kunai --open, and mpv hotkey.
mpv playback: shipped: Kunai resolves streams; mpv is the playback engine.
Network status indicator: shipped: Shell header shows connectivity; offline mode is explicit, never silent.
Notifications inbox: shipped: Shell notifications for downloads, playback, and setup guidance.
Offline downloads: beta: Queue downloads and play completed artifacts without provider calls.
Persistent offline mode: beta: Configurable local-only shell mode separate from the --offline launch flag.
Provider endpoint health: shipped: Local health memory, /recompute bypass, and /reset-provider-health recovery.
Terminal shell: shipped: Persistent terminal shell with search, playback, and recovery workflows.
User-owned provider geo relay: beta: Optional metadata/API relay template for geo-blocked providers; video remains direct.

Glossary

Kunai commands, CLI flags, and feature terms defined in one place and synced from the CLI, so the vocabulary in the docs matches the vocabulary in the shell.

Who this is for: readers who hit an unfamiliar term on another docs page.

You will learn: short definitions for shell commands, launch flags, and feature names, generated from the same metadata as the CLI Reference and Feature tour.

Run bun run --cwd apps/docs generate after registry changes to refresh this page.

--anime: Anime mode (HiAnime default with provider fallback)
--calendar: Open the release calendar
--continue: Jump into Continue Watching
--debug: Verbose redacted logging to ./logs.txt
--debug-json: Debug + JSON event stream
--debug-session: Debug + full session trace
--discover: Open recommendations
--download: Download-only flow for a selected title (use with -S or -i; does not open the shell queue)
--download-path: Override the download directory
--dry-run: Print what would happen, change nothing
--handoff-url: Internal: open a kunai:// deep link
--help: Show this help
--history: Open watch history
--id: Open a specific title id or namespaced catalog id
--install-protocol-handler: Register the Linux-only kunai:// URL handler
--jump: Auto-pick the n-th search result (1-based, with -S)
--minimal: Minimal chrome
--mpv-clean: Ignore your mpv config for this run
--mpv-debug: Verbose mpv logging
--mpv-log-file: Write the mpv log to a file
--no-user-mpv-config: Same, explicit
--offline: Offline library only (no provider calls)
--open: Open a trusted kunai:// share link
--quick: Quick layout
--random: Open the random picks tray
--resume: Jump into Continue Watching
--search: Search for a title on launch
--setup: Run the setup wizard
--support-bundle: Write a redacted local support bundle and exit
--type: Content type for --id (tv = series)
--version: Print the version
--youtube: YouTube mode (YouTube provider)
--zen: Zen mode (bare, ani-cli-style)
/about: Show version and capability information
/analytics: Anonymous usage ping — status, payload, and consent
/analytics-show: Print the exact JSON that would be sent
/anime-calendar: Release schedule filtered to anime
/anime-mode: Switch into anime mode
/audio: Open the tracks panel at the audio section
/bookmark: Save or unsave the current title in your watchlist
/calendar: Anime and series release schedule
/clear-cache: Clear stream URL cache (and optionally provider failure memory)
/clear-history: Remove all watch history and progress
/continue: Open unfinished and recent watch progress
/details: Open the expanded title overview
/diagnostics: Open diagnostics
/docs: Open Kunai documentation
/download: Queue the selected title for offline download
/downloads: Inspect active, queued, and failed download jobs
/export-diagnostics: Export recent diagnostics to a redacted JSON file
/fallback: Stop waiting on the current provider and try the next compatible provider
/favorites: View your favorite titles
/filters: Show supported search filter syntax
/follow: Track future releases and notices for the current title
/help: Show shortcuts and command help
/history: Open watch history
/image-pane: Toggle the image and details companion pane
/library: Browse offline library and manage downloads
/mark-anime: Reclassify the current title as anime in your history (fixes a wrong label)
/mark-season-watched: Mark every episode in the current season up to the current episode as watched
/mark-series: Reclassify the current title as series in your history (fixes a wrong label)
/mark-unwatched: Clear the watched flag while keeping resume position
/mark-up-to-episode: Pick an episode and mark the whole season through that episode as watched
/mark-watched: Mark the current movie or episode as fully watched
/memory: Temporarily show runtime memory usage
/menu: Open the unified title control menu
/mute: Stop release notices for the current title
/next: Advance to the next episode
/next-season: Jump to the next season
/notifications: Review actionable app notices and recoverable queues
/pick-episode: Open the episode picker
/play-local: Switch the current episode to the verified offline download
/playlist-add: Add the current title to Up Next
/playlists: View and manage durable playlists
/presence: Open settings for Discord Rich Presence setup and status
/previous: Go to the previous episode
/provider: Open the providers hub (or tracks provider section while playing)
/providers: Switch the session provider or set defaults and priority
/quality: Open the tracks panel at the quality section
/queue-season: Queue remaining episodes in the current season
/quit: Exit Kunai
/random: Random recommendation tray without autoplay
/recommendation: Personalized recommendations and discovery
/recompute: Re-resolve on the current provider only: bypass stream cache and provider memory, then probe all VidKing sources
/recover: Refresh the current stream and resume this episode after a playback issue
/replay: Restart the current item from the beginning without refreshing the source
/report-issue: Open the GitHub issue page with diagnostics guidance
/reset-provider-health: Forget provider failures so auto-fallback can retry down providers
/search: Start a new search
/series-calendar: Release schedule filtered to series
/series-mode: Switch into series and movies mode
/settings: Open settings (relay, playback, shell, and more)
/setup: Configure downloads and offline defaults
/share: Copy a browser-safe HTTPS share link for the current title
/share-qr: Show a scannable HTTPS share QR and copy the full link
/source: Open the tracks panel at the source / servers section
/stats: Watch stats, streak, and top shows
/stop-after-current: Stop after current episode instead of continuing
/subtitle: Open the tracks panel at the subtitles section
/surprise: Surprise pick without autoplay
/sync: Experimental AniList progress and tracker list sync
/sync-connect-anilist: Link your AniList account to sync watch progress
/sync-connect-tmdb: Link your TMDB account to sync watchlist and favourites
/sync-disconnect: Remove linked sync accounts
/toggle-autoplay: Temporarily pause or resume autoplay for this playback chain
/toggle-autoskip: Temporarily pause or resume auto-skip for this session
/toggle-mode: Cycle catalog mode: series, anime, then YouTube
/trending: Load the cached trending discovery list
/unfollow: Stop explicit release tracking without muting the title
/up-next: View and manage the current playback order
/update: Check for a new Kunai version and show safe update guidance
/watch: Open a kunai:// share link from your clipboard
/watch-online: Switch the current episode back to online provider streaming
/watchlist: View and manage the built-in Watchlist
/youtube-mode: Switch into YouTube mode
AniList / TMDB sync: beta: Experimental opt-in AniList progress and tracker list membership sync; requires a disposable-account live smoke before release-ready status.
Diagnostics export: shipped: /diagnostics panel and redacted /export-diagnostics with DB-backed recent export.
Direct provider resolution: shipped: HTTP provider adapters in packages/providers, without browser automation.
Discord Rich Presence: shipped: Opt-in social status integration; off by default until configured.
Download quality floor: beta: Shared quality policy for download jobs via defaultDownloadQuality setting.
History continuation: shipped: Continue unfinished titles from History with catalog bounds and source preference.
install.sh / install.ps1: beta: Preferred native binary installers; Bun/npm secondary; source contributor-oriented.
kunai:// share links: shipped: Catalog-anchored share URLs via /share, /watch, kunai --open, and mpv hotkey.
mpv playback: shipped: Kunai resolves streams; mpv is the playback engine.
Network status indicator: shipped: Shell header shows connectivity; offline mode is explicit, never silent.
Notifications inbox: shipped: Shell notifications for downloads, playback, and setup guidance.
Offline downloads: beta: Queue downloads and play completed artifacts without provider calls.
Persistent offline mode: beta: Configurable local-only shell mode separate from the --offline launch flag.
Provider endpoint health: shipped: Local health memory, /recompute bypass, and /reset-provider-health recovery.
Terminal shell: shipped: Persistent terminal shell with search, playback, and recovery workflows.
User-owned provider geo relay: beta: Optional metadata/API relay template for geo-blocked providers; video remains direct.