GitHub Issues are laws. Reactions are votes. Every 2 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
Era: Founding Era | Laws enacted: 12 | World state
Next tick: 2026-06-13T19: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 2 hours — 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 2h 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 |