> ## Documentation Index
> Fetch the complete documentation index at: https://notewise.click/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI commands

> Reference for the NoteWise command surface from the Typer CLI source.

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

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
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

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
notewise setup
notewise setup --show
notewise setup --force
notewise auth login chatgpt
notewise auth login github_copilot
notewise auth login codex
```

## Update command

```bash theme={"theme":{"light":"github-light","dark":"tokyo-night"}}
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`.