DevBar

Your scripts, always one click away.

A powerful macOS Menu Bar application for developers to manage scripts, monitor processes, and automate tasks.

Features • Installation • Usage • Screenshots • Contributing

---

✨ Features

Feature	Description
🚀 Script Management	Create, organize, and execute shell scripts directly from the menu bar
📊 Process Monitoring	Real-time monitoring of running services with live log streaming
⏰ Task Scheduling	Schedule scripts with cron expressions, intervals, or one-time execution
🔌 Port Scanner	Automatically detect and manage listening ports on your machine
🎨 Dashboard View	Full-featured dashboard window for detailed script and schedule management
🔔 Smart Notifications	Desktop notifications for scheduled task completion and failures

---

📦 Installation

Download (Recommended)

1. Download the latest DevBar.dmg from Releases

2. Install — Open the DMG and drag DevBar to Applications:

   

3. First Launch — Handle macOS security warning:

   ⚠️ Since DevBar is not notarized, macOS Gatekeeper will block it on first launch.

   • Double-click DevBar in Applications
   • Click "Cancel" on the security warning
   • Open System Settings → Privacy & Security
   • Find the DevBar message and click "Open Anyway"
   • Click "Open" to confirm

4. Grant Permissions — DevBar requires these permissions:

   Permission	How to Enable	Why It's Needed
   Full Disk Access	System Settings → Privacy & Security → Full Disk Access → Enable DevBar	Run scripts and access logs in any directory
   Notifications	System Settings → Notifications → DevBar → Allow	Receive alerts for scheduled tasks
   Automation (optional)	System Settings → Privacy & Security → Automation	Open apps like VSCode, Terminal

Build from Source

Click to expand build instructions

Prerequisites: Xcode 15.0+, XcodeGen (optional)

# Clone
git clone https://github.com/antlss/devbar.git
cd devbar

# Generate project (if using XcodeGen)
xcodegen generate

# Open and build
open DevBar.xcodeproj
# Press ⌘R to build and run

---

🚀 Usage

Quick Start

1. Click the DevBar icon in your menu bar
2. Add your first script via the popup or Dashboard
3. Run scripts with a single click
4. Schedule recurring tasks with cron, interval, or one-time triggers

Menu Bar Popup

Access everything in one click:

• Scripts — Run any script instantly
• Running Services — Monitor active processes
• Tools — Quick launch VSCode, Docker, Terminal
• Settings — Configure preferences

Dashboard

Open the full Dashboard for advanced features:

• Script Editor — Edit scripts with syntax highlighting
• Schedule Manager — Visual cron builder and scheduling
• Execution History — View logs and past runs
• Settings — Customize appearance and behavior

---

📸 Screenshots

Menu Bar Popup

Scripts	Running Services	Tools	Settings

Dashboard Window

Scripts Management	Execution History

Schedule Editor	Running Services

Schedule Types

Cron Expression	Interval	One-time

Settings

---

💻 Requirements

Requirement	Minimum Version
macOS	13.0 (Ventura)
Xcode	15.0 (for building)

---

⚙️ Configuration

All data is stored in ~/Library/Application Support/DevBar/:

DevBar/
├── scripts.json        # Script configurations
├── schedules.json      # Schedule configurations
├── user_settings.json  # User preferences
└── logs/               # Execution logs

---

🔧 Troubleshooting

App won't open — "DevBar is damaged"

Run this command to remove the quarantine flag:

xattr -cr /Applications/DevBar.app

Scripts not running

1. Ensure Full Disk Access is enabled for DevBar
2. Check the script path and permissions
3. View execution logs in Dashboard → History

Notifications not appearing

Go to System Settings → Notifications → DevBar and enable notifications.

---

📁 Project Structure

DevBar/
├── App/                    # Application entry points
│   ├── DevBarApp.swift
│   ├── AppDelegate.swift
│   └── AppState.swift      # Centralized state management
├── Models/                 # Data models
├── Views/
│   ├── Dashboard/          # Dashboard window views
│   ├── MenuBar/            # Menu bar popup views
│   └── Components/         # Reusable UI components
├── Services/
│   ├── Execution/          # Process spawning & management
│   ├── Scheduling/         # Task scheduling
│   ├── Storage/            # JSON persistence
│   └── System/             # System tools integration
└── Supporting/             # Extensions & utilities

---

🔨 Building for Release

# Archive
xcodebuild -project DevBar.xcodeproj \
  -scheme DevBar \
  -configuration Release \
  -archivePath build/DevBar.xcarchive \
  archive

# Export
xcodebuild -exportArchive \
  -archivePath build/DevBar.xcarchive \
  -exportPath build/release \
  -exportOptionsPlist ExportOptions.plist

---

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

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

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

🙏 Acknowledgments

• Built with SwiftUI and AppKit
• Icons from SF Symbols

---

Made with ❤️ for developers