Skip to content

feat: make primary args positional across all CLIs#242

Merged
jackwener merged 2 commits intojackwener:mainfrom
platoneko:positional-args
Mar 22, 2026
Merged

feat: make primary args positional across all CLIs#242
jackwener merged 2 commits intojackwener:mainfrom
platoneko:positional-args

Conversation

@platoneko
Copy link
Copy Markdown
Contributor

Convert primary arguments from named options (--arg) to positional arguments for a more natural CLI experience.

Changes

Code (26 commands)

  • Add positional: true to primary args across 22 TS files and 4 YAML files
  • Affected sites: antigravity, bilibili, boss, chaoxing, coupang, grok, hf, instagram, jike, jimeng, linkedin, linux-do, tiktok, twitter, xiaohongshu, youtube

Docs

  • Add Arg Design Convention section to CONTRIBUTING.md
  • Update download examples in README.md and README.zh-CN.md to use positional syntax
  • Add earnings-date to xueqiu command list

Usage examples

opencli twitter followers elonmusk   # was: --user elonmusk
opencli bilibili download BV1xxx     # was: --bvid BV1xxx
opencli grok ask 'hello'             # was: --prompt 'hello'

platoneko and others added 2 commits March 22, 2026 16:53
Convert primary arguments from named options (--arg) to positional
arguments for a more natural CLI experience.

Affected sites: antigravity, bilibili, boss, chaoxing, coupang, grok,
hf, instagram, jike, jimeng, linkedin, linux-do, tiktok, twitter,
xiaohongshu, youtube

Also adds Arg Design Convention to CONTRIBUTING.md and earnings-date
to xueqiu command list in READMEs.

Usage examples:
  opencli xueqiu search '茅台'       (was: --query '茅台')
  opencli twitter followers elonmusk  (was: --user elonmusk)
  opencli bilibili download BV1xxx    (was: --bvid BV1xxx)
@jackwener
Copy link
Copy Markdown
Owner

Deep review completed. I pushed a follow-up commit to keep filter/config args as named options instead of forcing them positional, and fixed the single-tweet download docs example. Validation passed with npm run typecheck, npm run build, and targeted help checks for the affected commands.

@jackwener jackwener merged commit 9696db9 into jackwener:main Mar 22, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants