Skip to main content
notewise [COMMAND] [OPTIONS] [ARGS]
Running notewise without any command prints a summary. Running notewise COMMAND --help prints full help for that command.

Command map

process

Generate study notes from a video, playlist, or batch file.

setup

Run the interactive wizard to create ~/.notewise/config.env.

config

Display the current resolved configuration (API keys masked).

config-path

Print the path to the active config file.

edit-config

Open config.env in your $EDITOR.

stats

Show aggregate processing statistics from the cache.

history

List recently processed videos.

info

Show runtime info, or inspect a source without processing it.

doctor

Run a non-destructive health check on config, cache, and logs.

cache

Inspect and manage the local SQLite cache.

logs

Inspect and manage session log files.

update

Check for a newer release and print upgrade commands.

version

Print the installed version.

Typical workflows

1

Initialize config

notewise setup
2

Verify config

notewise config
notewise config-path
3

First run

notewise process "https://youtube.com/watch?v=VIDEO_ID"

Global behavior

BehaviorDetails
Config file~/.notewise/config.env loaded automatically. Override directory with NOTEWISE_HOME.
LoggingStructured JSON log written to ~/.notewise/logs/ for every process run. API keys are redacted.
Exit codes0 on success, 1 on any failure.

Shell completion

notewise --install-completion bash