Rubber Ducky

Rubber Ducky is a two-fold VSCode extension:

• Rich UX integrated chatbot for implementing, explaining, and debugging code.
• Add Markdown notes to your code that are visible when hovering over the noted line.

Based on Line Note.

Chatbot features:

• Select text to ask questions.
• One-click to replace selected text with responses.
• Copy and paste between vscode and chat window.
• Permanent, searchable chat log for reference.
• Chatbot is currently experimental.

Note features:

• Add markdown hover notes to lines.
• Customize notes directory.
• Use existing files as a note, e.g., link ../src/server.ts as a note in another file, to see a file preview with syntax highlighting.
• Note features are stable. New commits are bug fixes only.

Chatbot demo

Notes demo

VSCode Marketplace

Markdown Notes Features

Invoke Add note at current position from the command palette or context menu. You can see the note you wrote as hover text.

Notes are saved by default in $PROJECT_ROOT/.vscode/.rubberducky like .vscode/.rubberducky/<short-uid>.md.

Overview

• Edit/open or remove note via Cmd + Click
• Markdown note previews on hover
• Right-click to add note to line
• Right-click to reveal notated line
• Delete a note marker by manually deleting in text editor
• Add a note marker by manually typing in text editor
• Custom note names
• Command to add note
• Command to edit/open note
• Command to remove note
• Command to reveal notated line
• Notes move with code changes
• Notes can be moved between files
• Notes are not affected by refactors
• Add notes within your notes
• Customize notes directory, note marker background color, and annoted line ruler color
• Configure to delete orphaned notes on-save, on-inteveral, on-save-and-on-interval, or never

API

Commands

• rubberducky.addNote: Add note at current position (Annotate Line)
• rubberducky.openNote: Edit note at current position (Open Note)
• rubberducky.revealLine: Reveal line in notated file (Show Note Marker)
• rubberducky.removeNote: Remove note at current position (Delete Note)

Configuration

• rubberducky.cleanUpOrphanedNotesInterval: Interval at which to clean up unused notes in the background in ms. Only applies if cleanUpOrphanedNotes is set to on-interval or on-save-and-on-interval. Default: 60000 (60s). For performance, a larger value is recommended.
• rubberducky.cleanUpOrphanedNotes: Defines the cleanup behavior for orphaned notes. It can be set to on-save, on-interval, on-save-and-on-interval, or never. Default: on-save-and-on-internal. Note that when using on-save or on-save-and-on-interval, if you delete a note marker and save the file then your note file will also be deleted.
• rubberducky.includePaths: Specifies file pattern globs to scan for note markers. Directories that don't match these patterns will be ignored.
• rubberducky.gutterIconPath: File path of the icon to be displayed in gutter.
• rubberducky.lineColor: Sets the background color for inline note markers (Name, HEX, or RGB).
• rubberducky.rulerColor: Sets the ruler color for notated lines (Name, HEX, or RGB).
• rubberducky.showGutterIcon: Whether to display the gutter icon in the gutter for a noted line. Default: true.

Demos

Adding a note

Custom note title

Notes move with code changes

Notes can be moved across files

Reveal notated line command

Refactor does not affect notes

Acknowledgements

Rubber Ducky is a fork of Line Note by tkrkt. This library's design was also informed by Marginalia by indiejames.

• https://github.com/tkrkt/linenote
• https://github.com/indiejames/marginalia

Known Bugs

• Gutter icon does not display.

VSCode Marketplace