CLI commands - NoteWise

Run notewise COMMAND --help for command-specific flags. The command set is defined in src/notewise/cli/app.py.

Main commands

Command	Purpose
`notewise process URL`	Generate notes from one video, playlist, or batch file.
`notewise setup`	Run the interactive config wizard.
`notewise config`	Print masked effective config.
`notewise config-path`	Print the active config path.
`notewise edit-config`	Open the config file in an editor.
`notewise auth login PROVIDER`	Login to OAuth providers.
`notewise info`	Show runtime config and state paths.
`notewise info URL`	Inspect YouTube metadata and cache status without generation.
`notewise doctor`	Check config, provider readiness, output, cache, and logs.
`notewise stats`	Show processing totals and model breakdown.
`notewise history`	Show recent processed videos.
`notewise cache`	Inspect or maintain the SQLite cache.
`notewise logs`	Inspect or clean session logs.
`notewise update`	Check whether a newer release is available.
`notewise version`	Show the installed version.

Process command

notewise process "https://youtu.be/VIDEO_ID" --format md,docx --quiz

Important flags: --model, --output, --format, --language, --target-language, --temperature, --max-tokens, --throttle, --force, --no-ui, --verbose, --quiz, --export-transcript, --timestamps, --chapter-directory-output, and --cookie-file.

Setup and auth

notewise setup
notewise setup --show
notewise setup --force
notewise auth login chatgpt
notewise auth login github_copilot
notewise auth login codex

Update command

notewise update

The update check compares the installed version with the latest GitHub release. It detects whether NoteWise is running as a standalone binary or as a Python package and prints the matching upgrade command group. Standalone binaries receive the short release installer command. Python package installs receive package-manager commands for uv tool, pipx, and python -m pip; use the one that matches how you installed NoteWise.

Exit behavior

Successful commands exit with 0. Processing failures exit with 1.

​Main commands

​Process command

​Setup and auth

​Update command

​Exit behavior

Main commands

Process command

Setup and auth

Update command

Exit behavior