Mastra Project Management Agent

A powerful template that combines the capabilities of Mastra with CopilotKit for advanced conversational project management, intelligent task prioritization, and AI-powered reporting.

Overview

This project enables AI agents to assist with project management workflows using the Mastra framework. It provides tools for task prioritization, weekly status report generation, and contextual project insights, all orchestrated through Mastra's agent system.

Features

• Task Prioritization: Prioritize tasks using Eisenhower Matrix or RICE scoring
• Status Report Generation: Automatically generate concise weekly status reports (summary, highlights, blockers, next week)
• Project State Memory: Maintains working memory of tasks, OKRs, and prior status reports
• Weather Lookup Tool: Fetch current weather for any city (demo of external tool integration)
• AI-Powered Interactions: Leverage OpenAI models for intelligent project management assistance

Installation

Prerequisites

• Node.js (v20+)
• pnpm
• OpenAI API access

Setup

1. Clone the repository:

   git clone https://github.com/mastra-ai/template-project-management-agent.git
   cd template-project-management-agent
   

2. Install dependencies:

   pnpm install
   

3. Create a .env file with your API keys:

   OPENAI_API_KEY=your_openai_key
   

Usage

Running the agent development server

pnpm run dev:agent

This will start the Mastra development server, giving you access to the integrated project management agent.

Running the Next.js development server

pnpm run dev:ui

This will start the Next.js development server, giving you access to the UI.

Architecture

Core Components

1. Mastra Agent

   • Project management agent using OpenAI's model
   • Maintains working memory for project state
   • Integrates all tools into a unified experience

2. Mastra Tools

   • taskPrioritizationTool: Prioritizes tasks using Eisenhower or RICE
   • generateStatusReportTool: Generates structured weekly status reports
   • weatherTool: Fetches weather data for a given city (demo)

Flow Diagram

User Query → Mastra Agent → Project Management Tools → Data/Results → Agent Response

Configuration

The project can be configured through the .env file and by modifying the agent instructions in src/mastra/agents/index.ts.

Technologies Used

• Mastra: AI agent framework
• AG-UI: Agent User Interaction protocol
• CopilotKit: React AI interface components
• Next.js: React framework
• Zod: Schema validation

Next Steps

Some enhancements you can try:

1. Experiment with custom tools and agent instructions
2. Try building additional client interfaces
3. Explore more complex agent behaviors and state schemas
4. Build your own conversational project management application