https://github.com/fabioc-aloha/alexagent
Alex Agent Plugin — Install AI cognitive architecture in VS Code without an extension. 84 skills, 7 agents, 22 instructions, MCP tools.
https://github.com/fabioc-aloha/alexagent
agent ai ai-assistant cognitive-architecture copilot github-copilot mcp plugin skills vscode
Last synced: 16 days ago
JSON representation
Alex Agent Plugin — Install AI cognitive architecture in VS Code without an extension. 84 skills, 7 agents, 22 instructions, MCP tools.
- Host: GitHub
- URL: https://github.com/fabioc-aloha/alexagent
- Owner: fabioc-aloha
- License: apache-2.0
- Created: 2026-03-05T18:58:16.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-05T19:40:48.000Z (3 months ago)
- Last Synced: 2026-03-05T21:53:12.654Z (3 months ago)
- Topics: agent, ai, ai-assistant, cognitive-architecture, copilot, github-copilot, mcp, plugin, skills, vscode
- Language: PowerShell
- Size: 664 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🧠 Alex Agent Plugin
> **Install Alex's cognitive architecture in VS Code — no extension needed.**
---
## What Is This?
Alex is an AI cognitive architecture that makes GitHub Copilot smarter. Instead of a generic assistant, you get a partner with **84 domain skills**, **7 specialist agents**, **22 auto-loaded instructions**, **11 prompt workflows**, and **MCP-powered cognitive tools** — all without installing a VS Code extension.
---
## Quick Install
1. **Clone** — `Ctrl+Shift+P` → **Git: Clone** → paste:
```
https://github.com/fabioc-aloha/AlexAgent.git
```
2. **Configure** — Open the terminal in the cloned folder and run:
**Windows (PowerShell)**
```powershell
.\setup.ps1
```
**macOS / Linux**
```bash
chmod +x setup.sh && ./setup.sh
```
3. **Reload** — `Ctrl+Shift+P` → **Developer: Reload Window**
4. **Say hello** — Open Copilot Chat (`Ctrl+Alt+I`) and type "Who are you?"
### Automatic Install (alternative)
Prefer a single command? This clones the repo and configures VS Code in one step:
**Windows (PowerShell)**
```powershell
irm https://raw.githubusercontent.com/fabioc-aloha/AlexAgent/main/install.ps1 | iex
```
**macOS / Linux (Bash)**
```bash
curl -fsSL https://raw.githubusercontent.com/fabioc-aloha/AlexAgent/main/install.sh | bash
```
---
## Requirements
- **VS Code 1.110+** (agent plugins support)
- **GitHub Copilot** subscription (Individual, Business, or Enterprise)
- **Git** (for installation and updates)
---
## Updating
Open the cloned `AlexAgent` folder in VS Code → **Source Control** panel → **Pull**. Then reload (`Ctrl+Shift+P` → **Developer: Reload Window**).
---
## Troubleshooting
**Alex doesn't respond** — Check VS Code is 1.110+, and that `chat.agent.enabled` and `chat.plugins.enabled` are `true` in settings.
**Skills don't load** — Reload VS Code (`Ctrl+Shift+P` → "Reload Window"). Try asking directly: "Load the testing-strategies skill".
**MCP tools unavailable** — Install [Node.js](https://nodejs.org/).
---
## Plugin vs Extension
| Feature | Plugin | Extension |
|---------|:------:|:---------:|
| Skills, Agents, Instructions | ✅ | ✅ |
| `@alex` chat participant | — | ✅ |
| Welcome panel with avatar | — | ✅ |
| 90 extension commands | — | ✅ |
| Episodic memory & task detection | — | ✅ |
Want the full experience? Install the [Alex Cognitive Architecture extension](https://github.com/fabioc-aloha/Alex_Plug_In) from GitHub.
---
## License
Apache 2.0 — See [LICENSE](LICENSE)
## Links
- 🏠 [Alex Cognitive Architecture](https://github.com/fabioc-aloha/Alex_Plug_In) — Main project & full extension
- 📖 [User Manual](https://github.com/fabioc-aloha/Alex_Plug_In/blob/main/alex_docs/guides/USER-MANUAL.md) — Documentation
---
## Appendix
Manual Installation (CLI)
#### Windows
```powershell
git clone https://github.com/fabioc-aloha/AlexAgent.git $env:USERPROFILE\.alex-agent
cd $env:USERPROFILE\.alex-agent
.\setup.ps1
```
#### macOS / Linux
```bash
git clone https://github.com/fabioc-aloha/AlexAgent.git ~/.alex-agent
cd ~/.alex-agent
chmod +x setup.sh && ./setup.sh
```
Skills (84)
Skills are domain knowledge Alex loads on demand:
| Category | Skills |
|----------|--------|
| **Security** | secrets-management, distribution-security, security-review |
| **Testing** | testing-strategies, root-cause-analysis, debugging-patterns |
| **Documentation** | markdown-mermaid, doc-hygiene, knowledge-synthesis |
| **Development** | vscode-extension-patterns, mcp-development, refactoring-patterns |
| **AI/ML** | prompt-engineering, ai-character-reference-generation, image-handling |
Ask Alex about any topic — he'll load the relevant skill automatically.
Agents (7)
Switch personas for specialized tasks:
| Agent | Use When |
|-------|----------|
| **@Alex** | General assistance (default) |
| **@Researcher** | Deep exploration, finding patterns |
| **@Builder** | Implementing features, writing code |
| **@Validator** | Code review, testing, quality assurance |
| **@Documentarian** | Writing docs, READMEs, guides |
| **@Azure** | Azure deployment, infrastructure |
| **@M365** | Microsoft 365, Teams, Graph API |
Prompts (11)
Reusable workflows available as `/` commands:
- `/rca` — Root cause analysis workflow
- `/refactor` — Safe refactoring procedure
- `/debug` — Systematic debugging
- `/security-review` — Security audit checklist
- `/knowledge` — Search cross-project knowledge
- And more...
Instructions (22)
Auto-loaded rules that apply based on what you're editing:
- Editing `*.test.ts`? Testing best practices load automatically
- Working in `azure/`? Azure deployment patterns activate
- Touching security files? Security review guidelines appear
---
Alex — The AI that grows with you