Opencode Agent Manager

Centralized platform for managing AI agents and skills compatible with OpenCode format.

Features

• Agent Management — Full CRUD with OpenCode YAML configuration (mode, temperature, permissions)
• Skill Management — Define, categorize, and assign skills to agents
• Project System — Create projects with their own OpenCode directory paths
• OpenCode Import — Scan directories and import agents/skills from .md files
• OpenCode Export — Select and write agents/skills as .md files to any directory
• Dashboard — Overview with agent/skill/project counts and Top 5 rankings
• Editable OpenCode Content — Customize agent instructions directly with syntax-colored editor
• Export Tracking — Automatically counts how often each agent is exported

Screenshots

Dashboard	Agent Configuration	Import

Tech Stack

Layer	Technology
Backend	NestJS + TypeScript + Prisma
Frontend	Next.js 16 + React 19 + Tailwind
Database	PostgreSQL
State	Zustand

Prerequisites

• Node.js >= 18
• PostgreSQL (or use the provided docker-compose.yml)

Quick Start

Automated install

git clone https://github.com/madpowah/Opencode-Agent-Manager.git
cd Opencode-Agent-Manager
./install.sh    # installs everything and builds
./start.sh      # launches backend + frontend

Manual step-by-step

git clone https://github.com/madpowah/Opencode-Agent-Manager.git
cd Opencode-Agent-Manager

# Start PostgreSQL (optional — use your own or Docker)
docker compose up -d

# Backend
cd backend
npm install
cp .env.example .env      # edit DATABASE_URL if needed
npx prisma generate
npx prisma migrate dev
npm run build && npm run start

# Frontend (new terminal)
cd ../frontend
npm install
npm run build && npm run start

• Frontend: http://localhost:3000
• Backend API: http://localhost:3001/api

Configuration

1. Open the app at http://localhost:3000
2. Click Settings (gear icon) to set your OpenCode directory (default: /home/user/.config/opencode)
3. Create a Project in the Projects tab with a custom directory path
4. Use the project selector in the sidebar to switch between Global and project-specific directories

Import / Export Flow

1. Select a context in the sidebar (Global or a specific project)
2. Click Import to scan the directory for .md agent/skill files
3. Click Export to write selected agents/skills as .md files to the directory
4. The directory path is automatically determined by the selected context

OpenCode Directory Structure

.opencode/
├── agents/
│   ├── my-agent.md          # Agent definition (YAML frontmatter + instructions)
│   └── another-agent.md
└── skills/
    ├── my-skill/
    │   └── SKILL.md         # Skill definition (YAML frontmatter + instructions)
    └── another-skill/
        └── SKILL.md

Documentation

• frontend/USAGE.md — Full usage guide
• backend/openapi.yaml — API reference

License

MIT License — see LICENSE