Interactive GCC

[!NOTE]

The original repository from Andy Balaam is here: https://codeberg.org/andybalaam/igcc.

In this fork, I've done some refactoring and tried to make it easier to use.

[!WARNING]

This project is a hacky attempt at getting a shorter feedback loop when working with C/C++ in some cases and it's obviously not intended for anything serious.

Interactive GCC (igcc) is a read-eval-print loop (REPL) for C/C++. It works by manipulating a base source file with user commands, compiles the source after each modification, then executes the resulting binary and collects its stdout & stderr. Multi-line (block) input is supported, so you can add multiple lines in one go and invoke the compiler just once (examples below).

You can include various header files. For convenience, a default header is included: boilerplate.h. Also, using namespace std; is not available by default, but you can explicitly add it (example below).

Various aspects of igcc can be configured, see config.yaml.

Getting started

The easiest way to get started is to use pipx:

pipx install git+https://github.com/alexandru-dinu/igcc.git

Alternatively, you can also use uv:

uv tool run git+https://github.com/alexandru-dinu/igcc

And for dev:

git clone https://github.com/alexandru-dinu/igcc.git
cd igcc
uv sync

Available args:

usage: igcc [-h] [-I INCLUDE [INCLUDE ...]] [-L LIBDIR [LIBDIR ...]]
            [-l LIB [LIB ...]]
options:
  -h, --help            show this help message and exit
  -I INCLUDE [INCLUDE ...]
                        Add INCLUDE to the list of directories to be searched
                        for header files.
  -L LIBDIR [LIBDIR ...]
                        Add LIBDIR to the list of directories to be searched
                        for library files.
  -l LIB [LIB ...]      Search the library LIB when linking.

The code will be compiled with GCC (g++) and the results (if any) will be displayed. Type .h for help:

$ igcc
[1]> .h
.h  Show this help message
.e  Show the last compile errors/warnings
.l  List the code you have entered
.L  List the whole program as given to the compiler
.r  Redo undone command
.u  Undo previous command
.q  Quit

Examples

$ igcc
[1]> int a = 5;
[2]> a += 2;
[3]> using namespace std;
[4]> cout << a << endl;
7
[5]> int b = 17;
[6]> a *= b;
[7]> cout << a << ", " << b << endl;
119, 17
[8]> .L
#include "boilerplate.h"
using namespace std;
int main(void) {
    int a = 5;
    a += 2;
    cout << a << endl;
    int b = 17;
    a *= b;
    cout << a << ", " << b << endl;
    return 0;
}

Multi-line input is supported (check multiline_marker from config). The benefit is avoiding multiple compiler calls.

$ igcc
[1]> .m
... for (int i = 0; i < 10; i++) {
...   std::cout << i << " ";
... }
... std::cout << "\n";
... .m
0 1 2 3 4 5 6 7 8 9

You can include headers:

$ igcc
[1]> #include 
[2]> std::vector xs{1,2,3};
[3]> xs.push_back(17);
[4]> .m
... for (auto x : xs) {
...   std::cout << x << " ";
... }
... .m
1 2 3 17

Libs can be linked:

$ igcc -lpthread
[  1]> #include 
[  2]> pthread_t thr;
[  3]> const char* msg = "Hello, World!";
[  4]> // assuming print_msg is defined somewhere
[  5]> int ret = pthread_create(&thr, NULL, print_msg, (void*) msg); pthread_join(thr, NULL);
Hello, World!

You can also undo commands:

$ igcc
[1]> int x = 2
 Compile error - type .e to see it
[2]> .e
: In function ‘int main()’:
:7:5: error: expected ‘,’ or ‘;’ before ‘return’
:5:9: warning: unused variable ‘x’ [-Wunused-variable]
[2]> .u
Undone int x = 2
[1]> int x = 2;
[2]> .L
#include "boilerplate.h"

int main(void) {
    int x = 2;
    return 0;
}

... or redo previously undone commands:

$ igcc
[1]> int x = 2;
[2]> std::cout << x;
2
[3]> .u
Undone std::cout << x;
[2]> .L
#include "boilerplate.h"

int main(void) {
    int x = 2;
    return 0;
}
[2]> .r
Redone std::cout << x;
2
[3]> .L
#include "boilerplate.h"

int main(void) {
    int x = 2;
    std::cout << x;
    return 0;
}

Future work

See https://github.com/alexandru-dinu/igcc/issues

Similar projects

• https://github.com/BenBrock/reple: "Replay-based" REPLs for compiled languages
• https://github.com/root-project/cling: The cling C++ interpreter

Credits

• IGCC home page
• IGCC Sourceforge page
• Andy Balaam's home page
• Andy Balaam's blog
• Andy Balaam may be contacted on axis3x3 at users dot sourceforge dot net
• IGCC is Copyright (C) 2009 Andy Balaam
• IGCC is Free Software released under the terms of the GNU General Public License version 3
• IGCC comes with NO WARRANTY

--- Tranlated By Open Ai Tx | Last indexed: 2025-12-11 ---