[mwbrooks]

Changelog

New --hide-pinned flag on slack docs search leaves out the pages docs.slack.dev pins to the top of some searches.

Summary

This pull request adds a --hide-pinned flag to slack docs search, so coding agents that already have the Slack MCP and Skills Plugin can leave out the plugin page that docs.slack.dev is starting to pin to the top of searches about coding agents.

$ slack docs search "mcp" --category=guides --hide-pinned

• docs.slack.dev is adding a pin to its search API (slack/docs-slack-dev#272): searches that mention Claude, Cursor, Codex, MCP, or coding agents put the plugin page first. The flag sends the API's pin=false.
• With no flag, the pin stays. A developer or an agent that has not heard of the plugin should still find it.
• The slack-docs skill already sends pin=false when it calls the API directly (fix: leave the docs search pin out of slack-docs searches slack-skills-plugin#215). It will pass --hide-pinned once it starts using slack docs search.

Testing

• Run slack docs search "mcp" --category=guides --hide-pinned --output=json and confirm it returns results. The API ignores pin=false until the docs.slack.dev change deploys.
• Run slack docs search --help and confirm the flag and its example.

Notes

• Open question: --hide-pinned or --hide-pin? --hide-pinned names the results you see, so the CLI doesn't depend on the API's pin parameter name. --hide-pin matches that parameter. I lean toward --hide-pinned, and Codex's review agreed, but I'd like your take.
• It applies to text and JSON output. --output=browser opens the site's search page, which has its own pin behaviour.

Requirements

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.98%. Comparing base (024c7de) to head (4d26ec5).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #772      +/-   ##
==========================================
+ Coverage   78.95%   78.98%   +0.02%     
==========================================
  Files         241      241              
  Lines       18365    18371       +6     
==========================================
+ Hits        14501    14511      +10     
+ Misses       3864     3860       -4     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[haleychaas]

Is there a way to tell if the user already has the plugin? I'm thinking that we'd still want it to come in at the top of the search for users who don't have it. If not, that's ok!

[zimeg]

📚 @mwbrooks LGTM! I'd keep --hide-pinned too, since it reads alongside the --hide-triggers flag on run and deploy and doesn't tie the CLI to the API's parameter name.

[mwbrooks]

@haleychaas The CLI can't tell, so it keeps the pin by default. Only the slack-docs skill passes --hide-pinned, and an agent running that skill already has the plugin. Anyone without it still sees the plugin page first. 🙇

[mwbrooks]

Thanks @zimeg for the review and @haleychaas for checking that people without the plugin still see it first! 🙇