docs(cli): clarify --output json behavior when no extraction strategy is provided #2334

Activity

1. ntohidi

   added

   🩺 Needs TriageNeeds attention of maintainersNeeds attention of maintainers

   on Oct 12, 2026
2. ege-arhan

   added a commit that references this issue on Oct 12, 2026

   docs(cli): clarify that --output json requires an extraction strategy…

   ...

   This issue will close once commit 36cea05 is merged into the 'main' branch.

   36cea05
3. SohamKukreti

   added

   🐞 BugSomething isn't workingSomething isn't working

   ⚙️ In-progressIssues, Features requests that are in ProgressIssues, Features requests that are in Progress

   and removed

   🩺 Needs TriageNeeds attention of maintainersNeeds attention of maintainers

   on Oct 12, 2026
4. SohamKukreti commented on Oct 12, 2026

   

   SohamKukreti

   on Oct 12, 2026

   Collaborator

   More actions

   Thanks for reporting this @ege-arhan

   There are 3 PRs targeting this issue, One targets fixes the help test, one fixes the documentation and one fixes the code:

   • Fail early when -o json has no extraction strategy #2362 (code fix): -o json without an extraction strategy (-j or -e) now stops before the crawl starts, with a clear error:

     Error: -o json needs an extraction strategy (-j or -e). Use -o all for the full crawl result.
     

     It also removes the duplicate JSON print, fixes the broken -o json example in crwl examples, and removes the json choice from the profile crawl menu.
   • docs(cli): clarify that --output json requires extraction strategy #2335 (help text): clarifies the --output help in the CLI.
   • docs(cli): clarify --output json behavior and examples #2348 (docs): updates the CLI docs and replaces the misleading -o json examples.

   All three apply cleanly and can be merged together once the review on the 2 PRs have been addressed.

   👍React with 👍1Reacted by Nasrin