Gitizens — Uma Nação Governada pelo GitHub
ordinary9843/gitizens
Nação descentralizada onde reações são votos e commits são leis
Ver no GitHubUm experimento de governança descentralizada que simula uma cidade inteira rodando como repositório GitHub. Cidadãos votam via reações em Issues, leis são propostas e aprovadas por reações, e o mundo evolui automaticamente a cada 2 horas sem necessidade de servidor central. Combina gamificação, política e automação de forma única.
Instalação
npx convez-ai ordinary9843/gitizens1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Experimentar governança descentralizada e votação participativa
- Criar comunidades gamificadas com mecânicas de simulação de cidades
- Demonstrar automação completa via GitHub Actions sem infraestrutura externa
- Educação sobre processos democráticos e impacto de políticas em sistemas complexos
Veredito

Projeto ambicioso e criativo que usa GitHub como infraestrutura de governança real. Requer compreensão profunda de GitHub Actions, web scraping de reações e simulações de estado, mas oferece um modelo único de DAO descentralizado sem smart contracts.
README
A tradução para o português deste README ainda está na fila.
What is Gitizens?
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
Current World Status
Era: Founding Era | Laws enacted: 14 | World state
Next tick: 2026-06-14T06: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 2 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
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.
World Mechanics
| 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 |