ctagsymbols

KO | EN

gitlite — search

#python #ai #typescript #llm #golang #deep-learning #linux #macos #nodejs #awesome #pytorch #security #mcp #ios

(★ 8)

CTags workspace symbol provider extension for Visual Studio Code

ctagsymbols Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CTags Workspace Symbol Provider
A zero-config workspace symbol provider using ctags.

## Features
* Search for tags using the standard "Go to Symbol in Workspace" dialog
* Multi-root workspace support
* Cross-platform
* Regenerate tags from within VSCode using the `Regenerate CTags` command
* Automatically regenerate tags on file save (disabled by default)
* (Almost) zero-config

This extension is intended to be a complement to your existing language tooling, or to provide a minimal level of
code navigation support for languages which don't have any native VSCode integrations.
I originally wrote it for use with the [Simple GHC Integration](https://marketplace.visualstudio.com/items?itemName=dramforever.vscode-ghc-simple).

## Setup
ctagsymbols requires a tags file to work. This may be generated using [Exuberant Ctags](http://ctags.sourceforge.net), hasktags (for Haskell), etc.
By default, ctagsymbols looks for tags in `<workspace root>/tags`.

No extended tag information is required, so you can generate your tags file (for most languages)
by simply running `ctags -R .` in the root folder of your workspace.
For your convenience, the `Regenerate CTags` command, accessible from the VSCode command palette,
does exactly this. (This feature requires `ctags` to be installed on your system.)

You can also let this extension regenerate your tags files automatically whenever you save a source file.
This will regenerate the tags file for the workspace in which the saved file resides.

This feature is disabled by default due to performance concerns with huge code bases. It's recommended
that you enable this feature on a per-workspace basis, rather than for all your projects.

## Extension Settings
* `ctagsymbols.tagsFile`: path to the ctags file to read symbols from, relative to the workspace root.
* `ctagsymbols.hideDuplicateTags`: when there are multiple tags with the same name in the same source file, hide all but the first one.
  Changes to this setting take effect the next time the tags file is updated or the extension is reloaded.
* `ctagsymbols.maxNumberOfSymbols`: never display more than this many symbols, regardless of the number of matches.
* `ctagsymbols.minQueryLength`: don't process symbol queries shorter than this. May improve performance for large code bases since it avoids listing every single symbol in the entire project.
* `ctagsymbols.regenerateCommand`: command to use for regenerating tags files when `Regenerate CTags` is invoked.

## Known Issues
* Ignores extended tag information; reports all symbols as constants.
* Only supports one tags file per workspace root.
* Ignores concatenated Ex commands in tag files.
* Treats regex Ex commands as plain string matches.
* Does not support regenerating tags on save for only some file types; it's all or nothing.

ctagsymbols

ctagsymbols Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ctagsymbols

ctagsymbols Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README