c 0,-1,1,0,0,0,5 travis-ci npm

Compile and execute C "scripts" in one go!


Build Status

“There isn’t much that’s special about C. That’s one of the reasons why it’s fast.”

I love C for its raw speed (although it does have its drawbacks). We should all write more C.

With this shell script, you can compile and execute C “scripts” in one go!

(Oh yeah, and it works for C++ too.)

GIF Demo

Here’s a simple example:

#include <stdio.h>

int main(void) {
    printf("Hello World!\n");
    return 0;

Run it by typing:

$ c hello.c
Hello World!

Or, call it from the shebang!

#include <stdio.h>

int main(void) {
    printf("Hello World!\n");
    return 0;
$ chmod +x hello.c
$ ./hello.c
Hello World!

Hooked? Here’s how to install it:

Use a package manager? Check here.

For all users:

$ wget https://raw.githubusercontent.com/ryanmjacobs/c/master/c
$ sudo install -Dm 755 c /usr/bin/c

Just for a local user:

$ wget https://raw.githubusercontent.com/ryanmjacobs/c/master/c
$ sudo install -Dm 755 c ~/.bin/c
$ echo 'PATH=$PATH:$HOME/.bin' >> ~/.bashrc

Note: if you install it somewhere other than /usr/bin/c, then your shebang will be different. For example it may be something more similar to #!/home/ryan/.bin/c.

Okay, how do I use it?

c will use whatever $CC is set to. You can change this with:

$ export CC=clang
$ export CC=tcc
$ # etc...


Multiple Files - CLI

Anything you want passed to the compiler, put in quotes as the first argument. Whether they’re flags (-Wall, -O2, etc.) or file names (file.c, main.c, etc.).

$ c "main.c other.c" arg1 arg2
$ c "main.c other.c -O3 -Wall -lncurses" arg1 arg2

Single File - CLI

With only one file, omit the quotes:

$ c hello.c
$ c main.c arg1 arg2


After adding a shebang, just set the file to executable and it’s ready to run.

$ chmod +x file.c
$ ./file.c

Single File - Shebang

Add this to the top of your C file:


Multiple Files - Shebang

Just tack on any extra flags, options, or files you want passed to the compiler. Then be sure to add the terminating -- characters.

#!/usr/bin/c file1.c file2.c -lncurses -lm --

Compiling from stdin

$ cat hello.c | c
# ...or...
$ c < hello.c
$ c "" arg1 arg2 < hello.c
$ c "other.c -lncurses" arg1 arg2 < hello.c


The default cache size is set to 5 MB. You can change this with:

$ export C_CACHE_SIZE=$((10*1024)) # 10 MB

The default cache path is set to $TMPDIR/c.cache. You can change this with:

$ export C_CACHE_PATH="/tmp/the_cache"


Feel free to submit any ideas, questions, or problems by reporting an issue. Or, if you’re feeling bit brave, submit a pull request. :grimacing:

Just hack away and make sure that all the tests pass.

$ cd tests
$ ./test.sh


First of all, I want to clarify why this is not the same as tcc -run. TCC is a compiler. We all know that. TCC will perform its own set of optimizations, just as GCC will perform its own and Clang will perform its own. The purpose of this script is to give a simple front-end to your favorite compiler.

Whether it’s GCC, Clang, or something else entirely, you get to choose your compiler.

Second reason: it’s simply satisfying to type c hello.c and see it run instantly.

Third reason: I’m a fan of speed, and C definitely offers it. Being able to write a small, fast, and portable C “script” is great. You can pass around a C “script” just like you would a BASH script.


If you’re using zsh, then you can take advantage of zsh’s suffix aliases:

$ alias -s c='c'
$ alias -s cc='c'
$ alias -s cpp='c'

Then you can run files with ./file.c without chmod +x.


Use a package manager? You’ve come to the right place.

AUR: https://aur.archlinux.org/packages/c/
bpkg: bpkg install ryanmjacobs/c
brew: brew install https://raw.githubusercontent.com/ryanmjacobs/c/master/c.rb (shebang will be #!/usr/local/bin/c)


Maybe later we can implement caching. Done!


MIT License.

Basically, you can do whatever you want provided that you include the LICENSE notice in any copy of the source. Also, I am not liable if the script breaks anything.

Related Repositories



https://github.com/json-c/json-c is the official code repository for json-c. See the wiki for release tarballs for download. ...



MessagePack implementation for C and C++ / msgpack.org[C/C++] ...



用 Objective-C 实现《大话设计模式》书中的例子,并用一些 Objective-C 的特性对例子的实现加以优化 ...



ngrok client for c language,Due to the use of GO ngrok language development, porting to embedded devices some inconvenience, such as openwrt, so use C language rewrite a client. Very mini, the need to support polarssl library. ...



开源书籍:《C语言编程透视》,透视 C 的前世今生! ...

Top Contributors

ryanmjacobs Tyilo jwerle nashidau alistairking MichalPokorny Uladox haguenau moosd


-   v0.10 zip tar
-   v0.09 zip tar
-   v0.08 zip tar
-   v0.07 zip tar
-   v0.06 zip tar
-   v0.05 zip tar
-   v0.04 zip tar
-   v0.03 zip tar
-   v0.02 zip tar
-   v0.01 zip tar