Alistar AL Development

Alistar AL Development is a VS Code extension that syncs GitHub Copilot instructions, prompts, and agents from a centralized team repository to your local development environment. Keep your entire team aligned with shared AI coding practices without manual file copying.

Features

• Centralized Management: Maintain GitHub Copilot configuration files in a single repository
• One-Click Sync: Pull the latest instructions, prompts, and agents with a simple command
• Team Consistency: Ensure all developers use the same AI coding guidelines
• Flexible Configuration: Point to any public GitHub repository and folder
• Flat Structure: Syncs all files directly to the prompts folder (no subfolders)
• Detailed Logging: View sync progress and results in the Output panel

Usage

1. Configure the Source Repository (optional - defaults to fvet/Alistar_AI)

   • Open VS Code Settings (Ctrl+, or Cmd+,)
   • Search for "Alistar"
   • Set the repository owner, name, branch, and source path

2. Sync Files

   • Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
   • Run: Alistar: Sync Copilot
   • Wait for the sync to complete

3. View Details

   • Check the "Alistar" Output channel for detailed sync logs
   • See which files were synced and any errors

Configuration

Target Location

Files are synced to:

• Windows: %APPDATA%\Code\User\prompts\
• macOS: ~/Library/Application Support/Code/User/prompts/
• Linux: ~/.config/Code/User/prompts/

All files from the source repository folder are synced directly to the prompts folder (no subfolders). For example:

• .github/my-agent.agent.md → prompts/my-agent.agent.md
• .github/my-prompt.prompt.md → prompts/my-prompt.prompt.md

Setting Up Your Team Repository

1. Create a public GitHub repository (e.g., myorg/copilot-config)
2. Add a .github folder with all your Copilot files (no subfolders needed)
3. Add your .agent.md, .prompt.md, and .instructions.md files directly in the .github folder
4. Configure Alistar to point to your repository

Example structure:

myorg/copilot-config/
└── .github/
    ├── my-agent.agent.md
    ├── my-prompt.prompt.md
    └── my-instructions.instructions.md

GitHub Rate Limits

GitHub's API allows 60 requests per hour for unauthenticated requests. For teams with large repositories or frequent syncs:

1. Create a GitHub Personal Access Token
2. No special scopes needed for public repositories
3. Add the token to alistar.githubToken setting

Requirements

• VS Code 1.107.0 or higher
• Internet connection to access GitHub

Known Issues

• Files are always overwritten on sync (no merge or conflict resolution)
• Deleted files in the repository are not removed locally
• Private repositories require a GitHub token

Release Notes

0.0.1

Initial release of Alistar:

• Sync GitHub Copilot files from a central repository
• Configurable source repository and path
• Detailed logging to Output channel
• Progress notifications

Contributing

Found a bug or have a feature request? Please open an issue on the GitHub repository.

License

See LICENSE file for details.