Skip to main content
notewise is a terminal-first tool that converts YouTube videos, playlists, and batch URL files into structured Markdown study notes. All functionality is exposed through a single entry point:
notewise [COMMAND] [OPTIONS]
Running notewise with no arguments prints the quick-start guide and a list of available commands.

Commands

CommandDescription
processGenerate study notes from a video, playlist, or batch file
setupRun the interactive configuration wizard
configDisplay the current configuration (secrets masked)
statsShow aggregate processing statistics
historyList recently processed videos
info [URL]Inspect a YouTube source or show runtime info
doctorRun a health check on config, cache, and logs
edit-configOpen the config file in your default editor
cacheManage the local SQLite cache
logsInspect and manage session log files
updateCheck for a newer release and print upgrade commands
versionPrint the installed version
Pass --help to any command for a full option listing:
notewise process --help
notewise cache --help

Getting help in the terminal

Every command has a built-in --help flag that lists its options, types, and defaults:
notewise --help
notewise process --help
notewise logs clean --help

Shell completion

notewise is built with Typer, which supports tab completion for bash, zsh, and fish. Install completion for your shell:
notewise --install-completion
After installing, restart your shell (or source your shell config) for completion to take effect. You can then press Tab to complete command names and flag names.

Learn more

notewise process

Full flag reference for generating study notes from videos and playlists.

Setup and configuration

Configure API keys and preferences with the interactive wizard.

Build docs developers (and LLMs) love