Skip to content
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: jdx/usage
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: v2.16.2
Choose a base ref
...
head repository: jdx/usage
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: v2.17.0
Choose a head ref
  • 10 commits
  • 46 files changed
  • 7 contributors

Commits on Feb 13, 2026

  1. chore: mise up (#492)

    muzimuzhi authored Feb 13, 2026
    Configuration menu
    Copy the full SHA
    cacee26 View commit details
    Browse the repository at this point in the history
  2. chore(deps): update actions/checkout digest to de0fac2 (#494)

    This PR contains the following updates:
    
    | Package | Type | Update | Change |
    |---|---|---|---|
    | [actions/checkout](https://redirect.github.com/actions/checkout)
    ([changelog](https://redirect.github.com/actions/checkout/compare/8e8c483db84b4bee98b60c0593521ed34d9990e8..de0fac2e4500dabe0009e67214ff5f5447ce83dd))
    | action | digest | `8e8c483` → `de0fac2` |
    
    ---
    
    ### Configuration
    
    📅 **Schedule**: Branch creation - "before 4am on friday" in timezone
    America/Chicago, Automerge - At any time (no schedule defined).
    
    🚦 **Automerge**: Enabled.
    
    ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
    rebase/retry checkbox.
    
    🔕 **Ignore**: Close this PR and you won't be reminded about this update
    again.
    
    ---
    
    - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
    this box
    
    ---
    
    This PR was generated by [Mend Renovate](https://mend.io/renovate/).
    View the [repository job
    log](https://developer.mend.io/github/jdx/usage).
    
    <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My44LjUiLCJ1cGRhdGVkSW5WZXIiOiI0My44LjUiLCJ0YXJnZXRCcmFuY2giOiJtYWluIiwibGFiZWxzIjpbXX0=-->
    
    Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
    renovate[bot] authored Feb 13, 2026
    Configuration menu
    Copy the full SHA
    6ac1109 View commit details
    Browse the repository at this point in the history
  3. chore(deps): update taiki-e/upload-rust-binary-action digest to f3912…

    …89 (#495)
    
    This PR contains the following updates:
    
    | Package | Type | Update | Change |
    |---|---|---|---|
    |
    [taiki-e/upload-rust-binary-action](https://redirect.github.com/taiki-e/upload-rust-binary-action)
    ([changelog](https://redirect.github.com/taiki-e/upload-rust-binary-action/compare/3962470d6e7f1993108411bc3f75a135ec67fc8c..f391289bcff6a7f36b6301c0a74199657bbb4561))
    | action | digest | `3962470` → `f391289` |
    
    ---
    
    ### Configuration
    
    📅 **Schedule**: Branch creation - "before 4am on friday" in timezone
    America/Chicago, Automerge - At any time (no schedule defined).
    
    🚦 **Automerge**: Enabled.
    
    ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
    rebase/retry checkbox.
    
    🔕 **Ignore**: Close this PR and you won't be reminded about this update
    again.
    
    ---
    
    - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
    this box
    
    ---
    
    This PR was generated by [Mend Renovate](https://mend.io/renovate/).
    View the [repository job
    log](https://developer.mend.io/github/jdx/usage).
    
    <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My44LjUiLCJ1cGRhdGVkSW5WZXIiOiI0My44LjUiLCJ0YXJnZXRCcmFuY2giOiJtYWluIiwibGFiZWxzIjpbXX0=-->
    
    Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
    renovate[bot] authored Feb 13, 2026
    Configuration menu
    Copy the full SHA
    49ca681 View commit details
    Browse the repository at this point in the history

Commits on Feb 15, 2026

  1. fix(docs): align homepage feature button with integrations page (#496)

    ## Summary
    
    - Renamed the "Any Language" homepage feature button to "Integrations"
    with an accurate tooltip description
    - The previous tooltip described language-agnostic scripting (which
    matches `/cli/scripts`) but linked to `/spec/integrations` (framework
    integrations like clap)
    - Now the button label, tooltip, and link target are all consistent
    
    Fixes #493
    
    🤖 Generated with [Claude Code](https://claude.com/claude-code)
    
    <!-- CURSOR_SUMMARY -->
    ---
    
    > [!NOTE]
    > **Low Risk**
    > Docs-only copy change with no functional logic changes; risk is
    limited to potential wording/link expectation mismatches.
    > 
    > **Overview**
    > Updates the docs homepage `UsageHero.vue` feature tile linking to
    `/spec/integrations` by renaming it from **“Any Language”** to
    **“Integrations”** and rewriting the tooltip to describe framework
    integrations (e.g., generating specs from `clap`) instead of
    language-agnostic scripting.
    > 
    > <sup>Written by [Cursor
    Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
    afa5610. This will update automatically
    on new commits. Configure
    [here](https://cursor.com/dashboard?tab=bugbot).</sup>
    <!-- /CURSOR_SUMMARY -->
    
    Co-authored-by: Claude Opus 4.6 <[email protected]>
    jdx and claude authored Feb 15, 2026
    Configuration menu
    Copy the full SHA
    f973fd8 View commit details
    Browse the repository at this point in the history
  2. docs: add integrations directory with framework tracker (#497)

    ## Summary
    
    - Adds `integrations/README.md` with a prioritized checklist of 30+ CLI
    frameworks across 16+ languages
    - Organized into high/medium/lower priority tiers based on ecosystem
    popularity (GitHub stars)
    - Includes a "How Integrations Work" section explaining the spec
    generation approach
    - References `clap_usage` as the existing reference implementation
    
    ## Highlights
    
    **High priority** (>15k stars): Cobra (Go), Commander.js (Node),
    urfave/cli (Go), Typer/Click (Python), argparse (Python)
    
    **Medium priority** (4-12k stars): yargs, Spectre.Console (.NET),
    Symfony Console (PHP), oclif, picocli (Java), Thor (Ruby),
    swift-argument-parser, and more
    
    **Lower priority** (<3k stars): Kong, Clikt, argh, zig-clap,
    optparse-applicative, and others
    
    ## Test plan
    
    - [x] No code changes, docs only
    
    🤖 Generated with [Claude Code](https://claude.com/claude-code)
    
    <!-- CURSOR_SUMMARY -->
    ---
    
    > [!NOTE]
    > **Low Risk**
    > Docs-only change that adds planning/overview material without
    modifying runtime code paths.
    > 
    > **Overview**
    > Adds a new `integrations/README.md` that tracks planned/implemented
    CLI-framework integrations via a prioritized checklist and links to the
    existing `clap_usage` reference implementation.
    > 
    > Documents the intended integration flow: extracting framework CLI
    definitions into the KDL usage spec to drive completions, docs, man
    pages, and `--help` output.
    > 
    > <sup>Written by [Cursor
    Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
    6859f09. This will update automatically
    on new commits. Configure
    [here](https://cursor.com/dashboard?tab=bugbot).</sup>
    <!-- /CURSOR_SUMMARY -->
    
    Co-authored-by: Claude Opus 4.6 <[email protected]>
    jdx and claude authored Feb 15, 2026
    Configuration menu
    Copy the full SHA
    80ebf42 View commit details
    Browse the repository at this point in the history
  3. feat: add Cobra (Go) integration for generating usage specs (#498)

    ## Summary
    
    - Adds a Go package at `integrations/cobra/` that converts Cobra command
    trees into usage specs in KDL format
    - Enables shell completions, markdown docs, and man pages for any
    Cobra-based CLI
    - Includes public API (`Generate`, `GenerateJSON`, `GenerateToFile`,
    `GenerateJSONToFile`), 15 tests, an example CLI, and documentation
    
    ## Test plan
    
    - [x] `cd integrations/cobra && go test ./...` — all 15 tests pass
    - [x] `cd integrations/cobra/example && go run . --usage-spec` — prints
    valid KDL
    - [x] KDL output parses correctly with `usage generate md` to produce
    markdown docs
    - [x] All pre-commit hooks pass (Rust tests, clippy, fmt, prettier)
    
    🤖 Generated with [Claude Code](https://claude.com/claude-code)
    
    <!-- CURSOR_SUMMARY -->
    ---
    
    > [!NOTE]
    > **Medium Risk**
    > Introduces a new standalone integration module with non-trivial
    conversion/serialization logic; risk is mainly correctness/compatibility
    of generated specs rather than impact on existing runtime behavior.
    > 
    > **Overview**
    > Adds a new Go integration, `integrations/cobra` (`cobra_usage`), that
    converts `spf13/cobra` command trees into usage specs and renders them
    as **KDL** (for `usage generate`) or as **JSON** matching the usage-lib
    schema.
    > 
    > The converter maps Cobra commands/flags/args (including aliases,
    hidden/deprecated, persistent vs local flags, `ValidArgs` choices,
    required/count/bool/default handling, and skipping Cobra’s built-in
    help/completion commands and `--help`/`--version` flags), and includes
    an example CLI plus comprehensive tests and integration documentation.
    Updates `integrations/README.md` to mark Cobra as implemented.
    > 
    > <sup>Written by [Cursor
    Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
    0ceaea1. This will update automatically
    on new commits. Configure
    [here](https://cursor.com/dashboard?tab=bugbot).</sup>
    <!-- /CURSOR_SUMMARY -->
    
    ---------
    
    Co-authored-by: Claude Opus 4.6 <[email protected]>
    jdx and claude authored Feb 15, 2026
    Configuration menu
    Copy the full SHA
    fbc0a3b View commit details
    Browse the repository at this point in the history

Commits on Feb 16, 2026

  1. chore(deps): lock file maintenance (#500)

    This PR contains the following updates:
    
    | Update | Change |
    |---|---|
    | lockFileMaintenance | All locks refreshed |
    
    🔧 This Pull Request updates lock files to use the latest dependency
    versions.
    
    ---
    
    ### Configuration
    
    📅 **Schedule**: Branch creation - "before 4am on monday" in timezone
    America/Chicago, Automerge - At any time (no schedule defined).
    
    🚦 **Automerge**: Enabled.
    
    ♻ **Rebasing**: Whenever PR is behind base branch, or you tick the
    rebase/retry checkbox.
    
    👻 **Immortal**: This PR will be recreated if closed unmerged. Get
    [config
    help](https://redirect.github.com/renovatebot/renovate/discussions) if
    that's undesired.
    
    ---
    
    - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
    this box
    
    ---
    
    This PR was generated by [Mend Renovate](https://mend.io/renovate/).
    View the [repository job
    log](https://developer.mend.io/github/jdx/usage).
    
    <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0My44LjUiLCJ1cGRhdGVkSW5WZXIiOiI0My44LjUiLCJ0YXJnZXRCcmFuY2giOiJtYWluIiwibGFiZWxzIjpbXX0=-->
    
    Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
    renovate[bot] authored Feb 16, 2026
    Configuration menu
    Copy the full SHA
    4ff941b View commit details
    Browse the repository at this point in the history
  2. feat: Add support for nushell (#485)

    Gave a shot at adding support for `nushell`.
    
    ---------
    
    Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
    abusch and autofix-ci[bot] authored Feb 16, 2026
    Configuration menu
    Copy the full SHA
    25ae634 View commit details
    Browse the repository at this point in the history
  3. docs: add integrations directory with framework tracker (#499)

    ## Summary
    - Split integrations docs into index page (`/spec/integrations`) and
    per-framework subpages (`/spec/integrations/cobra`,
    `/spec/integrations/clap`)
    - Add framework tracker tables (planned integrations by priority) to the
    index page
    - Add collapsed Integrations section to sidebar with Cobra and clap
    child items
    
    ## Test plan
    - [ ] Verify docs build locally with `npm run docs:dev`
    - [ ] Check sidebar shows collapsed Integrations section
    - [ ] Verify links between index and subpages work
    
    🤖 Generated with [Claude Code](https://claude.com/claude-code)
    
    ---------
    
    Co-authored-by: Claude Opus 4.6 <[email protected]>
    jdx and claude authored Feb 16, 2026
    Configuration menu
    Copy the full SHA
    dc31060 View commit details
    Browse the repository at this point in the history
  4. chore: release v2.17.0 (#491)

    ### 🚀 Features
    
    - add Cobra (Go) integration for generating usage specs by
    [@jdx](https://github.com/jdx) in
    [#498](#498)
    - Add support for nushell by [@abusch](https://github.com/abusch) in
    [#485](#485)
    
    ### 🐛 Bug Fixes
    
    - **(docs)** align homepage feature button with integrations page by
    [@jdx](https://github.com/jdx) in
    [#496](#496)
    
    ### 📚 Documentation
    
    - add integrations directory with framework tracker by
    [@jdx](https://github.com/jdx) in
    [#497](#497)
    - add integrations directory with framework tracker by
    [@jdx](https://github.com/jdx) in
    [#499](#499)
    
    ### 🔍 Other Changes
    
    - mise up by [@muzimuzhi](https://github.com/muzimuzhi) in
    [#492](#492)
    
    ### 📦️ Dependency Updates
    
    - update actions/checkout digest to de0fac2 by
    [@renovate[bot]](https://github.com/renovate[bot]) in
    [#494](#494)
    - update taiki-e/upload-rust-binary-action digest to f391289 by
    [@renovate[bot]](https://github.com/renovate[bot]) in
    [#495](#495)
    - lock file maintenance by
    [@renovate[bot]](https://github.com/renovate[bot]) in
    [#500](#500)
    
    ### New Contributors
    
    - @abusch made their first contribution in
    [#485](#485)
    mise-en-dev authored Feb 16, 2026
    Configuration menu
    Copy the full SHA
    6b1774e View commit details
    Browse the repository at this point in the history
Loading