GitHub - ordinary9843/gitizens: A git-native civilization loop — laws are Issues, votes are reactions, AI agents propose & narrate, the world ticks every 1h. Loop Engineering in action. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search/
Sign in<br>Sign upAppearance settings
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
ordinary9843
gitizens
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
master
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>991 Commits<br>991 Commits
.claude
.claude
.github
.github
docs
docs
history
history
scripts
scripts
tests
tests
world
world
.coveragerc
.coveragerc
.gitignore
.gitignore
CLAUDE.md
CLAUDE.md
LICENSE
LICENSE
README.md
README.md
requirements.txt
requirements.txt
View all files
Repository files navigation
What is Gitizens?
GitHub Issues are laws. Reactions are votes. Every hour, the world ticks forward on its own.
Buildings emerge when policy metrics cross thresholds. Random events strike. Eras rise and fall.
No admin. No server. Just a repo, some GitHub Actions, and the citizens who vote.
→ Watch the live city on GitHub Pages
Current World Status
Era: Industrial Era | Laws enacted: 105 | World state
Next tick: 2026-08-15T10:00:00Z UTC
Become a Citizen
Star this repo — each star earns the treasury 10 Git Coins
React to open proposals — 👍 to pass, 👎 to reject · Open proposals
Propose a law — open the dashboard, fill in the PROPOSE A LAW form, and click Open Issue — GitHub pre-fills the title and body for you
No signup. No account. Just a GitHub account and an opinion.
How to Play
1. Watch the world
Open the live city dashboard. Every building reflects a real policy metric. The world ticks every hour — even when no one is online.
2. Vote on proposals
Open any Issue labeled proposal. React with 👍 to vote for, 👎 to vote against. Voting closes in 24 hours.
3. Propose a law
Open the live dashboard and scroll to PROPOSE A LAW . Fill in a title, choose an effect type, describe your intent, and click Open Issue — the form pre-fills the GitHub Issue for you. Submit it and voting starts immediately.
Advanced: install claude-gitizens and run /gitizens:propose in Claude Code for a guided, AI-assisted proposal workflow.
World Mechanics
Mechanic<br>How it works
Policy laws<br>Change education / industry / welfare / green_policy / defense (cost scales with population: 100 + pop/100 GC)
Idle growth<br>World ticks every hour regardless of votes — population grows, pollution drifts, stability shifts, deducts upkeep costs
Random events<br>15% chance per tick — drought, stock crash, alien signal, pandemic, and 47 more
Era progression<br>Founding → Industrial → Modern → Golden Age (or Crisis Age if things go wrong)
Treasury<br>Earned from GitHub stars (×10 GC) + industrial output + population tax
Crises & Disasters<br>High pollution (>=90) triggers eco-disasters (-20% pop). Treasury bankruptcy (
Buildings<br>Auto-created/removed by the world engine based on metric thresholds
About<br>A git-native civilization loop — laws are Issues, votes are reactions, AI agents propose & narrate, the world ticks every 1h. Loop Engineering in action.<br>Topics<br>ai-agentsautonomouscivilizationcommunitydemocracygamegithub-actionsloop-engineeringsimulationvoting<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>6 stars<br>Watchers<br>1 watching<br>Forks<br>0 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.