TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Track changes to CLI tools by recording their help output

10 pointsby appwizabout 3 years ago

3 comments

simonwabout 3 years ago
My AWS tracker has caught a ton of a activity - they really do ship new feature in that tool every day of the week: <a href="https:&#x2F;&#x2F;github.com&#x2F;simonw&#x2F;help-scraper&#x2F;commits&#x2F;main&#x2F;aws" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;simonw&#x2F;help-scraper&#x2F;commits&#x2F;main&#x2F;aws</a><p>My scraper against the GitHub GraphQL schema catches some interesting details too: <a href="https:&#x2F;&#x2F;github.com&#x2F;simonw&#x2F;help-scraper&#x2F;commits&#x2F;main&#x2F;github" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;simonw&#x2F;help-scraper&#x2F;commits&#x2F;main&#x2F;github</a>
评论 #30667126 未加载
jitlabout 3 years ago
Interesting idea, it’s like running an integration test for someone else’s tool.<p>I did something a bit like this for a few internal tools I built at Airbnb. I built a docs system that indexed all the markdown files in every repo or project’s .infra&#x2F;docs folder into a central documentation browser website.<p>Then in each tool project, we had a CI job that would loop over all the commands and spit the —-help output in Markdown format into that folder. That way when someone added commands or changed a command’s args or help text, the searchable docs were automatically updated.<p>We didn’t use this to generate a change log to show to users per se, but it did mean that you could run `git log .infra&#x2F;docs` to see a log of every change to the tool’s interface.
bhupeshabout 3 years ago
that&#x27;s cool, but shouldn&#x27;t the best way to solve this would be to ship the changelog with the CLI itself? Something like `cli --changelog`? I mean I don&#x27;t understand why its not a general practice with CLI authors
评论 #30660636 未加载