El Problema
Escribir comentarios de código y documentación es una tarea de cambio de contexto. Estás en un estado de flujo profundo — navegando un sistema complejo, sosteniendo un modelo mental de componentes interconectados — y luego necesitas pausar para documentar lo que hiciste.
Cursor es una herramienta de IA para codificación que se integra con tu editor y asiste con generación de código, explicaciones, y refactorización. Pero agregar comentarios y documentación manual aún requiere tu atención completa. Telvr te permite hablar tus comentarios mientras mantienes el editor en foco.
Cómo Telvr Funciona con Cursor
Telvr funciona con Cursor a través de la inserción de texto a nivel del sistema. Posiciona tu cursor, presiona el hotkey de Telvr, habla tu comentario, y el texto se inserta directamente en tu editor.
Para comentarios de línea única:
- Posiciona el cursor al final de la línea
- Presiona Ctrl/Cmd + / para crear un comentario
- Presiona tu hotkey de Telvr y habla el comentario
- El texto se inserta automáticamente
Para bloques de documentación:
- Coloca el cursor antes de la función o clase
- Presiona el hotkey de Telvr
- Habla la documentación siguiendo el formato que prefieras (JSDoc, docstring, etc.)
- Telvr inserta el texto con formato limpio
Mejor Modo de Enriquecimiento
Clean and Correct es ideal para comentarios de código. Remueve las muletillas de habla natural, arregla gramática, y produce prosa clara y concisa.
Raw funciona bien si prefieres mantener tu estructura hablada exactamente como la dictaste.
Un comentario típico de código:
Habla bruta:
"um so this function uh takes the user input and validates it against the schema and if it passes validation it transforms it into the internal format uh we use for processing"
Después de Clean and Correct:
Takes the user input and validates it against the schema. If validation passes, transforms it to the internal processing format.
Empezando
- Abre Cursor y configura tu hotkey de Telvr
- Posiciona el cursor donde quieres agregar un comentario
- Presiona el hotkey de Telvr
- Habla tu comentario o documentación
- El texto se inserta automáticamente
Con Telvr, documentar código nunca interrumpe tu flujo de programación. Habla y continúa codificando.