Skip to content

nbiish/ainish-coder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

◈──◆──◇ ainish-coder ◇──◆──◈

🚀 Configuration Manager for AI Coding Assistants

Simple deployment of MAI RULES and AGENTS.md configurations to your projects

Now supports AGENTS.md - the universal standard for AI pair programmers


🎯 What is ainish-coder?

ainish-coder is a powerful configuration management tool that simplifies deploying AI coding assistant rules across multiple platforms. It creates a unified configuration system using the emerging AGENTS.md standard, ensuring consistent AI behavior across all your development tools.


Support This Project

Stripe

Scan to donate

Donate via Stripe

Buy me a coffee

🔥 Key Features

  • 🎯 AGENTS.md Standard: Deploy universal AI agent instructions
  • 🏗️ Modular Architecture: Clean Atom → Molecule → Protein structure
  • 🤖 Multiple AI Tools: Cursor, Claude Code, Windsurf, Cline, Continue Dev, GitHub Copilot, Gemini CLI, Qwen, Roo Code, and Trae
  • 🔄 OSA (YOLO Mode) Framework: CLI YOLO agents (Claude, Gemini, Qwen, OpenCode, Crush) for parallel autonomous execution
  • ⚡ Simple Deployment: One command to deploy configurations
  • 🔗 Smart File Management: Copies configurations to ensure tool-specific customization
  • 💻 Shell Integration: Convenient ainish-coder command
  • 🎭 Template Agent System: Craft custom system prompts with expert guidance
  • 🛡️ Security Options: Local secret protection OR GitHub Actions CI/CD integration

📦 Quick Start

Installation

# Clone the repository
git clone https://github.com/nbiish/ainish-coder
cd ainish-coder

# Run setup
chmod +x ainish-setup.sh
./ainish-setup.sh

# Reload shell (macOS/Linux)
source ~/.zshrc  # or ~/.bashrc

Basic Usage

# Deploy core rules files (RECOMMENDED FIRST STEP)
ainish-coder --rules                     # Deploy AGENTS.md, llms.txt/, and .gitignore
ainish-coder --agents-security           # Deploy AGENTS_LLM_SECURITY.md and AGENTS_CODE_SECURITY.md

# Deploy tier-specific rules (appends to MAIRULES.md)
ainish-coder --tier 0                    # Append TIER_0 (Documentation protocols)
ainish-coder --tier 1                    # Append TIER_1 (Code security)
ainish-coder --tier all                  # Append all tiers (0-4)
ainish-coder --mairules                  # Deploy MAIRULES.md with ALL tiers

# Deploy tool-specific configurations
ainish-coder --cursor                    # Deploy Cursor AI - rules, commands, ignore files
ainish-coder --claude                    # Deploy Claude Code - rules, commands
ainish-coder --windsurf                  # Deploy Windsurf - rules, workflows
ainish-coder --cline                     # Deploy Cline - single .clinerules file
ainish-coder --continue                  # Deploy Continue.dev - rules, prompts, ignore files
ainish-coder --copilot                   # Deploy GitHub Copilot to .github/instructions/
ainish-coder --gemini                    # Deploy Gemini CLI - rules, commands (TOML)
ainish-coder --qwen                      # Deploy Qwen AI - rules, commands (TOML)
ainish-coder --roocode                   # Deploy Roo Code - rules, commands, ignore files
ainish-coder --trae                      # Deploy TRAE rules to .trae/rules/

# Deploy custom commands
ainish-coder --commands cursor           # Deploy slash commands
ainish-coder --commands windsurf         # Deploy workflows
ainish-coder --commands all              # Deploy to all applicable tools

# Agent customization
ainish-coder --template-agent            # Deploy template-agent.md for custom system prompts
ainish-coder --osa                       # Deploy OSA (YOLO Mode) Framework - CLI YOLO agents

# Security deployments
ainish-coder --local-security            # Deploy LOCAL secret protection (git hooks + scripts)
ainish-coder --github-actions            # Deploy GitHub Actions workflows (CI/CD integration)

# Utility commands
ainish-coder --gitignore                 # Deploy comprehensive .gitignore
ainish-coder --critical                  # Deploy critical.md from TIER_0
ainish-coder --license                   # Deploy LICENSE file
ainish-coder --scrolls                   # Deploy .scrolls directory (Vital texts & prompts)
ainish-coder --mcp-recipes               # Deploy MCP recipes

# Ignore file deployment
ainish-coder --cursor-ignore             # Deploy .cursorignore
ainish-coder --cline-ignore              # Deploy .clineignore
ainish-coder --continue-ignore           # Deploy .continueignore
ainish-coder --copilot-ignore            # Deploy .copilotignore
ainish-coder --roocode-ignore            # Deploy .rooignore
ainish-coder --all-ignores               # Deploy all ignore files at once

🛠️ Supported AI Tools

IDE Extensions

Tool Config Flag Commands Flag Description
Cursor --cursor --commands cursor Rules, commands (.cursor/commands/*.md), ignore files
Claude Code --claude --commands claude Rules, commands
Windsurf --windsurf --commands windsurf Rules, workflows (.windsurf/workflows/*.md)
Cline --cline --commands cline Single .clinerules file (merged rules), ignore files
Continue Dev --continue / --cn --commands continue Rules, prompts, ignore files, config.yaml setup
Roo Code --roocode / --roo --commands roocode Rules, commands (.roo/commands/*.md), ignore files
GitHub Copilot --copilot N/A .github/copilot-instructions.md
Trae --trae N/A .trae/rules/AGENTS.md

CLI Tools

Tool Config Flag Commands Flag Description
Gemini CLI --gemini --commands gemini-cli Rules, commands (.gemini/commands/*.toml)
Qwen Code --qwen --commands qwen QWEN.md, commands (.qwen/commands/*.toml)

🎨 Tier Rules Explained

Rules are organized into tiers by priority and purpose:

  • TIER_0 (Documentation): docs-protocol.md - Documentation standards and best practices (Critical)
  • TIER_1 (Code Security): code-security.md - Comprehensive code security best practices (High)
  • TIER_2 (Prompt Security): prompt-security.md - AI prompt injection defense and security (High)
  • TIER_3 (Cultural Style): anishinaabe-cyberpunk-style.md - Anishinaabe cyberpunk aesthetic preferences (Medium)
  • TIER_4 (Advanced Prompting): modern-prompting.md - OOReDAct framework and advanced prompting techniques (Medium)

🏗️ Architecture

The tool is built with a modular, extensible design following the Atomic Design pattern:

  • CLI Tool (bin/ainish-coder): Main command-line interface
  • Atoms (dna/atoms/): Core utilities (colors, paths, validation, file operations)
  • Molecules (dna/molecules/): Deployment functions (deploy_*.sh)
  • Proteins (dna/proteins/): Higher-level orchestration
  • CONFIGURATIONS (CONFIGURATIONS/): Centralized tool-specific configs (now centralized in .configs/)
  • TIER_RULES (TIER_RULES/): Modular rule sets organized by priority

📚 Citation

@misc{ainish-coder2026,
  author/creator/steward = {ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians},
  title/description = {ainish-coder},
  type_of_work = {Indigenous digital creation/software incorporating traditional knowledge and cultural expressions},
  year = {2026},
  publisher/source/event = {GitHub repository under tribal sovereignty protections},
  howpublished = {\url{https://github.com/nbiish/ainish-coder}},
  note = {Authored and stewarded by ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band and enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Indigenous intellectual property, traditional knowledge systems (TK), traditional cultural expressions (TCEs), and associated data protected under tribal law, federal Indian law, treaty rights, Indigenous Data Sovereignty principles, and international indigenous rights frameworks including UNDRIP. All usage, benefit-sharing, and data governance are governed by the COMPREHENSIVE RESTRICTED USE LICENSE FOR INDIGENOUS CREATIONS WITH TRIBAL SOVEREIGNTY, DATA SOVEREIGNTY, AND WEALTH RECLAMATION PROTECTIONS.}
}

⚖️ Copyright

Copyright © 2026 ᓂᐲᔥ ᐙᐸᓂᒥᑮ-ᑭᓇᐙᐸᑭᓯ (Nbiish Waabanimikii-Kinawaabakizi), also known legally as JUSTIN PAUL KENWABIKISE, professionally documented as Nbiish-Justin Paul Kenwabikise, Anishinaabek Dodem (Anishinaabe Clan): Animikii (Thunder), a descendant of Chief ᑭᓇᐙᐸᑭᓯ (Kinwaabakizi) of the Beaver Island Band, and an enrolled member of the sovereign Grand Traverse Band of Ottawa and Chippewa Indians. This work embodies Traditional Knowledge and Traditional Cultural Expressions. All rights reserved.

📜 License & Contributing

Please refer to the current LICENSE and CONTRIBUTING.md files for legal terms and contribution guidelines.


◈──◆──◇ Made with ♥ by the AINISH community ◇──◆──◈

About

quick && easy rules for my terminal based on latest prompting research combined together

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors