Commands and Shortcuts
Every Kunai shell command, playback shortcut, overlay, and safe action, plus the full searchable command registry generated straight from the CLI itself.
Kunai keeps the command palette context-aware. Press / in the shell to open the
available actions for the current screen. During playback, the same actions stay
available without losing the playing context.
Press ? in the shell for the full live help overlay. The table below is a
deliberately reduced public reference generated from the keybinding registry.
Personal Media Vocabulary
- Watchlist: built-in watch-later list (
/watchlist,/wl) - Playlists: durable named collections (
/playlists;/playlistand/plare aliases) - Up Next: current playback order (
/up-next;/queueis a compatibility alias) - Downloads: offline download jobs (
/downloads) - Follow / Unfollow / Mute: release attention, not saved-for-later state
- Favourites: browse
fstars a row; it is not Watchlist and not Up Next
Global Commands
/searchstarts a new search./historyopens recent playback progress./watchlistopens the built-in watch-later list./playlistsopens durable saved playlists./up-nextopens the current playback order./playlist-addadds the selected or active title to Up Next./queue-seasonqueues the rest of the current season after the selected episode./imagetoggles the image and details companion pane when the terminal supports it./libraryopens the offline library with completed local downloads./play-localopens a file picker for local media playback./watch-onlinereturns from offline posture to online shell flows when network allows./downloadsopens active, queued, failed, and retryable download jobs./notificationsopens the notification inbox./provideropens the provider picker without changing provider until confirmed./follow,/unfollow, and/mutechange release attention for the current title./bookmarkadds or removes the current title from Watchlist./calendaropens release calendar results./discoverand/recommendationopen recommendation surfaces without autoplay./filtersopens guided search facets (type, year, library, and more)./sharecopies a catalog-anchored HTTPS play link to the clipboard./share --qrshows a compact HTTPS QR and also copies the full link./watchaccepts HTTPS, compactk1…, orkunai://clipboard input and launches playback.
/stats is on the default browse palette. Tracker sync is experimental and lives under
/settings → Sync. /random and /surprise are on the default browse palette
alongside /trending, and also reachable with the kunai --random launch flag.
The tray size follows Settings → Discover → Discover tray size.
Playback Commands
/recoverrefreshes the active stream from the current provider and resumes./recomputebypasses stream cache and provider health memory for the current episode when source inventory looks stale./fallbacktries the next compatible provider when the active provider fails./replaystarts the current episode again from the beginning./sourceor/tracksopens the grouped media panel for source, quality, audio, hardsub, and subtitle facts./sourceand/qualityjump straight to those picker sections when they have switchable alternatives./pick-episode,/next,/previous, and/next-seasonnavigate episodes only when the target exists./downloadqueues the selected or active item for offline use after the required confirmation path./toggle-autoplay,/toggle-autoskip, and/stop-after-currentchange the current playback chain only.
Overlays
Help, diagnostics, settings, notifications, history, downloads, and provider pickers are overlays. They should not destroy the underlying playback or browse context. Close the overlay to return where you were.
Every shell command
The full command registry, searchable. Generated from the CLI; it updates when
you run bun run --cwd apps/docs generate.
| Command | Label | Aliases | Description |
|---|---|---|---|
| /setup | Setup Wizard | setup, onboarding, wizard | Configure downloads and offline defaults |
| /download | Download | download, save | Queue the selected title for offline download |
| /downloads | Download Queue | downloads, download-jobs, jobs | Inspect active, queued, and failed download jobs |
| /library | Library | library, offline, offline-library, my-downloads | Browse offline library and manage downloads |
| /search | Search | search, find | Start a new search |
| /filters | Filters | filters, advanced-search, filter | Show supported search filter syntax |
| /trending | Trending | trending, popular | Load the cached trending discovery list |
| /recommendation | Recommendations | recommendation, recommendations, recs, suggest, discover | Personalized recommendations and discovery |
| /calendar | Release Calendar | calendar, schedule, airing, today, releases | Anime and series release schedule |
| /anime-calendar | Anime Calendar | anime-calendar, anime-schedule, anime-airing | Release schedule filtered to anime |
| /series-calendar | Series Calendar | series-calendar, tv-calendar, series-schedule | Release schedule filtered to series |
| /random | Random Picks | random, roulette, spin, pick-for-me | Random recommendation tray without autoplay |
| /surprise | Surprise Me | surprise, surprise-me, recommend-me | Surprise pick without autoplay |
| /settings | Settings | settings, config, prefs | Open settings (relay, playback, shell, and more) |
| /providers | Providers | providers, provider-settings, default-provider | Switch the session provider or set defaults and priority |
| /presence | Discord Presence | presence, discord, rpc, rich-presence | Open settings for Discord Rich Presence setup and status |
| /analytics | Analytics | analytics, telemetry | Anonymous usage ping — status, payload, and consent |
| /analytics-show | Analytics payload | analytics show, analytics-show, telemetry show, telemetry-show | Print the exact JSON that would be sent |
| /notifications | Notifications | notifications, inbox, alerts | Review actionable app notices and recoverable queues |
| /toggle-mode | Toggle Mode | mode, toggle-mode | Cycle catalog mode: series, anime, then YouTube |
| /series-mode | Series Mode | series-mode, series, tv-mode | Switch into series and movies mode |
| /anime-mode | Anime Mode | anime-mode, anime | Switch into anime mode |
| /youtube-mode | YouTube Mode | youtube-mode, youtube, yt | Switch into YouTube mode |
| /quit | Quit | quit, exit, q | Exit Kunai |
| /provider | Providers | provider, switch-provider | Open the providers hub (or tracks provider section while playing) |
| /continue | Continue Watching | continue, c | Open unfinished and recent watch progress |
| /history | History | history, resume, recent | Open watch history |
| /details | Details | details, detail, overview, info | Open the expanded title overview |
| /diagnostics | Diagnostics | diagnostics, logs, debug | Open diagnostics |
| /docs | Docs | docs, documentation, guide, manual | Open Kunai documentation |
| /help | Help | help, shortcuts, ? | Show shortcuts and command help |
| /menu | Title Control Menu | menu, title-control, title-menu | Open the unified title control menu |
| /about | About | about, version | Show version and capability information |
| /update | Update | update, upgrade, check-update, version-check | Check for a new Kunai version and show safe update guidance |
| /image-pane | Image Pane | image, preview, poster | Toggle the image and details companion pane |
| /toggle-autoplay | Pause Autoplay | autoplay, pause-autoplay, resume-autoplay | Temporarily pause or resume autoplay for this playback chain |
| /toggle-autoskip | Pause Autoskip | autoskip, skip, pause-autoskip, resume-autoskip | Temporarily pause or resume auto-skip for this session |
| /stop-after-current | Stop After Current | stop-after, stop-after-current, one-more, finish-episode | Stop after current episode instead of continuing |
| /replay | Replay | replay, restart | Restart the current item from the beginning without refreshing the source |
| /recover | Recover Playback | recover, fix, repair, retry-playback | Refresh the current stream and resume this episode after a playback issue |
| /recompute | Recompute Sources | recompute, refresh-sources, force-refresh, bypass-cache, ignore-cache, all-sources, all-servers, probe-sources | Re-resolve on the current provider only: bypass stream cache and provider memory, then probe all VidKing sources |
| /fallback | Fallback Provider | fallback, try-next-provider, next-provider, f | Stop waiting on the current provider and try the next compatible provider |
| /play-local | Play Downloaded Copy | play-local, local, offline-play, play-offline | Switch the current episode to the verified offline download |
| /watch-online | Watch Online | watch-online, online, stream-online | Switch the current episode back to online provider streaming |
| /source | Source / Servers | source, sources, mirror, server, servers, tracks | Open the tracks panel at the source / servers section |
| /quality | Quality | quality, qualities, variant | Open the tracks panel at the quality section |
| /audio | Audio | audio, dub, language | Open the tracks panel at the audio section |
| /subtitle | Subtitles | subtitle, subtitles, subs, captions, cc | Open the tracks panel at the subtitles section |
| /memory | Memory | memory, mem | Temporarily show runtime memory usage |
| /mark-anime | Mark as Anime | mark-anime, set-anime, is-anime | Reclassify the current title as anime in your history (fixes a wrong label) |
| /mark-series | Mark as Series | mark-series, set-series, not-anime | Reclassify the current title as series in your history (fixes a wrong label) |
| /share | Share This | share, share-link, share-code | Copy a browser-safe HTTPS share link for the current title |
| /share-qr | Share This as QR | share --qr, share-qr, qr | Show a scannable HTTPS share QR and copy the full link |
| /bookmark | Bookmark Current | bookmark, bookmarks-add, save-current, watchlist-add | Save or unsave the current title in your watchlist |
| /follow | Follow Releases | follow, track, track-releases | Track future releases and notices for the current title |
| /unfollow | Unfollow Releases | unfollow, untrack, stop-following | Stop explicit release tracking without muting the title |
| /mute | Mute Releases | mute, mute-title, mute-releases, hide-releases | Stop release notices for the current title |
| /mark-watched | Mark Watched | mark-watched, watched, complete, finish | Mark the current movie or episode as fully watched |
| /mark-unwatched | Mark Unwatched | mark-unwatched, unwatched, unwatch | Clear the watched flag while keeping resume position |
| /mark-season-watched | Mark Season Watched | mark-season-watched, season-watched, mark-season | Mark every episode in the current season up to the current episode as watched |
| /mark-up-to-episode | Mark Up To Episode | mark-up-to-episode, mark-through, mark-through-episode | Pick an episode and mark the whole season through that episode as watched |
| /watch | Watch a Shared Code | watch, open-share, open-link | Open a kunai:// share link from your clipboard |
| /pick-episode | Pick Episode | episode, pick-episode, episodes | Open the episode picker |
| /next | Next Episode | next, n | Advance to the next episode |
| /previous | Previous Episode | previous, prev, p | Go to the previous episode |
| /next-season | Next Season | season, next-season | Jump to the next season |
| /clear-cache | Clear Cache | clear-cache, purge-cache, flush-cache | Clear stream URL cache (and optionally provider failure memory) |
| /reset-provider-health | Reset Provider Health | reset-provider-health, clear-provider-memory, forget-provider-failures | Forget provider failures so auto-fallback can retry down providers |
| /clear-history | Clear History | clear-history, reset-history, wipe-history | Remove all watch history and progress |
| /export-diagnostics | Export Diagnostics | export-diagnostics, export-logs, diag-export | Export recent diagnostics to a redacted JSON file |
| /report-issue | Report Issue | report-issue, issue, bug-report | Open the GitHub issue page with diagnostics guidance |
| /watchlist | Watchlist | watchlist, wl, watch-list, watch-later, bookmarks | View and manage the built-in Watchlist |
| /favorites | Favorites | fav, favs, favorites | View your favorite titles |
| /playlists | Playlists | playlists, playlist, pl, lists | View and manage durable playlists |
| /up-next | Up Next | up-next, upnext, queue, queue-playlist | View and manage the current playback order |
| /playlist-add | Add to Up Next | playlist-add, pl-add, add-to-up-next, queue-add, add-to-queue | Add the current title to Up Next |
| /queue-season | Queue Rest of Season | queue-season, season-queue, queue-rest-season | Queue remaining episodes in the current season |
| /stats | Stats | stats, statistics, watch-stats | Watch stats, streak, and top shows |
| /sync | Sync | sync, sync-settings, integrations | Experimental AniList progress and tracker list sync |
| /sync-connect-anilist | Connect AniList | connect-anilist, anilist-connect, anilist | Link your AniList account to sync watch progress |
| /sync-connect-tmdb | Connect TMDB | connect-tmdb, tmdb-connect, tmdb | Link your TMDB account to sync watchlist and favourites |
| /sync-disconnect | Disconnect Sync | sync-disconnect, disconnect-sync, unlink-sync | Remove linked sync accounts |
82 shell commands registered in the CLI.
Stable Hotkeys
| Context | Keys | Action |
|---|---|---|
| Global | / | Open command palette |
| Global | ? | Show this help |
| Global | Esc | Back · close panel · clear filter |
| While browsing | Tab / ⇧Tab | Cycle catalog mode forward (⇧Tab back): series / anime / YouTube |
| While browsing | Enter | Open the highlighted title |
| In the player | ⇧F | Switch to another provider (fallback) |
| In the player | m | Open title control menu |
| In the player | n / N | Next episode |
| In the player | p / P | Previous episode |
| Global | ⌃C | Quit |
| While browsing | i | Show title details |
| While browsing | ⌃O | Show title details |
| While browsing | ⌃D / d | Download the highlighted title |
| While browsing | q | Add the highlighted title to Up Next |
| While browsing | w | Add the highlighted title to Watchlist |
| While browsing | f | Favourite or unfavourite the highlighted title |
| While browsing | ⇧W | Follow releases for the highlighted title |
| While browsing | ⌃T | Reload trending results |
| While browsing | ⌃F | Narrow loaded results |
| While browsing | m | Open starting-point menu for the highlighted title (same as Enter) |
| While browsing | ⇧Q | Open Up Next |
| In the player | q | Stop playback |
| In the player | o | Choose source |
| In the player | e | Choose episode |
| In the player | l | Favourite or unfavourite the current title |
| In the player | b | Skip intro / recap / credits (when offered) |
| In the player | s | Reload subtitles |
| In the player | ⇧S | Return to search |
| In the player | a | Toggle autoplay |
| In the player | u | Toggle autoskip |
| In the player | x | Stop after current episode |
| In the player | d | Open diagnostics |
| In the player | k / K | Choose quality (in the terminal; v in mpv) |
| In the player | ⌃R | Refresh the stream (same episode) |
| In the player | Alt+R | Resume to your saved position |
| After playback | n | Continue / next |
| After playback | r | Replay this episode |
| After playback | s | Search for something else |
| After playback | ⇧F | Switch to another provider (fallback) |
| After playback | o | Choose source |
| After playback | e | Choose episode |
| After playback | m | Open title control menu |
| Stats | Tab / ⇧Tab | Next / previous stats tab (Overview · Titles · Insights) |
| Stats | r / ⇧R | Cycle range forward / back (All time · Last 7d · Last 30d) |
| Stats | ←→ | Cycle media type forward / back (All · Anime · Series · Movies · YouTube) |
45 stable shortcuts from the keybinding registry. Press ? in the shell for the full live help overlay.
Locked chords worth calling out:
Tabcycles browse catalog mode (series / anime / YouTube).- Provider fallback during playback is
⇧F(Shift+F). Barefis not bound. - During playback, live
mopens the title control menu. The memory panel is/memory, not a competing bare-key binding.
Reporting Problems
Use /diagnostics first, then /export-diagnostics when you need a redacted
support bundle. Use /report-issue to open the GitHub issue page.
Opening Docs
Use /docs to open documentation. With KUNAI_DOCS_URL unset it opens the GitHub docs/ tree, not the published site. Set KUNAI_DOCS_URL to point at a local, preview, or production docs origin.
For the full generated command list, see Feature tour. Launch flags are documented in CLI Reference.
Edit on GitHub
Report an issue or give feedback
Last updated on
Feature Tour
Every Kunai capability in one place: what is shipped, what is experimental, and what is explicitly out of scope, with the shell commands that reach each one.
Media Selection
How Kunai picks a provider, source, and stream, then chooses quality, audio track, and subtitles, plus how to override each decision from the shell.