Glossary

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 (AniDB default with provider fallback)
--calendar: Open the release calendar
--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
--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 catalog-anchored kunai:// share link for the current title
/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.
Browser / Playwright providers: planned: Archived reference only; not part of active beta runtime.
Diagnostics export: shipped: /diagnostics panel and redacted /export-diagnostics with DB-backed recent export.
Direct provider resolution: shipped: HTTP scrapers 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.
Hosted stream relay: planned: No Kunai-operated video proxy or hosted transcoding in beta v1.
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 Ink 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

Commands, CLI flags, and feature terms synced from the Kunai CLI.

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 (AniDB default with provider fallback)
--calendar: Open the release calendar
--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
--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 catalog-anchored kunai:// share link for the current title
/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.
Browser / Playwright providers: planned: Archived reference only; not part of active beta runtime.
Diagnostics export: shipped: /diagnostics panel and redacted /export-diagnostics with DB-backed recent export.
Direct provider resolution: shipped: HTTP scrapers 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.
Hosted stream relay: planned: No Kunai-operated video proxy or hosted transcoding in beta v1.
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 Ink 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.