"Blessed are the code smiths, for they shall inherit productivity."

A divine plugin for OpenCode that brings blessed multi-agent orchestration to your development workflow.

AgentBlessed transforms your OpenCode experience into a blessed workflow where you have full visibility and control over your AI agents. Track session activity, receive notifications when work completes, and gain insights into your development process.

Key Blessings:

• 🎯 Activity Tracking: Monitor all tool invocations and file changes
• 🔔 Smart Notifications: Get notified when sessions complete or encounter errors
• 📊 Session Statistics: Track productivity metrics in real-time
• 🛡️ Permission Awareness: Never miss an approval request
• 🎮 Custom Commands: Built-in /bless and /stats commands

# Clone into your project
git clone https://github.com/yourusername/opencode-agentblessed.git .opencode/plugins/agentblessed

# Or create manually
mkdir -p .opencode/plugins/agentblessed
curl -o .opencode/plugins/agentblessed/index.ts https://raw.githubusercontent.com/yourusername/opencode-agentblessed/main/index.ts

# Create global plugin directory
mkdir -p ~/.config/opencode/plugins/agentblessed

# Copy the plugin file
cp index.ts ~/.config/opencode/plugins/agentblessed/

npm install -g opencode-agentblessed

Then add to your ~/.config/opencode/opencode.json:

{
  "plugin": ["opencode-agentblessed"]
}

Once installed, AgentBlessed works automatically in the background:

• ✅ Session Tracking: Every session is blessed and monitored
• ✅ Tool Logging: See what tools are being invoked in real-time
• ✅ File Change Tracking: Know which files are being modified
• ✅ Notifications: Get system notifications when work completes
• ✅ Error Alerts: Immediate notification when something goes wrong

AgentBlessed adds these blessed commands to OpenCode:

/bless

Get a random coding blessing for inspiration:

🙏 A BLESSING FOR YOUR CODE 🙏

   May your functions be pure and your side effects minimal.

/stats

See your blessed productivity metrics:

📊 AGENTBLESSED STATISTICS
   Active Sessions: 3
   Total Tools Invoked: 47
   Unique Files Modified: 12

When you start OpenCode with AgentBlessed installed:

$ opencode
🙏 AgentBlessed initialized
   Project: my-awesome-project
   Directory: /home/dev/projects/my-awesome-project
   Working Tree: /home/dev/projects/my-awesome-project
   May your code be blessed!

# When you start working
✨ Blessed session created: a1b2c3d4...

# As tools are invoked
📝 Blessed write: src/components/Button.tsx
✅ write completed successfully
⚡ Blessed command: npm run build
🤖 Blessed agent invoked: Find all API endpoints...

# When session completes
🙏 Session completed in 5m 23s
   Tools invoked: 12
   Files modified: 4
🔔 [System Notification] Session completed

AgentBlessed works out of the box with sensible defaults. No configuration required!

Create .opencode/agentblessed.json:

{
  "agentblessed": {
    "notifications": {
      "enabled": true,
      "sound": true,
      "onComplete": true,
      "onError": true
    },
    "logging": {
      "level": "info",
      "showTimestamps": true
    },
    "features": {
      "trackFileChanges": true,
      "trackToolUsage": true,
      "showBlessingOnComplete": false
    }
  }
}

Every session is monitored from creation to completion:

• Created: Session starts, timer begins
• Updated: Ongoing activity tracked
• Idle: Work completed, stats calculated
• Error: Immediate error detection

See exactly what tools are being used:

Know what's being modified:

• Tracks unique files modified per session
• Prevents duplicate entries
• Shows final count on completion

Cross-platform notifications:

• ✅ macOS: Native notifications with sound
• ✅ Linux: notify-send support
• ✅ Windows: PowerShell notifications
• ✅ Fallback: Console logging

Never miss an approval:

⏳ Awaiting your blessing...
   Tool: bash
   Action: execute
   Press 'a' to allow, 'd' to deny

AgentBlessed Plugin
├── Session Lifecycle Hooks
│   ├── session.created
│   ├── session.updated
│   ├── session.idle
│   └── session.error
├── Tool Execution Hooks
│   ├── tool.execute.before
│   └── tool.execute.after
├── File Operation Hooks
│   ├── file.edited
│   └── file.watcher.updated
├── Permission Hooks
│   ├── permission.asked
│   └── permission.replied
├── TUI Hooks
│   ├── tui.command.execute
│   └── tui.toast.show
└── Helper Functions
    ├── sendBlessedNotification
    ├── showBlessing
    └── showStats

• OpenCode installed
• TypeScript knowledge (optional, for modifications)
• Node.js and npm (for type definitions)

# 1. Clone the repository
git clone https://github.com/yourusername/opencode-agentblessed.git
cd opencode-agentblessed

# 2. Install TypeScript definitions (optional)
npm install --save-dev @opencode-ai/plugin

# 3. Link to your test project
ln -s $(pwd) /path/to/your/project/.opencode/plugins/agentblessed

# 4. Run OpenCode in debug mode
opencode -d

AgentBlessed/
├── index.ts              # Main plugin file
├── README.md             # This file
├── package.json          # NPM metadata (optional)
├── tsconfig.json         # TypeScript config (optional)
└── docs/                 # Documentation
    ├── API.md
    └── HOOKS.md

AgentBlessed uses these OpenCode hooks:

Want to extend AgentBlessed? Here are some ideas:

// Add a new hook
"session.compacted": async (input, output) => {
  console.log("📦 Session compacted to save tokens")
},

// Add cost tracking
"tool.execute.after": async (input, output) => {
  // Estimate token usage
  // Track costs per session
  // Alert if approaching budget
}

• Plugin loads without errors
• Session creation shows blessing message
• Tool execution shows appropriate icons
• File modifications are tracked
• Session completion shows stats
• Notifications appear (if supported)
• /bless command works
• /stats command works
• Permission requests are highlighted

Run OpenCode with debug flag to see detailed logs:

opencode -d

# Build
npm run build

# Publish
npm publish

Users can install via:

git clone https://github.com/yourusername/opencode-agentblessed.git \
  .opencode/plugins/agentblessed

Contributions are blessed! Here's how:

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

• Add more blessings to the collection
• Create dashboard visualization
• Add cost tracking features
• Support for custom notification sounds
• Integration with external analytics
• More blessed commands
• Theme support (colors, icons)

# Check file location
ls -la .opencode/plugins/agentblessed/index.ts

# Verify syntax
npx tsc --noEmit index.ts

# Run with debug
opencode -d

• macOS: Ensure Terminal has notification permissions
• Linux: Install notify-send (sudo apt install libnotify-bin)
• Windows: PowerShell execution policy may need adjustment

# Install types
npm install --save-dev @opencode-ai/plugin

# Or add to package.json in config directory
cat > ~/.config/opencode/package.json << 'EOF'
{
  "dependencies": {
    "@opencode-ai/plugin": "latest"
  }
}
EOF

MIT License - see LICENSE file

• OpenCode Team: For the amazing platform
• Oh My OpenCode: Inspiration for multi-agent patterns
• Community: For feedback and contributions

• v0.2.0: Dashboard overlay (Ctrl+B)
• v0.3.0: Cost tracking and budget alerts
• v0.4.0: Smart agent routing
• v0.5.0: Agent marketplace integration
• v1.0.0: Full multi-agent orchestration

• 🐛 Bug Reports: GitHub Issues
• 💡 Feature Requests: GitHub Discussions
• 💬 Community: OpenCode Discord

May your code be blessed and your bugs be few. 🙏