# Submitting PMAT to homebrew-core
This guide covers submitting the PMAT formula to the official Homebrew repository.
## ✅ Prerequisites Met
- [x] **Stable Release**: v2.12.0 tagged and released on GitHub
- [x] **License**: MIT license (Homebrew compatible)
- [x] **Build System**: Standard Cargo build process
- [x] **Tests**: Comprehensive test suite included
- [x] **SHA256**: Calculated and verified
- [x] **Dependencies**: Only build dependency (Rust)
- [x] **Documentation**: Complete with homepage and description
## 🚀 Submission Process
### 1. Fork homebrew-core
```bash
# Fork the repository on GitHub
open https://github.com/Homebrew/homebrew-core
# Clone your fork
git clone https://github.com/YOUR_USERNAME/homebrew-core.git
cd homebrew-core
```
### 2. Create the formula
```bash
# Create formula in correct location
mkdir -p Formula
cp /path/to/pmat.rb Formula/pmat.rb
# Verify formula meets standards
brew audit --strict Formula/pmat.rb
```
### 3. Test the formula
```bash
# Test installation
brew install --build-from-source Formula/pmat.rb
# Test functionality
pmat --version
pmat agent --help
# Test uninstall
brew uninstall pmat
```
### 4. Submit pull request
```bash
# Create branch
git checkout -b add-pmat-2.12.0
# Commit formula
git add Formula/pmat.rb
git commit -m "pmat 2.12.0 (new formula)
PMAT is a zero-config AI context generation and code quality toolkit
with Claude Code Agent Mode for continuous quality monitoring."
# Push and create PR
git push origin add-pmat-2.12.0
```
## 📋 PR Description Template
```markdown
## PMAT 2.12.0 (new formula)
PMAT (Pragmatic AI MCP Agent Toolkit) is a zero-configuration AI context generation system with Claude Code Agent Mode for continuous quality monitoring.
### Features:
- Claude Code Agent Mode with MCP protocol integration
- AI context generation optimized for LLM workflows
- Code complexity analysis with Toyota Way standards
- Technical debt detection and quality gates
- Multi-language support (30+ languages via tree-sitter)
- Production-ready systemd service deployment
### Formula Details:
- **Build system**: Cargo (standard Rust)
- **Dependencies**: rust (build only)
- **License**: MIT
- **Tests**: Version check and basic functionality
- **Platforms**: macOS and Linux
### Verification:
- [x] `brew audit --strict Formula/pmat.rb` passes
- [x] `brew install --build-from-source Formula/pmat.rb` succeeds
- [x] `brew test pmat` passes
- [x] Binary works correctly: `pmat --version` shows 2.12.0
### Links:
- Homepage: https://github.com/paiml/paiml-mcp-agent-toolkit
- Documentation: https://github.com/paiml/paiml-mcp-agent-toolkit/blob/master/docs/CLAUDE_CODE_AGENT.md
- npm package: https://www.npmjs.com/package/pmat-agent
- Docker: https://hub.docker.com/r/paiml/pmat
```
## 🔍 Review Criteria
Homebrew maintainers will check:
1. **Notability**: PMAT provides unique AI/code quality functionality
2. **Stability**: v2.12.0 is a stable release with comprehensive testing
3. **Build**: Standard Cargo build process (well-supported)
4. **Tests**: Formula includes appropriate test cases
5. **Naming**: "pmat" follows Homebrew naming conventions
6. **Dependencies**: Minimal (only build-time Rust dependency)
## ⚡ Expected Timeline
- **Submission**: Immediate (ready now)
- **Initial Review**: 1-7 days
- **Feedback/Iterations**: 1-2 weeks
- **Approval**: 2-4 weeks total
## 🎯 Success Metrics
Once approved:
- `brew install pmat` available globally
- 5M+ macOS/Linux developers can access PMAT
- Claude Code integration becomes one-command setup
- Enhanced credibility through official Homebrew inclusion
## 📞 Support
- **Formula Issues**: GitHub Issues on homebrew-core PR
- **PMAT Issues**: https://github.com/paiml/paiml-mcp-agent-toolkit/issues
- **Homebrew Guidelines**: https://docs.brew.sh/Formula-Cookbook