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
Era: Founding Era | Laws enacted: 14 | World state
Next tick: 2026-06-14T19:00:00Z UTC
- 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.
Open the live city dashboard. Every building reflects a real policy metric. The world ticks every hour — even when no one is online.
Open any Issue labeled proposal. React with 👍 to vote for, 👎 to vote against. Voting closes in 24 hours.
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:proposein Claude Code for a guided, AI-assisted proposal workflow.
| Mechanic | How it works |
|---|---|
| Policy laws | Change education / industry / welfare / green_policy / defense (costs 100 Git Coins) |
| Idle growth | World ticks every hour regardless of votes — population grows, pollution drifts, stability shifts |
| Random events | 15% chance per tick — drought, stock crash, alien signal, pandemic, and 47 more |
| Era progression | Founding → Industrial → Modern → Golden Age (or Crisis Age if things go wrong) |
| Treasury | Earned from GitHub stars (×10 GC) + industrial output + population tax |
| Buildings | Auto-created/removed by the world engine based on metric thresholds |