Skip to content
A c/c++ client/server indexer for c/c++/objc[++] with integration for Emacs based on clang.
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Add issue template for feature requests Jun 7, 2018
bin Convert and to POSIX sh Feb 25, 2019
cmake check the one in the path first. Mar 29, 2019
man/man7 Bump version to 2.33 Jun 21, 2019
scripts Only push the tag not the changes when bumping version Jun 24, 2019
share/etc add some example scripts for running rdm as a service using system v Aug 19, 2017
src Bump version to 2.33 Jun 21, 2019
tests Add print include path test Apr 28, 2019
web/youtube youtube screenshots Mar 25, 2013
.dir-locals.el RTags CI/CD setup Oct 13, 2018
.gitignore Remove lua. It was never made fully functional and if we ever wanted Mar 13, 2019
.gitmodules Remove lua. It was never made fully functional and if we ever wanted Mar 13, 2019
.travis.yml Revert "It seems like linux builds faster. Start Mac first." Jun 18, 2019
CHANGELOG update changelog Jun 21, 2019
CMakeLists.txt Don't set BUILD_TESTING to True by default (Fix #1328) Jun 24, 2019
LICENSE.txt Update quickstart source file position Jun 19, 2019
clang.sup Fix pch Mar 22, 2012
configure Remove lua. It was never made fully functional and if we ever wanted Mar 13, 2019



RTags is a client/server application that indexes C/C++ code and keeps a persistent file-based database of references, declarations, definitions, symbolnames etc. There’s also limited support for ObjC/ObjC++. It allows you to find symbols by name (including nested class and namespace scope). Most importantly we give you proper follow-symbol and find-references support. We also have neat little things like rename-symbol, integration with clang’s “fixits” ( We also integrate with flymake using clang’s vastly superior errors and warnings. Since RTags constantly will reindex “dirty” files you get live updates of compiler errors and warnings. Since we already know how to compile your sources we have a way to quickly bring up the preprocessed output of the current source file in a buffer.

While existing taggers like gnu global, cscope, etags, ctags etc do a decent job for C they often fall a little bit short for C++. With its incredible lexical complexity, parsing C++ is an incredibly hard task and we make no bones about the fact that the only reason we are able to improve on the current tools is because of clang ( RTags is named RTags in recognition of Roberto Raggi on whose C++ parser we intended to base this project but he assured us clang was the way to go. The name stuck though.

Tarball releases are available here:

TLDR Quickstart

Build RTags

git clone --recursive
cd rtags

Start the RTags daemon (rdm)

./bin/rdm &

Index the RTags project, and wait until rdm is silent

./bin/rc -J .

Open source file in emacs

emacs +74:34 src/rdm.cpp

Load rtags.el

M-: (load-file "rtags.el") RET

Ensure rc can be found

M-x set-variable RET rtags-path RET "../bin" RET

Call rtags-find-symbol-at-point

M-x rtags-find-symbol-at-point RET

Your location is now on the definition of Server::instance()


The documentation can be found in the Wiki.


RTags is still under development and is not the most stable piece of software you’ll ever find. We’re constantly working to improve on it.

You can’t perform that action at this time.