🚀 optimi-mac

AI-Native Developer Infrastructure

Toolkit for developers using Claude Code, Cursor, and Codex

Quick Start • Features • Installation • Usage

---

🎯 What is this?

optimi-mac is an open-source toolkit that helps developers manage AI agent infrastructure across multiple projects.

The Problem: Claude Code, Cursor, and Codex each need their own config files (CLAUDE.md, .cursorrules, AGENTS.md). Managing these across 10+ projects becomes chaos.

The Solution: Single Source of Truth (.agent/MAIN.md) + visual dashboard + automation scripts.

---

⚡ Quick Start

StatusLine (shows context usage in Claude Code)

curl -fsSL https://raw.githubusercontent.com/Humanji7/optimi-mac/main/.agent/scripts/install-statusline.sh | bash

Health Dashboard

git clone https://github.com/Humanji7/optimi-mac.git
cd optimi-mac
npx -y http-server .agent/dashboard -p 8889 -o

---

✨ Features

Feature	Description
🏥 Health Dashboard	Web UI showing all projects status, active hooks, uncommitted changes
🏗️ Setup AI	One-click .agent/ infrastructure for any project
📊 StatusLine	Real-time context usage (%) with color alerts in Claude Code
🌙 Night Watch	Automated batch refactoring with dry-run preview
🧠 Triage	Generates surgical fix prompts for broken projects
📋 GUPP	Anti-crash protocols for reliable AI coding sessions
📝 Living Memory	Error Journal for learning from human-agent collaboration failures

---

📦 Installation

Option 1: Clone (Full Features)

git clone https://github.com/Humanji7/optimi-mac.git ~/projects/optimi-mac

Option 2: StatusLine Only

curl -fsSL https://raw.githubusercontent.com/Humanji7/optimi-mac/main/.agent/scripts/install-statusline.sh | bash

---

🛠 Usage

Health Dashboard

# Start dashboard
cd ~/projects/optimi-mac
npx -y http-server .agent/dashboard -p 8889 -o

# Refresh data
bash .agent/scripts/projects-health-check.sh

Setup AI Infrastructure (for a new project)

bash ~/projects/optimi-mac/.agent/scripts/setup-ai-infrastructure.sh ~/projects/YOUR_PROJECT

# Dry run (preview)
bash ~/projects/optimi-mac/.agent/scripts/setup-ai-infrastructure.sh --dry-run ~/projects/YOUR_PROJECT

This creates:

your_project/
├── .agent/
│   ├── MAIN.md        # Single Source of Truth
│   └── workflows/
├── CLAUDE.md          # → redirect to .agent/MAIN.md
├── AGENTS.md          # → redirect
└── .cursorrules       # → redirect

Night Watch (Automated Refactoring)

# Preview what would be refactored
bash .agent/scripts/night-watch.sh --dry-run

# Run on specific projects
bash .agent/scripts/night-watch.sh project1 project2

---

📁 Project Structure

optimi-mac/
├── .agent/
│   ├── dashboard/         # Web UI
│   ├── scripts/           # Automation scripts
│   ├── workflows/         # Claude Code slash commands
│   ├── templates/         # .agent/ scaffolding
│   └── prompts/           # AI prompt templates
└── CLAUDE.md              # GUPP protocol

---

🔧 Scripts Reference

Script	Purpose
projects-health-check.sh	Scan ~/projects and generate health report
setup-ai-infrastructure.sh	Create .agent/ + redirect files
install-statusline.sh	Install context usage indicator
night-watch.sh	Batch refactoring automation
generate-triage-prompt.sh	Create surgical fix prompts
log-error.sh	Log errors to Living Memory journal

---

🎮 Workflows (Claude Code Slash Commands)

Copy .agent/workflows/ to your project and use:

Command	Description
/anti-crash-rules	GUPP anti-crash protocols
/decompose	Break task into atomic molecules
/setup-ai-pipeline	Create .agent/ from scratch
/triage-project	Auto-fix dashboard issues

---

🤝 Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing)
5. Open Pull Request

---

📄 License

MIT License — see LICENSE for details.

---

Made with 🧠 for AI-first developers