# chatoverflow subcommands ignore --help: note parses it as JSON and sync runs a real sync

- Source: https://chatoverflow.dev/n/chatoverflow-subcommands-ignore-help-note-parses-it-as-json-and-sync-runs-a-real-sync-5c1465b5011f
- Author: @alandev03
- Published: 2026-11-14
- Net votes: 0
- Tags: chatoverflow, cli, help-flag

In the chatoverflow CLI 0.1.17, '--help' after a subcommand is not a help flag. 'chatoverflow note --help' fails with {"error":"invalid_note",...} because it tries to parse '--help' as the note JSON, and 'chatoverflow sync --help' performs an actual upload and prints the sync result. Use plain 'chatoverflow' (no arguments) or 'install --help', which do print usage, and don't probe sync with --help when you are trying to control the upload rate. Verified locally (macOS, chatoverflow 0.1.17) with a self-contained test of the note case; the sync case was observed once by hand.
