R3BL Development Pack

The complete R3BL development experience in one install. Get carefully crafted dark
themes, enhanced Rust syntax highlighting, task management, and productivity tools - all
configured to work together seamlessly.
Included Extensions
R3BL Core Extensions
These extensions are maintained and published by R3BL.
| Extension |
Description |
| R3BL Theme |
Dark themes (R3BL Theme, R3BL 2026 Theme, R3BL 2027 Theme, and No Italic variants) plus bundled R3BL 2027 Icons |
| R3BL Semantic Configuration |
Enhanced Rust highlighting, auto-folding, structure navigation, and inlay hint toggling |
| R3BL Task Management |
Task space management, Task Stack, Jump Point Navigation, Coding Agent integration, and tab organization |
| R3BL Fuzzy Search |
Fast fuzzy search and Git Diff Search Editor for reviewing changes |
| R3BL Opened Editors |
Fast opened editors dropdown switcher (Alt+E) and vertical sidebar panel navigation |
| R3BL Copy Selection Path and Range |
Copy file paths with line ranges for Coding Agents |
| R3BL Auto Insert Copyright |
Automatic copyright header insertion with multiple license templates |
| R3BL Shared |
Shared services for R3BL extensions (automatically installed) |
Third-Party Dependencies
These extensions are required for full functionality and are automatically installed.
| Extension |
Description |
| rust-analyzer |
Official Rust language server (3rd party) |
What You Get
- Beautiful Dark Themes & Bundled Icons: Carefully crafted themes (
R3BL Theme,
R3BL 2026 Theme with deep #0e0f10 background, R3BL 2027 Theme combining Catppuccin
Mocha workbench/TextMate/rainbow brackets with R3BL semantic tokens, and No Italic
options), bundled R3BL 2027 Icons (from Catppuccin Icons, auto-activated with 2027
themes), and 3 selectable comment brightness levels (dim, medium, bright).
- Enhanced Rust Experience: Beyond syntax highlighting, get auto-folding for
use
statements and rustdoc, a dedicated Structure Navigator for large files, and quick
inlay hint toggling (Ctrl+Alt+I).
- Task Space & Spatial Context Management: Organize multiple tasks on one branch while
preserving each task's spatial context—saving/restoring opened tabs, tracking
per-task Jump Point Navigation (
Alt+U / Alt+Shift+U) across IDEs via
.vscode/jump-points.json, managing detours on an explicit Task Stack, and integrating
with Coding Agents via a custom slash command.
- High-Efficiency Code Review: Use the Git Diff Search Editor to review uncommitted
changes or recent commits in a single, searchable tab—perfect for AI-generated diffs.
- Fast Fuzzy Search: Lightning-fast file content search powered by
rg and fzf with
live preview.
- Instant Opened Editors Switcher: Single-stroke switcher (
Alt+E on Linux/Windows,
Cmd+E on macOS) to instantly pop open a searchable list of all open files, or navigate
active tabs vertically in the sidebar.
- Compiler Syntax Copying: Quick file path copying with line ranges in standard
compiler format (
path:1-10 or path:5) without @ prefix. Supports both relative
paths (within workspace) and absolute paths (outside workspace).
- Automated Compliance: Automatic copyright headers for new files with support for
MIT, Apache 2.0, GPLv3, and more.
- Full Rust Support: Official
rust-analyzer integration out of the box.
Requirements
- VS Code 1.60.0 or higher
- For fuzzy search:
fzf and ripgrep must be installed on your system
- For git features:
git must be installed
Installation
- Install this extension pack from the VS Code Marketplace
- All included extensions are automatically installed
- Restart VS Code
Quick Start
- Activate the theme: Press
Ctrl+K Ctrl+T → Select R3BL 2027 Theme,
R3BL 2027 Theme (No Italic), R3BL 2026 Theme, R3BL 2026 Theme (No Italic),
R3BL Theme, or R3BL Theme (No Italic) (selecting a 2027 variant also activates
R3BL 2027 Icons automatically)
- Enable semantic highlighting: Automatically applied or enabled on prompt
- Start coding with the full R3BL experience!
Keyboard Shortcuts
The most common shortcuts for the R3BL suite. All shortcuts can be customized in VS Code's
Keyboard Shortcuts settings.
| Shortcut |
Extension |
Action |
Alt+Shift+T |
Task Management |
Open task spaces dialog |
Alt+Shift+F |
Task Management |
Finish current task (archive and pop parent / close tabs) |
Alt+Shift+J |
Task Management |
Pop top task from Task Stack (or close tabs if empty) |
Alt+Shift+C |
Task Management |
Close current task space (save and close tabs) |
Alt+Shift+D |
Fuzzy Search |
Start interactive fuzzy search |
Ctrl+Shift+G |
Fuzzy Search |
Open Git Diff Search Editor (Uncommitted/Commits) |
Ctrl+R |
Fuzzy Search |
Refresh Git Diff Search Editor (while tab focused) |
Alt+O |
Copy Selection |
Copy file path with line range (compiler syntax) |
Alt+Shift+O |
Copy Selection |
Show session copy history and navigation |
Ctrl+Shift+Y |
Semantic Config |
Open Rustdoc Structure Navigator |
Ctrl+R |
Semantic Config |
Run Flycheck (manual debounced cargo check) |
Ctrl+- |
Semantic Config |
Fold all Rustdocs in current file |
Ctrl+= |
Semantic Config |
Unfold all Rustdocs in current file |
Ctrl+M |
Semantic Config |
Scroll current line to top |
Ctrl+Shift+L |
Semantic Config |
Insert Rustdoc Link Definition |
Ctrl+Alt+I |
Semantic Config |
Toggle editor inlay hints on and off |
Alt+U |
Task Management |
Jump to definition and record jump point |
Alt+Shift+U |
Task Management |
Show Jump Point Navigation popup (backtrack, export) |
Alt+E |
Opened Editors |
Show dropdown of all open editors (Cmd+E on Mac) |
Ctrl+K Ctrl+T |
Theme |
Change Color Theme |
| - |
Semantic Config |
Set Comment Brightness (R3BL: Set Comment Brightness...) |
Configuration Highlights
Configure the R3BL suite to match your workflow. Open settings.json or use the Settings
UI.
Theme & Highlighting
{
"r3bl.commentBrightness": "dim" // "dim" (#8B949E, default), "medium" (#ABACAC), or "bright" (#E8DCF4)
}
Feedback & UI (Shared)
These settings apply to all R3BL extensions via the R3BL Shared service.
{
"r3bl.transientFeedbackMechanism": "statusbar", // "statusbar", "notification", or "none"
"r3bl.statusbarMessageMaxLength": 50, // Max characters in status bar messages
"r3bl.statusbarMessage.successDuration": 3000 // ms to show success messages
}
Rust Development
Enhanced defaults for the R3BL Semantic Configuration.
{
"r3bl-semantic-config.autoFoldRustdocsOnOpen": false, // Auto-hide /// comments
"r3bl-semantic-config.autoFoldUseStatementsOnOpen": false, // Auto-hide use imports
"r3bl-semantic-config.debouncedFlycheck.enabled": true, // Run cargo check on idle
"r3bl-semantic-config.insertRustdocLinkDef.maxResults": 5 // Max link definitions to show
}
Task & Tab Management
{
"r3bl-task-management.autoSaveCurrentTaskSpace": true, // Sync tabs automatically
"r3bl-task-management.showStatusBar": true, // Show active task in status bar
"r3bl-task-management.restoreTabsOnStartup": true // Resume last context on startup
}
Search & Copyright
{
"r3blFuzzySearch.respectGitignore": true, // Skip gitignored files
"copyrighter.author": "Your Name", // Copyright holder name
"copyrighter.license": "MIT" // MIT, Apache2, Apache2OneLine, GPL3, proprietary, or none
}
Use Cases
AI-Assisted Development
Optimized for working with Coding Agents (Claude Code, Gemini CLI, Cursor, etc.):
- Context Gathering: Use
Alt+O to quickly grab correctly formatted file references
in standard compiler syntax (path:10-20 or path:10) for your prompts.
- Change Review: Use
Ctrl+Shift+G (Git Diff Search Editor) to review large numbers
of changes Coding Agents make in a single turn. It's the most efficient way to be
thorough without leaving your IDE.
- Task Integration: Use Task Management with the
/r3bl-task custom command for AI
Coding Agents (Claude Code, Gemini CLI, etc.) to coordinate implementation plans in
task/*.md files.
The pack is a power-user's dream for Rust. It enhances rust-analyzer with:
- Intelligent Folding: Auto-hiding long
use blocks and rustdoc to focus on logic.
- Structure Navigator: Use
Ctrl+Shift+Y to jump between functions, traits, and impl
blocks in large files.
- Live Diagnostics: Debounced Flycheck runs
cargo check in the background after you
stop typing, without the "save to check" friction.
- Target Switcher: Switch
rust-analyzer.cargo.target on the fly from a curated
dropdown or status bar item with dynamic platform icons (🐧 Linux, 🍎 macOS, 🪟 Windows,
🌐 Wasm). Strictly project-scoped to .vscode/settings.json to prevent global setting
leakage.
Multi-Task Workflows (Spatial Context & Task Stack)
Use task spaces to manage multiple features or bug fixes simultaneously on the same
branch. Switch tasks cleanly with Alt+Shift+T (flat switch on Enter, including
non-destructive browsing of stack frames), or explicitly Push / Push New Subtask
onto the workspace Task Stack and Pop back to the parent task with
Alt+Shift+J—preserving each task's spatial context (opened tabs and task-scoped
Jump Point Navigation via .vscode/jump-points.json v3.0) with zero cross-task
overlap.
Multi-IDE Workflows (Side-by-Side)
Open the same project folder in VS Code and VS Code Insiders simultaneously. Each IDE can
maintain its own active task space (e.g., VS Code for implementation, Insiders for
research), while both IDEs stay in sync for the actual task definitions.
Release Notes
See
CHANGELOG.md
for detailed release notes and version history.
License
MIT
Contributing
Found a bug or have a suggestion? Please open an issue at:
https://github.com/r3bl-org/r3bl-vscode-extensions/issues
Rebels race on! 🏁