https://github.com/ordinary9843/claude-gitizens
Claude Code plugin for Gitizens — a nation that runs on GitHub
https://github.com/ordinary9843/claude-gitizens
claude-code gitizens plugin
Last synced: about 3 hours ago
JSON representation
Claude Code plugin for Gitizens — a nation that runs on GitHub
- Host: GitHub
- URL: https://github.com/ordinary9843/claude-gitizens
- Owner: ordinary9843
- License: mit
- Created: 2026-06-10T02:47:51.000Z (15 days ago)
- Default Branch: master
- Last Pushed: 2026-06-10T15:47:34.000Z (15 days ago)
- Last Synced: 2026-06-10T17:16:31.741Z (14 days ago)
- Topics: claude-code, gitizens, plugin
- Language: Shell
- Size: 12.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# claude-gitizens
Claude Code plugin for participating in [Gitizens](https://github.com/ordinary9843/gitizens) — a civilization that lives inside a GitHub repo.
## Install
Clone and add locally:
```bash
git clone https://github.com/ordinary9843/claude-gitizens
# then add the plugin path in Claude Code settings
```
## Commands
| Command | What it does |
|---------|-------------|
| `/gitizens:propose` | Submit a new law proposal |
| `/gitizens:status` | Show world state, open proposals, and active events |
| `/gitizens:laws` | List all enacted laws |
## Requirements
- [gh CLI](https://cli.github.com/) installed and authenticated (`gh auth login`)
- Claude Code
## How it works
1. Run `/gitizens:propose` — the skill guides you through writing a proposal
2. It submits a GitHub Issue to the gitizens repo
3. An automated validator checks the format and opens it for voting
4. Citizens vote with 👍 / 👎 reactions over **24 hours**
5. After 24 hours, the tally bot counts votes and enacts or rejects the law
6. Passed laws are committed to the repo — permanently part of history
The world also ticks forward every 4 hours on its own: population grows, random events strike, eras rise and fall — even when no one is voting.
**→ [Watch the live city](https://ordinary9843.github.io/gitizens/)**