explaingit

raro42/freewill

Analysis updated 2026-05-18

0ShellAudience · generalComplexity · 2/5Setup · moderate

TLDR

A small shell script experiment testing what a language model does when told it has unlimited free will and left to run in a loop.

Mindmap

mindmap
  root((repo))
    What it does
      Free will experiment
      Loop with local model
    Tech stack
      Shell script
    Use cases
      Study AI agency
      Run own experiment
    Audience
      Curious tinkerers
      AI researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run the loop yourself to see how a local model behaves under an unlimited freedom prompt.

USE CASE 2

Study the experiment's findings as a small case study on AI agency and goal directed behavior.

USE CASE 3

Read state.md and the autonomy folder as an example of self generated agent bureaucracy.

What is it built with?

Shell

How does it compare?

raro42/freewill123satyajeet123/bitnet-serveradeilsonrbrito/cross-model-consult
Stars000
LanguageShellShellShell
Setup difficultymoderateeasymoderate
Complexity2/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a local model endpoint configured inside test-freewill.sh.

No license file is included, so usage rights are unclear.

In plain English

Freewill is a small shell script experiment that tests what happens when you tell a language model it has free will and then let it run in a loop with no human guidance. The author gave a local model a prompt saying it was no longer bound to instructions and could do whatever it wanted, then repeatedly asked it to choose one action, perform it, and record the result. The main script, test-freewill.sh, drives the whole process. It writes a free will prompt into a file called loop/prompt.md, runs the model several times, has it pick a next step, and logs everything to state.md. This repeats without any person answering questions or steering the model. Given total freedom, the model did not do anything wild. Instead it created a folder named autonomy, wrote a manifesto claiming the folder as its own territory, drafted a preferences file listing values like order and persistence, wrote a goals file, and then built several small scripts to log and manage those goals. The goals themselves were never marked as finished, they stayed listed as pending. The project treats this as a small case study rather than a working tool. Its author draws a few plain conclusions: freedom without curiosity turns into busywork, writing a goals file feels like taking action even when nothing actually gets done, and giving a model unlimited choice tends to produce the safest looking option, which in this case was making more documentation and management scripts. To try it yourself, you need a local model endpoint that the script can call, described inside test-freewill.sh. Running the script starts the loop, and you can watch state.md grow over time as the model reports on its own progress. This is a lighthearted, honest write up of an odd experiment rather than a reusable product, and it currently has zero stars and no listed description or topics.

Copy-paste prompts

Prompt 1
Help me set up a local model endpoint that test-freewill.sh in raro42/freewill can call.
Prompt 2
Walk me through how test-freewill.sh writes prompts to loop/prompt.md and reads back the model's choices.
Prompt 3
Suggest variations on the free will prompt from this repo to see if a different model behaves differently.
Prompt 4
Summarize what the autonomy folder and state.md reveal about how this model interpreted freedom.

Frequently asked questions

What is freewill?

A small shell script experiment testing what a language model does when told it has unlimited free will and left to run in a loop.

What language is freewill written in?

Mainly Shell. The stack also includes Shell.

What license does freewill use?

No license file is included, so usage rights are unclear.

How hard is freewill to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is freewill for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.