agent-dj 0.1.2 → 0.1.3

package/README.md

@@ -1,23 +1,49 @@
 # Agent DJ
 
-Self-hosted AI agent platform with a beautiful dashboard. One command install, multi-agent orchestration, RAG, MCP support.
+**Self-hosted AI agent platform. One command, beautiful dashboard, 8 providers, multi-agent orchestration.**
+
+```bash
+npx agent-dj@latest
+```
+
+Bring your own API key. Supports Claude, GPT, Gemini, Grok, Mistral, DeepSeek, Groq, and Ollama (local/free). No cloud accounts, no sign-ups — runs entirely on your machine. Apache-2.0.
+
+**What you get:**
+
+- Beautiful web dashboard at localhost
+- 8 LLM providers — Claude, GPT-4o, Gemini, Grok, Mistral, DeepSeek, Groq, Ollama
+- Multi-agent system — orchestrator auto-routes to specialist agents (Coder, Researcher, Writer, System, RAG)
+- Knowledge base with RAG — upload documents, agents search them automatically
+- MCP support — connect external tools (GitHub, Slack, databases, etc.)
+- Skills — create custom instructions that shape how all agents behave
+- Memory — agents remember context across conversations
+- Full audit log of every action
+- Permission system — control what agents can do
+
+**BYOK (Bring Your Own Key).** Your keys, your data, your machine. Nothing leaves localhost unless you tell it to.
+
+---
 
 ## Quick Start
 
 ```bash
-# Install globally
-npm install -g agent-dj
-
-# Or run directly with npx
-npx agent-dj
+npx agent-dj@latest
 ```
 
-On first run, the setup wizard walks you through choosing a provider and entering your API key. Then the dashboard opens automatically.
+On first run, the setup wizard walks you through choosing a provider and entering your API key. Then the dashboard opens automatically at **http://localhost:3456**.
+
+You can also install globally:
+
+```bash
+npm install -g agent-dj
+agent-dj
+```
 
 ## Features
 
 - Multi-agent orchestration (Coder, Researcher, Writer, System, RAG)
 - Chat interface with conversation history
+- Skills system (custom instructions for all agents, works across all providers)
 - Memory system (user context, feedback, projects)
 - Knowledge base with RAG (document upload, hybrid search)
 - MCP (Model Context Protocol) server support
@@ -32,6 +58,9 @@ On first run, the setup wizard walks you through choosing a provider and enterin
 | **Anthropic** | API key or OAuth token | Claude Opus, Sonnet, Haiku |
 | **OpenAI** | API key | GPT-4o, o1, o3-mini |
 | **Google** | API key | Gemini 2.0 Flash/Pro |
+| **xAI** | API key | Grok-3 |
+| **Mistral** | API key | Mistral Large |
+| **DeepSeek** | API key | DeepSeek Chat |
 | **Groq** | API key | Llama 3.3 70B (fast, free tier) |
 | **Ollama** | None | Local models, free |
 

package/dist/cli.js

@@ -670,6 +670,17 @@ CREATE TABLE IF NOT EXISTS permission_cache (
   created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
 );
 CREATE INDEX IF NOT EXISTS idx_perm_session ON permission_cache(session_id, resource_type, resource_path);
+
+-- Skills
+CREATE TABLE IF NOT EXISTS skills (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  content TEXT NOT NULL,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
+  updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
+);
 `;
   }
 });
@@ -780,6 +791,37 @@ function getAuditLog(limit = 100, offset = 0) {
 function clearAuditLog() {
   getDb().prepare("DELETE FROM audit_log").run();
 }
+function createSkill(params) {
+  const id = randomUUID();
+  getDb().prepare("INSERT INTO skills (id, name, description, content) VALUES (?, ?, ?, ?)").run(id, params.name, params.description, params.content);
+  return id;
+}
+function listSkills() {
+  return getDb().prepare("SELECT * FROM skills ORDER BY created_at DESC").all();
+}
+function getSkill(id) {
+  return getDb().prepare("SELECT * FROM skills WHERE id = ?").get(id);
+}
+function updateSkill(id, updates) {
+  const sets = [];
+  const values2 = [];
+  for (const [key, val] of Object.entries(updates)) {
+    if (val !== void 0) {
+      sets.push(`${key} = ?`);
+      values2.push(val);
+    }
+  }
+  if (sets.length === 0) return;
+  sets.push("updated_at = datetime('now')");
+  values2.push(id);
+  getDb().prepare(`UPDATE skills SET ${sets.join(", ")} WHERE id = ?`).run(...values2);
+}
+function deleteSkill(id) {
+  getDb().prepare("DELETE FROM skills WHERE id = ?").run(id);
+}
+function getEnabledSkills() {
+  return getDb().prepare("SELECT * FROM skills WHERE enabled = 1 ORDER BY created_at ASC").all();
+}
 var db;
 var init_db = __esm({
   "src/db/index.ts"() {
@@ -273408,8 +273450,21 @@ function routeMessage(message) {
   }
   return "orchestrator";
 }
+function buildSkillsSection() {
+  const skills = getEnabledSkills();
+  if (skills.length === 0) return "";
+  const skillsText = skills.map((s) => `### ${s.name}
+${s.content}`).join("\n\n");
+  return `
+
+## Custom Skills & Instructions
+Follow these additional instructions:
+
+${skillsText}`;
+}
 function buildSystemPrompt() {
   let prompt = BASE_SYSTEM_PROMPT;
+  prompt += buildSkillsSection();
   const mcpSummary = getMcpToolSummary();
   if (mcpSummary) {
     prompt += `
@@ -273638,6 +273693,7 @@ async function delegateToAgent(targetAgent, messages, lastMessage, model, provid
     const memoryCtx = memory.buildContext(lastMessage);
     const knowledgeCtx = buildKnowledgeContext(lastMessage);
     let augmentedSystem = agentDef.systemPrompt;
+    augmentedSystem += buildSkillsSection();
     const mcpSummary = getMcpToolSummary();
     if (mcpSummary) augmentedSystem += `
 
@@ -273728,6 +273784,7 @@ async function delegateToAgentStreaming(targetAgent, messages, lastMessage, mode
     const memoryCtx = memory.buildContext(lastMessage);
     const knowledgeCtx = buildKnowledgeContext(lastMessage);
     let augmentedSystem = agentDef.systemPrompt;
+    augmentedSystem += buildSkillsSection();
     const mcpSummary = getMcpToolSummary();
     if (mcpSummary) augmentedSystem += `
 
@@ -274724,12 +274781,66 @@ var init_apps = __esm({
   }
 });
 
+// src/server/routes/skills.ts
+import { Hono as Hono9 } from "hono";
+var skillsRoutes;
+var init_skills = __esm({
+  "src/server/routes/skills.ts"() {
+    "use strict";
+    init_db();
+    skillsRoutes = new Hono9();
+    skillsRoutes.get("/", (c) => {
+      return c.json(listSkills());
+    });
+    skillsRoutes.get("/:id", (c) => {
+      const skill = getSkill(c.req.param("id"));
+      if (!skill) return c.json({ error: "Skill not found" }, 404);
+      return c.json(skill);
+    });
+    skillsRoutes.post("/", async (c) => {
+      const body = await c.req.json();
+      const { name, description, content } = body;
+      if (!name || !content) {
+        return c.json({ error: "name and content are required" }, 400);
+      }
+      const id = createSkill({ name, description: description || "", content });
+      return c.json({ id }, 201);
+    });
+    skillsRoutes.put("/:id", async (c) => {
+      const id = c.req.param("id");
+      const skill = getSkill(id);
+      if (!skill) return c.json({ error: "Skill not found" }, 404);
+      const body = await c.req.json();
+      const updates = {};
+      if (body.name !== void 0) updates.name = body.name;
+      if (body.description !== void 0) updates.description = body.description;
+      if (body.content !== void 0) updates.content = body.content;
+      if (body.enabled !== void 0) updates.enabled = body.enabled;
+      updateSkill(id, updates);
+      return c.json({ ok: true });
+    });
+    skillsRoutes.delete("/:id", (c) => {
+      const id = c.req.param("id");
+      deleteSkill(id);
+      return c.json({ ok: true });
+    });
+    skillsRoutes.patch("/:id/toggle", (c) => {
+      const id = c.req.param("id");
+      const skill = getSkill(id);
+      if (!skill) return c.json({ error: "Skill not found" }, 404);
+      updateSkill(id, { enabled: skill.enabled ? 0 : 1 });
+      const updated = getSkill(id);
+      return c.json(updated);
+    });
+  }
+});
+
 // src/server/index.ts
 var server_exports = {};
 __export(server_exports, {
   createApp: () => createApp
 });
-import { Hono as Hono9 } from "hono";
+import { Hono as Hono10 } from "hono";
 import { cors } from "hono/cors";
 import { serveStatic } from "@hono/node-server/serve-static";
 import { fileURLToPath } from "url";
@@ -274750,9 +274861,9 @@ function findWebDist() {
   return candidates[0];
 }
 function createApp() {
-  const app = new Hono9();
+  const app = new Hono10();
   app.use("*", cors());
-  const SILENT_ROUTES = ["/api/tasks", "/api/settings", "/api/conversations", "/api/health", "/api/memory", "/api/mcp", "/api/agents", "/api/knowledge", "/api/apps"];
+  const SILENT_ROUTES = ["/api/tasks", "/api/settings", "/api/conversations", "/api/health", "/api/memory", "/api/mcp", "/api/agents", "/api/knowledge", "/api/apps", "/api/skills"];
   app.use("/api/*", async (c, next) => {
     const path = c.req.path;
     const method = c.req.method;
@@ -274772,6 +274883,7 @@ function createApp() {
   app.route("/api/settings", settingsRoutes);
   app.route("/api/memory", memoryRoutes);
   app.route("/api/apps", appsRoutes);
+  app.route("/api/skills", skillsRoutes);
   app.get("/api/health", (c) => {
     return c.json({
       status: "ok",
@@ -274795,6 +274907,7 @@ var init_server = __esm({
     init_settings();
     init_memory2();
     init_apps();
+    init_skills();
     __filename = fileURLToPath(import.meta.url);
     __dirname = dirname(__filename);
     WEB_DIST = findWebDist();

package/dist/server.js

@@ -270567,7 +270567,7 @@ var require_lib6 = __commonJS({
 });
 
 // src/server/index.ts
-import { Hono as Hono9 } from "hono";
+import { Hono as Hono10 } from "hono";
 import { cors } from "hono/cors";
 import { serveStatic } from "@hono/node-server/serve-static";
 import { fileURLToPath } from "url";
@@ -270729,6 +270729,37 @@ function getAuditLog(limit = 100, offset = 0) {
 function clearAuditLog() {
   getDb().prepare("DELETE FROM audit_log").run();
 }
+function createSkill(params) {
+  const id = randomUUID();
+  getDb().prepare("INSERT INTO skills (id, name, description, content) VALUES (?, ?, ?, ?)").run(id, params.name, params.description, params.content);
+  return id;
+}
+function listSkills() {
+  return getDb().prepare("SELECT * FROM skills ORDER BY created_at DESC").all();
+}
+function getSkill(id) {
+  return getDb().prepare("SELECT * FROM skills WHERE id = ?").get(id);
+}
+function updateSkill(id, updates) {
+  const sets = [];
+  const values2 = [];
+  for (const [key, val] of Object.entries(updates)) {
+    if (val !== void 0) {
+      sets.push(`${key} = ?`);
+      values2.push(val);
+    }
+  }
+  if (sets.length === 0) return;
+  sets.push("updated_at = datetime('now')");
+  values2.push(id);
+  getDb().prepare(`UPDATE skills SET ${sets.join(", ")} WHERE id = ?`).run(...values2);
+}
+function deleteSkill(id) {
+  getDb().prepare("DELETE FROM skills WHERE id = ?").run(id);
+}
+function getEnabledSkills() {
+  return getDb().prepare("SELECT * FROM skills WHERE enabled = 1 ORDER BY created_at ASC").all();
+}
 
 // src/config/index.ts
 import { readFileSync, writeFileSync, mkdirSync, existsSync, cpSync } from "fs";
@@ -272661,8 +272692,21 @@ You have direct access to tools including web search, file operations, knowledge
 - When listing options, briefly note pros/cons
 - End with a clear next step or action item when relevant
 - ALWAYS try to use your tools to answer questions \u2014 don't just give generic advice`;
+function buildSkillsSection() {
+  const skills = getEnabledSkills();
+  if (skills.length === 0) return "";
+  const skillsText = skills.map((s) => `### ${s.name}
+${s.content}`).join("\n\n");
+  return `
+
+## Custom Skills & Instructions
+Follow these additional instructions:
+
+${skillsText}`;
+}
 function buildSystemPrompt() {
   let prompt = BASE_SYSTEM_PROMPT;
+  prompt += buildSkillsSection();
   const mcpSummary = getMcpToolSummary();
   if (mcpSummary) {
     prompt += `
@@ -272899,6 +272943,7 @@ async function delegateToAgent(targetAgent, messages, lastMessage, model, provid
     const memoryCtx = memory.buildContext(lastMessage);
     const knowledgeCtx = buildKnowledgeContext(lastMessage);
     let augmentedSystem = agentDef.systemPrompt;
+    augmentedSystem += buildSkillsSection();
     const mcpSummary = getMcpToolSummary();
     if (mcpSummary) augmentedSystem += `
 
@@ -272989,6 +273034,7 @@ async function delegateToAgentStreaming(targetAgent, messages, lastMessage, mode
     const memoryCtx = memory.buildContext(lastMessage);
     const knowledgeCtx = buildKnowledgeContext(lastMessage);
     let augmentedSystem = agentDef.systemPrompt;
+    augmentedSystem += buildSkillsSection();
     const mcpSummary = getMcpToolSummary();
     if (mcpSummary) augmentedSystem += `
 
@@ -273966,6 +274012,53 @@ appsRoutes.post("/refresh", async (c) => {
   return c.json({ status: "ok", count: cachedCatalog.apps.length });
 });
 
+// src/server/routes/skills.ts
+import { Hono as Hono9 } from "hono";
+var skillsRoutes = new Hono9();
+skillsRoutes.get("/", (c) => {
+  return c.json(listSkills());
+});
+skillsRoutes.get("/:id", (c) => {
+  const skill = getSkill(c.req.param("id"));
+  if (!skill) return c.json({ error: "Skill not found" }, 404);
+  return c.json(skill);
+});
+skillsRoutes.post("/", async (c) => {
+  const body = await c.req.json();
+  const { name, description, content } = body;
+  if (!name || !content) {
+    return c.json({ error: "name and content are required" }, 400);
+  }
+  const id = createSkill({ name, description: description || "", content });
+  return c.json({ id }, 201);
+});
+skillsRoutes.put("/:id", async (c) => {
+  const id = c.req.param("id");
+  const skill = getSkill(id);
+  if (!skill) return c.json({ error: "Skill not found" }, 404);
+  const body = await c.req.json();
+  const updates = {};
+  if (body.name !== void 0) updates.name = body.name;
+  if (body.description !== void 0) updates.description = body.description;
+  if (body.content !== void 0) updates.content = body.content;
+  if (body.enabled !== void 0) updates.enabled = body.enabled;
+  updateSkill(id, updates);
+  return c.json({ ok: true });
+});
+skillsRoutes.delete("/:id", (c) => {
+  const id = c.req.param("id");
+  deleteSkill(id);
+  return c.json({ ok: true });
+});
+skillsRoutes.patch("/:id/toggle", (c) => {
+  const id = c.req.param("id");
+  const skill = getSkill(id);
+  if (!skill) return c.json({ error: "Skill not found" }, 404);
+  updateSkill(id, { enabled: skill.enabled ? 0 : 1 });
+  const updated = getSkill(id);
+  return c.json(updated);
+});
+
 // src/server/index.ts
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
@@ -273985,9 +274078,9 @@ function findWebDist() {
 }
 var WEB_DIST = findWebDist();
 function createApp() {
-  const app = new Hono9();
+  const app = new Hono10();
   app.use("*", cors());
-  const SILENT_ROUTES = ["/api/tasks", "/api/settings", "/api/conversations", "/api/health", "/api/memory", "/api/mcp", "/api/agents", "/api/knowledge", "/api/apps"];
+  const SILENT_ROUTES = ["/api/tasks", "/api/settings", "/api/conversations", "/api/health", "/api/memory", "/api/mcp", "/api/agents", "/api/knowledge", "/api/apps", "/api/skills"];
   app.use("/api/*", async (c, next) => {
     const path = c.req.path;
     const method = c.req.method;
@@ -274007,6 +274100,7 @@ function createApp() {
   app.route("/api/settings", settingsRoutes);
   app.route("/api/memory", memoryRoutes);
   app.route("/api/apps", appsRoutes);
+  app.route("/api/skills", skillsRoutes);
   app.get("/api/health", (c) => {
     return c.json({
       status: "ok",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dj",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Self-hosted AI agent platform with beautiful dashboard. One command install, multi-agent orchestration, RAG, MCP support.",
   "type": "module",
   "bin": {