https://github.com/tatoclemente/mention-team-extension
VSCode extension for mentioning team members in code comments with automatic GitHub notifications
https://github.com/tatoclemente/mention-team-extension
code-comments developer-tools github team-collaboration typescript vscode-extension
Last synced: 3 days ago
JSON representation
VSCode extension for mentioning team members in code comments with automatic GitHub notifications
- Host: GitHub
- URL: https://github.com/tatoclemente/mention-team-extension
- Owner: tatoclemente
- License: mit
- Created: 2025-11-22T20:05:14.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-11-22T21:40:46.000Z (7 months ago)
- Last Synced: 2025-11-22T22:07:36.492Z (7 months ago)
- Topics: code-comments, developer-tools, github, team-collaboration, typescript, vscode-extension
- Language: TypeScript
- Homepage:
- Size: 20.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Mention my team
[](https://opensource.org/licenses/MIT)
[](https://code.visualstudio.com/)
[](https://marketplace.visualstudio.com/items?itemName=tatoclemente.mention-my-team)
[](https://marketplace.visualstudio.com/items?itemName=tatoclemente.mention-my-team)
> ⚠️ **Beta Version** - This extension is in early development. Please report any issues on [GitHub](https://github.com/tatoclemente/mention-team-extension/issues).
Extensión para VSCode que permite mencionar miembros del equipo en comentarios de código con integración a GitHub.
## Características
- 🎯 Menciona compañeros con `@username` en comentarios
- 📝 Sintaxis compatible con Better Comments
- 🔔 Notificaciones automáticas via GitHub Issues con asignación directa
- 📧 Notificación por email automática de GitHub al usuario mencionado
- 📍 Links directos al código en GitHub con número de línea
- 📄 Contexto de código (10 líneas) incluido en la issue
- 🗑️ Borrado de menciones cierra automáticamente la issue en GitHub
- 🎨 Resaltado visual de menciones
- ⚙️ Configuración simple
## Uso
```javascript
// @johndoe Revisar si este método debería validar el cityId
//? author: @tatoclemente fecha: 22 nov 2025
static create(props: LocalityProps): Locality {
return new Locality(
props.id,
props.name,
props.cityId
);
}
```
Cuando escaneas las menciones, la extensión:
1. Crea una GitHub Issue asignada al usuario mencionado
2. GitHub envía automáticamente un email de notificación
3. La issue incluye:
- El mensaje de la mención
- Link directo al archivo y línea en GitHub
- Autor y fecha
- Contexto: 10 líneas de código después del comentario author
### Borrar menciones
Cuando borras una mención del código y vuelves a escanear:
- La extensión detecta que la mención fue eliminada
- Cierra automáticamente la GitHub Issue correspondiente
- Agrega un comentario indicando que la mención fue resuelta
Esto mantiene sincronizado tu código con las issues de GitHub.
## Configuración
### Configuración inicial
1. Configurar tu usuario de GitHub:
```bash
git config --global github.user tu-usuario-github
```
2. Crear un GitHub Personal Access Token:
- Ve a GitHub → Settings → Developer settings → [Personal access tokens → Tokens (classic)](https://github.com/settings/tokens)
- Click en "Generate new token (classic)"
- Nombre: `VSCode Team Mentions`
- Permisos necesarios: `repo` (acceso completo a repositorios)
- Click en "Generate token" y copia el token
3. Ejecutar comando en VSCode: `Team Mentions: Configure`
4. Pegar el GitHub Personal Access Token cuando se solicite
5. La extensión detectará automáticamente el repositorio desde tu configuración de git
> 💡 Solo necesitas configurar el token una vez. El repositorio se detecta automáticamente desde `git remote origin`
### Formato de menciones
La extensión busca el siguiente patrón:
```
// @username Mensaje para el usuario
//? author: @tuusuario fecha: DD MMM YYYY
[código que se incluirá como contexto - hasta 10 líneas]
```
## Comandos
- `Team Mentions: Configure` - Configurar extensión
- `Team Mentions: Scan for Mentions` - Escanear menciones en workspace y sincronizar con GitHub
## Configuración avanzada
Puedes cambiar el método de notificación en la configuración de VSCode:
- `issue` (por defecto): Crea GitHub Issues con label `team-mention` para fácil filtrado
- `discussion` (avanzado): Crea GitHub Discussions que se pueden borrar (requiere habilitar Discussions en el repo)
## Estado Actual
✅ Funcionalidades implementadas:
- Detección de menciones con sintaxis `@username`
- Metadata con `//? author: @username fecha: DD MMM YYYY`
- Creación automática de GitHub Issues
- Asignación directa al usuario mencionado
- Label `team-mention` para filtrado fácil
- Contexto de código (10 líneas después del author)
- Links directos a GitHub con línea específica
- Notificación por email vía GitHub
## Roadmap
- [ ] Soporte para GitLab
- [ ] Integración con Cursor/Windsurf
- [ ] Notificaciones en tiempo real
- [ ] Configuración por proyecto
- [ ] Soporte para comentarios multi-línea `/* */`
## Contribuir
¡Las contribuciones son bienvenidas! Lee [CONTRIBUTING.md](CONTRIBUTING.md) para más detalles.
## Licencia
MIT © [tatoclemente](https://github.com/tatoclemente)
## Autor
Creado por [@tatoclemente](https://github.com/tatoclemente)