---
slug: "aegis"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/FixingPixels/aegis-github-integration-test@main/README.md"
repo: "https://github.com/FixingPixels/aegis-github-integration-test"
source_file: "README.md"
branch: "main"
---
# Aegis GitHub Integration Test

This repository is a test environment for exploring the integration of the [Aegis Framework](https://github.com/codeium/aegis) with GitHub features using the Model Context Protocol (MCP) server.

## Overview

The goal of this project is to evaluate how GitHub's features can enhance the Aegis Framework while maintaining its text-based simplicity. We're specifically exploring:

- GitHub Issues for task/decision/session tracking
- GitHub Projects for workflow management
- GitHub MCP server for automation
- Integration with AI assistants (Cursor, Windsurf)

## Structure

- `.context/` - Aegis Framework directory
- `.github/` - GitHub-specific configurations
  - `ISSUE_TEMPLATE/` - Templates for tasks, decisions, and sessions
  - `workflows/` - GitHub Actions configurations

## Getting Started

1. Clone this repository
2. Set up your AI assistant with MCP capabilities
3. Explore the `.context` directory for Aegis framework files
4. Check GitHub Issues for active tasks and decisions

## Testing MCP Integration

This repository serves as a testbed for MCP server integration. Key areas:

1. Task Management
   - Creating tasks via AI assistants
   - Transitioning task states
   - Updating task content

2. Decision Recording
   - Creating decision records
   - Linking decisions to tasks
   - Tracking decision history

3. Session Management
   - Recording development sessions
   - Tracking progress
   - Documenting decisions

## Contributing

This is a test repository for evaluation purposes. While we welcome observations and feedback, please note that this is not intended for production use.

## License

MIT