The cling C++ interpreter


Cling - The Interactive C++ Interpreter

The main repository is at


Cling is an interactive C++ interpreter, built on top of Clang and LLVM compiler
infrastructure. Cling realizes the read-eval-print loop

concept, in order to leverage rapid application development. Implemented as a
small extension to LLVM and Clang, the interpreter reuses their strengths such
as the praised concise and expressive compiler diagnostics.

See also cling’s web page.

Please note that some of the resources are rather old and most of the stated
limitations are outdated.


Release Notes

See our release notes to find what’s new.


Our nightly binary snapshots can be found

Building from Source

git clone
cd llvm-project
git checkout cling-latest
cd ../
git clone <cling>
mkdir cling-build && cd cling-build


./cling '#include <stdio.h>' 'printf("Hello World!\n")'

To get started run:

./cling --help

or type

[cling]$ .help


Cling comes with a Jupyter kernel. After building cling,
install Jupyter and cling’s kernel by following the in
tools/Jupyter. Make sure cling is in your PATH when you start jupyter!

Citing Cling

% Peer-Reviewed Publication
% 19th International Conference on Computing in High Energy and Nuclear Physics (CHEP)
% 21-25 May, 2012, New York, USA
  author = {Vassilev,V. and Canal,Ph. and Naumann,A. and Moneta,L. and Russo,P.},
  title = {{Cling} -- The New Interactive Interpreter for {ROOT} 6}},
  journal = {Journal of Physics: Conference Series},
  year = 2012,
  month = {dec},
  volume = {396},
  number = {5},
  pages = {052071},
  doi = {10.1088/1742-6596/396/5/052071},
  url = {},
  publisher = {{IOP} Publishing}

Developers’ Corner

Cling’s latest doxygen documentation


Every contribution is considered a donation and its copyright and any other
related rights become exclusive ownership of the person who merged the code or
in any other case the main developers of the “Cling Project”.

We warmly welcome external contributions to the Cling! By providing code,
you agree to transfer your copyright on the code to the “Cling project”.
Of course you will be duly credited and your name will appear on the
contributors page, the release notes, and in the CREDITS file
shipped with every binary and source distribution. The copyright transfer is
necessary for us to be able to effectively defend the project in case of


Please see our LICENSE.


Our release steps to follow when cutting a new release:

  1. Update release notes
  2. Remove ~dev suffix from VERSION
  3. Add a new entry in the news section of our website
  4. Commit the changes.
  5. git tag -a v0.x -m "Tagging release v0.x"
  6. Tag cling-patches of clang.git:
    git tag -a cling-v0.x -m "Tagging clang for cling v0.x"
  7. Create a draft release in github and copy the contents of the release notes.
  8. Wait for green builds.
  9. Upload binaries to github (Travis should do this automatically).
  10. Publish the tag and announce it on the mailing list.
  11. Increment the current version and append ~dev.