Skip to content

Finnegan1/AgentManager

Repository files navigation

Agent Manager

A unified MCP (Model Context Protocol) gateway and skill management system. Manage reusable AI knowledge as markdown files, proxy multiple MCP servers through a single endpoint, and configure everything from a native desktop app.

Agent Manager – Dark Mode

What's Inside

This is a Turborepo monorepo using Bun as the package manager.

Apps

  • mcp-gateway — MCP gateway server that serves skills and proxies downstream MCP servers. Supports stdio, SSE, and HTTP streaming transports.
  • agent-manager — Native desktop app (Tauri + React) for managing skills, servers, and monitoring gateway status.
  • docs — Documentation site built with TanStack Start and Fumadocs.

Packages

  • shared-types — Shared TypeScript types (skills, config, server definitions)
  • eslint-config — Shared ESLint configurations
  • typescript-config — Shared tsconfig.json presets

Getting Started

Prerequisites

Install

bun install

Development

Run all apps in dev mode:

turbo dev

Or run a specific app:

turbo dev --filter=mcp-gateway
turbo dev --filter=agent-manager
turbo dev --filter=docs

Build

turbo build

Lint & Format

turbo lint
turbo check-types
bun run format

Architecture

AI Client (e.g. Claude Code)
    ↓ MCP protocol (stdio)
MCP Gateway Server (mcp-gateway)
    ├─ Reads ~/.agent-manager/config.json (hot-reload)
    ├─ Reads ~/.agent-manager/skills/*.md
    ├─ Writes ~/.agent-manager/status.json
    └─ Proxies downstream MCP servers

Desktop App (agent-manager)
    ├─ Reads config, skills, and status files
    ├─ Writes config and skill files via Tauri
    └─ UI for managing everything

Communication between the gateway and the desktop app is file-based — no direct process coupling.

Key Features

  • Skills as Markdown — YAML frontmatter for metadata, plain markdown for content
  • MCP Gateway — Proxy tools, resources, and prompts from multiple downstream servers with automatic namespacing
  • Hot-Reload Config — Changes to ~/.agent-manager/config.json are picked up without restarting the gateway
  • Native Desktop App — Dashboard, server management, skill editor with CodeMirror and Vim keybindings
  • Full Documentation — Searchable docs site covering concepts, architecture, and configuration

About

A unified MCP gateway and skill management system - proxy multiple downstream MCP servers through a single endpoint, manage reusable AI skills as markdown, and configure everything via a native Tauri desktop app.

Topics

Resources

Stars

Watchers

Forks

Contributors