Fork me on GitHub


If Twitter is a 'command-line social network', then Scriptus is shell scripting.

Scriptus is a way of programming interactions between people. What's new is that these interactions can be complicated and span days, weeks, months or years: elections, chess tournaments and games are all easy to create.

(Latest news: Per-process transports, bye-bye to the command line, and Facebook)

Scriptus creates a simple JavaScript environment for communicating via Twitter. Scripts are run inside a simple UNIX-like process model.

A Scriptus server can be stopped at any time. Programs will continue where they left off when it is started again.

Running Scriptus

You will need JDK 6 or more recent. Download Scriptus here and then launch it using this command

java -jar scriptus.war

Scriptus will immediately start at You can change the port using the '-p' option.

Using Scriptus

The Scriptus user guide, and the API documentation are linked to from inside the webapp for reference.

For information on the internals, see the documentation index.

Mailing list

If you want to discuss Scriptus, the 'collaborative games' mailing list is a good list to subscribe to. Despite its title, general discussion concerning Scriptus is fine. At present it's very low traffic.


Scriptus is Free software: the license is the GNU GPL, v2 or above.


Ian Sollars ( or @ianso


The Scriptus WAR file can be executed from the command line or deployed in any servlet container such as Tomcat.

You can also download the source in either zip or tar formats.

You can also clone the project with Git by running:

$ git clone git://