R3BL VSCode Extensions

A monorepo containing R3BL VSCode extensions for Rust development, task management, and productivity.

Quick Start

Install the complete R3BL development experience:

code --install-extension R3BL.r3bl-extension-pack

Or search for "R3BL Extension Pack" in the VS Code Marketplace.

Extensions

R3BL Extension Pack (Recommended)

The complete package - installs all R3BL extensions plus rust-analyzer with zero configuration.

View Documentation | Marketplace

Individual Extensions

Extension	Description	Links
R3BL Theme	Dark theme optimized for Rust and Markdown	Docs · Marketplace
R3BL Semantic Configuration	Enhanced semantic highlighting for Rust	Docs · Marketplace
R3BL Task Management	Task space management for context switching	Docs · Marketplace
R3BL Fuzzy Search	Fast fuzzy file search with fzf and ripgrep	Docs · Marketplace
R3BL Copy Selection Path and Range	Copy file paths with line ranges for Claude Code	Docs · Marketplace
R3BL Auto Insert Copyright	Automatic copyright header insertion	Docs · Marketplace

Installation

From Marketplace (Recommended)

Search for extensions by name in VS Code, or use the command line:

# Install the complete pack
code --install-extension R3BL.r3bl-extension-pack

# Or install individually
code --install-extension R3BL.r3bl-theme
code --install-extension R3BL.r3bl-task-management
# etc.

From Source

git clone https://github.com/r3bl-org/r3bl-vscode-extensions.git
cd r3bl-vscode-extensions
./install.sh

The .vsix files are pre-built and committed to the repo, so no build step is needed. To rebuild from source, run ./build.sh first.

Development

Setup

npm install

Modifying Extensions

1. Make code changes in packages/extension-name/src/
2. Update version in packages/extension-name/package.json
3. Update version in packages/r3bl-extension-pack/package.json
4. Build and test:

   ./build.sh
   ./install.sh

5. Commit changes

Key points:

• Always update both the extension's version AND the extension pack version
• Scripts automatically clean up old .vsix versions
• Both build.sh and install.sh read versions from package.json

Creating New Extensions

1. Create directory: mkdir -p packages/r3bl-new-extension/src
2. Copy structure from existing extension
3. Update package.json metadata
4. Implement extension in src/
5. Add to packages/r3bl-extension-pack/package.json extensionPack array
6. Update script_lib.sh, build.sh, install.sh
7. Build and test

See CLAUDE.md for detailed development instructions.

Building

# Build all extensions
./build.sh

# Or build specific extensions
npm run build:theme
npm run build:copyright
npm run build:semantic-config

For Maintainers

After making changes to any extension:

./build.sh    # Generate .vsix artifacts
./install.sh  # Install to VS Code

The build script:

• Compiles TypeScript extensions
• Packages all extensions
• Removes outdated .vsix versions
• Creates the extension pack

Structure

packages/
├── r3bl-extension-pack/                  # Extension pack
├── r3bl-theme/                           # Theme
├── r3bl-semantic-config/                 # Semantic highlighting
├── r3bl-task-management/                 # Task spaces
├── r3bl-fuzzy-search/                    # Fuzzy search
├── r3bl-copy-selection-path-and-range/   # Copy file paths
└── r3bl-auto-insert-copyright/           # Copyright headers

Changelog

See CHANGELOG.md for version history and release notes.

License

MIT - See individual extension LICENSE files for details.

---

Rebels race on!