█████╗  ██████╗ ███████╗███╗   ██╗████████╗███████╗ ██████╗ ██████╗  ██████╗ ███████╗
  ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
  ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║   █████╗  ██║   ██║██████╔╝██║  ███╗█████╗  
  ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║   ██╔══╝  ██║   ██║██╔══██╗██║   ██║██╔══╝  
  ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║   ██║     ╚██████╔╝██║  ██║╚██████╔╝███████╗
  ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝      ╚═════╝ ╚═╝  ╚═╝ ╚═════╝ ╚══════╝

⚡ AgentForge

The Universal AI Coding Agent Toolkit & Operating System

Single Source of Truth for all your AI Coding Agents + 85% Token AST Compressor + Rule Linter + 7 Built-in Agent Skills.

Quickstart • Features • Comparison • Web Studio • Skills Library

---

💥 The Problem

Developers using AI coding assistants are trapped in fragmented configurations:

1. Rule Fragmentation: You have to manually maintain .cursorrules, .cursor/rules/*.mdc, CLAUDE.md, .windsurfrules, .agents/AGENTS.md, .github/copilot-instructions.md, and .aider.conf.yml.
2. Context Window & Token Burn: Feeding raw source files burns thousands of tokens per prompt, costing money and degrading model reasoning.
3. Prompt Drift & Secret Leaks: Rule files often contain prompt conflicts, vague directives, or accidentally leaked API keys.

🚀 The Solution: AgentForge

AgentForge acts as the Universal Operating System for your AI workflow:

• 🔄 One-Command Multi-Agent Sync: Edit rules once in .agentforge.yaml $\to$ automatically compiles to all 7+ agent formats.
• ⚡ Token-Killer AST Skeletonizer: Shrinks codebases into AST signature skeletons, saving 80% - 90% of prompt tokens.
• 🛡️ Rule & Prompt Linter: Audits rules for security vulnerabilities, exposed API keys, prompt conflicts, and bloat.
• 🧩 Built-in Skills Marketplace: 1-click install modular capabilities (tdd-architect, security-auditor, minimalist-architect, fastapi-master, etc.).
• 🎨 Visual Web Studio & TUI: Interactive Terminal UI and local dark-mode glassmorphism web dashboard.

---

⚡ Quickstart in 30 Seconds

Note: AgentForge is not published on npm yet, so npx agentforge / npm install -g agentforge will not work. Run it from GitHub instead (Node.js 18+, npm 10+ recommended).

Run directly from GitHub with npx (it builds on install):

# 1. Initialize AgentForge in any project (auto-detects language & framework)
npx github:mrzroot/agentforge init

# 2. Compile & Synchronize rules across all AI agents
npx github:mrzroot/agentforge sync

# 3. Compress codebase into a token-optimized context bundle
npx github:mrzroot/agentforge pack --out CONTEXT.md

# 4. Audit rules & prompt health
npx github:mrzroot/agentforge lint

# 5. Launch interactive Web Dashboard
npx github:mrzroot/agentforge ui

Or install from source and link the agentforge command globally:

git clone https://github.com/mrzroot/agentforge.git
cd agentforge
npm install          # also builds via the prepare script
npm link             # `agentforge` (and `af`) are now on your PATH

---

📊 Comparison Matrix

Feature	Manual Rules	Cursor Only	Claude Only	AgentForge ⚡
Multi-Agent Sync (Cursor, Claude, Windsurf, Antigravity, Copilot, Aider, Cline)	❌	❌	❌	✅ Full Support
AST Token Compression (80-90% token reduction)	❌	❌	❌	✅ Built-in
Secret & API Key Scanner in Rules	❌	❌	❌	✅ Built-in
Prompt Conflict & Bloat Linter	❌	❌	❌	✅ Built-in
Curated Skills Library	❌	❌	❌	✅ 7 Built-in Skills
Local Visual Web Studio UI	❌	❌	❌	✅ Zero-Config

---

🛠️ CLI Commands & Usage

1. agentforge sync

Compiles your single source of truth (.agentforge.yaml) into targeted formats:

• 🎯 Cursor: .cursorrules & .cursor/rules/project-rules.mdc
• 🧠 Claude Code: CLAUDE.md
• 🏄 Windsurf: .windsurfrules
• 🛸 Google Antigravity: .agents/AGENTS.md
• 🤖 GitHub Copilot: .github/copilot-instructions.md
• 🦙 Aider: .aider.conf.yml & .aider.prompt.md
• 🦘 Roo Code / Cline: .clinerules

agentforge sync --targets cursor claude windsurf

2. agentforge pack (Token-Killer Engine)

Extracts structural interfaces, function signatures, types, and docstrings while stripping bulky routine bodies.

agentforge pack --out PROJECT_CONTEXT.md

Token Benchmark:

• Original Codebase: 48,200 tokens (~$0.24 per prompt)
• AgentForge AST Skeleton: 6,150 tokens (~$0.03 per prompt)
• Savings: 87.2% reduction in context window usage!

3. agentforge lint

Calculates an automated Agent Health Score (0 - 100%):

• 🚨 CRITICAL: Detects leaked OpenAI / Claude / Gemini API keys, dangerous shell commands (rm -rf /).
• ⚠️ WARNING: Detects contradicting prompt rules and bloated directives (>80 tokens per rule).
• ℹ️ INFO: Flags vague prompt phrasing ("make it clean", "best practices") and suggests concrete constraints.

4. agentforge skills add <name>

Installs battle-tested personas and skills directly into your agent instructions:

agentforge skills list
agentforge skills add tdd-architect
agentforge skills add security-auditor
agentforge skills add minimalist-architect

5. agentforge ui

Launches the interactive Web Studio on http://localhost:3737:

• Real-time visual rule editor with 1-click sync toggles.
• Live AST code compression playground with instant token calculation.
• Circular health score widget and interactive fix suggestions.
• Visual skills browser.

---

🧩 Curated Skills Library

• 🧠 minimalist-architect: Enforces minimalist senior dev philosophy (YAGNI, standard library first, zero bloat).
• 🧪 tdd-architect: Strict Test-Driven Development (Red-Green-Refactor) with boundary isolation.
• 🛡️ security-auditor: OWASP Top 10 hardening, input sanitization, and SQL injection prevention.
• ⚡ token-optimizer: Context window management and prompt payload compression.
• 🐍 fastapi-master: Pydantic v2 schemas, async route handlers, and dependency injection.
• ⚛️ react-nextjs-pro: React Server Components (RSC), App Router, Server Actions, and performance.
• 🐳 docker-devops: Multi-stage, distroless, non-root hardened Dockerfiles.

---

🤝 Contributing

Contributions are warmly welcomed! Feel free to submit an issue, open a pull request, or add new skills to the registry.

git clone https://github.com/mrzroot/agentforge.git
cd agentforge
npm install
npm run build
npm test

---

📄 License

MIT © MRZ - Built with ❤️ for AI Agent Developers worldwide.