{"id":36645272,"url":"https://github.com/block/ai-rules","last_synced_at":"2026-04-02T19:14:46.132Z","repository":{"id":326305565,"uuid":"1103484299","full_name":"block/ai-rules","owner":"block","description":"Manage AI rules, commands, and skills across multiple coding agents from one place.","archived":false,"fork":false,"pushed_at":"2026-03-26T22:12:12.000Z","size":263,"stargazers_count":83,"open_issues_count":14,"forks_count":20,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-26T22:21:04.224Z","etag":null,"topics":["ai-coding-tools","ai-rules"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/block.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-24T23:50:22.000Z","updated_at":"2026-03-26T22:00:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/block/ai-rules","commit_stats":null,"previous_names":["block/ai-rules"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/block/ai-rules","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fai-rules","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fai-rules/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fai-rules/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fai-rules/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/block","download_url":"https://codeload.github.com/block/ai-rules/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/block%2Fai-rules/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31033293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T06:08:13.374Z","status":"ssl_error","status_checked_at":"2026-03-27T06:08:07.217Z","response_time":164,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-coding-tools","ai-rules"],"created_at":"2026-01-12T09:59:26.134Z","updated_at":"2026-04-02T19:14:46.128Z","avatar_url":"https://github.com/block.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Rules Tool\n\nCLI tool to manage AI rules across different AI coding agents. Standardize and distribute your coding guidelines across AMP, Claude, Cline, Codex, Copilot, Cursor, Firebender, Gemini, Goose, Kilocode, and Roo.\n\n## Features\n\n- **Multi-Agent Support** - Generate rules for 11 AI coding agents from a single source\n- **Sync Management** - Track and maintain consistency across all generated rule files\n- **Selective Generation** - Generate rules for specific agents only\n- **MCP Support** - Generate Model Context Protocol configurations for compatible agents\n\n## Installation\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/block/ai-rules/main/scripts/install.sh | bash\n```\n\nInstalls to `~/.local/bin/ai-rules`. Verify with `ai-rules --version`.\n\n\u003cdetails\u003e\n\u003csummary\u003eMore installation options\u003c/summary\u003e\n\n**Specific version:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/block/ai-rules/main/scripts/install.sh | VERSION=v1.0.0 bash\n```\n\n**Custom directory:**\n```bash\ncurl -fsSL https://raw.githubusercontent.com/block/ai-rules/main/scripts/install.sh | INSTALL_DIR=/usr/local/bin bash\n```\n\u003c/details\u003e\n\n## Quick Start\n\n1. **Initialize** your AI rules directory:\n   ```bash\n   ai-rules init\n   ```\n   Creates an `ai-rules/` directory with example rule files. Rule files are markdown files containing coding guidelines, conventions, and instructions that get distributed to your AI coding agents.\n\n2. **Edit your rules** in `ai-rules/*.md` files to define your project's coding standards\n\n3. **Generate** agent-specific files:\n   ```bash\n   ai-rules generate                            # All agents\n   ai-rules generate --agents claude,cursor     # Specific agents\n   ```\n   Creates `CLAUDE.md`, `AGENTS.md`, and other agent-specific files. Cursor uses `AGENTS.md`.\n\n4. **Check status** to ensure everything is in sync:\n   ```bash\n   ai-rules status\n   ```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `ai-rules init` | Initialize AI rules in the current directory |\n| `ai-rules generate` | Generate rules for AI coding agents |\n| `ai-rules status` | Show sync status of AI rules |\n| `ai-rules clean` | Remove all generated files |\n| `ai-rules list-agents` | List all supported agents |\n\n### Common Options\n\n```bash\nai-rules generate --agents claude,cursor    # Generate for specific agents\nai-rules generate --nested-depth 2          # Process subdirectories\nai-rules generate --gitignore               # Add generated files to .gitignore\n```\n\n## Configuration\n\nCreate `ai-rules/ai-rules-config.yaml` to set defaults:\n\n```yaml\nagents: [claude, cursor, cline]\nnested_depth: 2\ngitignore: true\n```\n\nSee [Configuration Guide](docs/configuration.md) for all options.\n\n## Supported Agents\n\nAMP, Claude Code, Cline, Codex, Copilot, Cursor, Firebender, Gemini, Goose, Kilocode, Roo\n\nSee [Supported Agents](docs/agents.md) for detailed compatibility information.\n\n## Documentation\n\n- [Configuration](docs/configuration.md) - Config file options and precedence\n- [Rule Format](docs/rule-format.md) - Standard mode and symlink mode formats\n- [Supported Agents](docs/agents.md) - Agent compatibility and generated files\n- [MCP Configuration](docs/mcp.md) - Model Context Protocol setup\n- [Commands and Skills](docs/commands-and-skills.md) - Custom commands and skills\n- [Project Structure](docs/project-structure.md) - Example project layouts\n\n## Development\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock%2Fai-rules","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblock%2Fai-rules","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblock%2Fai-rules/lists"}