Skip to content

chore: add macOS universal-ctags v6.1.0 install script#1023

Merged
brendan-kellam merged 1 commit intomainfrom
bkellam/install-ctags-macos
Mar 21, 2026
Merged

chore: add macOS universal-ctags v6.1.0 install script#1023
brendan-kellam merged 1 commit intomainfrom
bkellam/install-ctags-macos

Conversation

@brendan-kellam
Copy link
Contributor

@brendan-kellam brendan-kellam commented Mar 21, 2026

Summary

  • Adds install-ctags-macos.sh to build and install universal-ctags v6.1.0 from source on macOS
  • Updates CONTRIBUTING.md to replace the brew install universal-ctags instruction with the new script for macOS, and adds build-from-source instructions for Linux and other platforms

Why v6.1.0?

universal-ctags 6.2.1 (the current Homebrew version) has a known incompatibility with zoekt: it emits JSON _type: "error" warning messages about the Cargo subparser at startup when Rust is in the language list. The go-ctags library treats any _type: error response as fatal, causing indexing to silently fall back to no symbol extraction. v6.1.0 is the version pinned in vendor/zoekt/install-ctags-alpine.sh and does not have this issue.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation

    • Updated contributor setup instructions with new installation requirements and platform-specific guidance.
  • Chores

    • Added automated installation script for developer environment setup on macOS.

…tributing docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Contributor

@brendan-kellam your pull request is missing a changelog!

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Mar 21, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: fb9b1412-58b8-40a4-8b51-dfcc69ebd60e

📥 Commits

Reviewing files that changed from the base of the PR and between 70484e8 and 0183c73.

📒 Files selected for processing (2)
  • CONTRIBUTING.md
  • install-ctags-macos.sh

Walkthrough

Updates contributor setup documentation to use pinned universal-ctags v6.1.0 instead of generic ctags, adds platform-specific installation instructions in CONTRIBUTING.md, and introduces a macOS installation shell script. Requires setting CTAGS_COMMAND environment variable after installation.

Changes

Cohort / File(s) Summary
Documentation Updates
CONTRIBUTING.md
Updated ctags installation guidance with pinned v6.1.0 requirement, platform-specific steps (macOS script and Linux source-build workflow), and environment variable configuration requirement.
Installation Scripts
install-ctags-macos.sh
New shell script automating universal-ctags v6.1.0 installation on macOS via Homebrew dependencies, source download, build configuration with JSON support, and binary installation to /usr/local/bin.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch bkellam/install-ctags-macos

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@brendan-kellam brendan-kellam merged commit e0d4ff9 into main Mar 21, 2026
7 of 8 checks passed
@brendan-kellam brendan-kellam deleted the bkellam/install-ctags-macos branch March 21, 2026 23:46
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.

1 participant