Github Agent

An agentic system designed to streamline the collaboration workflow of development teams on GitHub. Key features:

• Automated reminders for development blockers (code reviews, merge conflicts, etc)
• Pull request monitoring and review notifications
• Project progress tracking with work summaries

Project Structure

Apps

• agent: Core automation service using Mastra framework
• discord-bot: Discord integration service for notification

Packages

• eslint-config: Shared ESLint configurations
• typescript-config: Shared TypeScript configurations

Getting Started

Prerequisites

• Node.js (v20.0+)
• pnpm (v8.0+)
• Discord Bot Token (for discord-bot app)
• GitHub Token (for agent app)

Setup

1. Clone the repository:

git clone git@github.com:dwarvesf/github-agent.git
cd github-agent

2. Install dependencies:

pnpm install

3. Copy environment files:

cp apps/agent/.env.example apps/agent/.env
cp apps/discord-bot/.env.example apps/discord-bot/.env

4. Configure environment variables:

• Set up GitHub tokens and configurations in apps/agent/.env
• Configure Discord bot settings in apps/discord-bot/.env

5. Start development:

pnpm dev

Development

• pnpm dev: Start all applications in development mode
• pnpm build: Build all applications and packages
• pnpm lint: Run linting
• pnpm format: Format code with Prettier

Contributing

We welcome contributions! Please read our Contributing Guide for details on our code of conduct and the process for submitting pull requests.