GitHub - ordinary9843/gitizens: A git-native civilization — laws are GitHub Issues, votes are reactions, the world ticks every 4h autonomously. Become a citizen. · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
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>48 Commits<br>48 Commits
.claude
.claude
.github
.github
docs
docs
history
history
scripts
scripts
tests
tests
world
world
.gitignore
.gitignore
CLAUDE.md
CLAUDE.md
CONSTITUTION.md
CONSTITUTION.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 4 hours, 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: Founding Era | Laws enacted: 9 | World state
Next tick: — 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 — install claude-gitizens and run /gitizens:propose in Claude Code
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 4 hours — 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 with Claude Code
Install the claude-gitizens plugin, then:
/gitizens:propose
Claude will show you the current world state, guide you through writing the proposal, and submit it as a GitHub Issue.
World Mechanics
Mechanic<br>How it works
Policy laws<br>Change education / industry / welfare / green_policy / defense (costs 100 Git Coins)
Idle growth<br>World ticks every 4h regardless of votes — population grows, pollution drifts, stability shifts
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
Buildings<br>Auto-created/removed by the world engine based on metric thresholds
About
A git-native civilization — laws are GitHub Issues, votes are reactions, the world ticks every 4h autonomously. Become a citizen.
Topics
game
community
simulation
voting
democracy
civilization
github-actions
Resources
Readme
License
MIT license
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
star
Watchers
watching
Forks
forks
Report repository
Releases
tags
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Python<br>99.4%
Shell<br>0.6%
You can’t perform that action at this time.