Personal collection of VS Code utilities and commands designed to enhance coding workflow. Includes smart comment formatting, task management integration with Claude, and debugging utilities.
Features
Intelligent comment formatting that understands list structures and provides natural indentation and continuation.
What it does:
- Automatically continues comments when you press Enter
- Smart Tab/Shift+Tab to indent/outdent list items within comments
- Preserves comment markers (
//, /*, *) and list structure (-, *, numbered lists)
- Context-aware indentation based on surrounding list items
Example:
// - Parent item
// - Child item (Tab to indent)
// - Grandchild (Tab again)
// - Back to child (Shift+Tab to outdent)
Keybindings:
Tab - Indent current comment list item (or fallback to default)Shift+Tab - Outdent current comment list item (or fallback to default)Enter - Auto-continue comment on new line with proper formatting
Note: Only active in code files (JS/TS), not in markdown.
Claude Task Management
Create, track, and execute tasks directly from your codebase using special comment annotations that integrate with Claude Code.
Commands:
Angus: Create Claude Task - Insert a task template (quick or full)Angus: Add Claude Note - Reference a task from anywhere in your workspaceAngus: Run Claude Task - Execute a task in iTerm2 with ClaudeAngus: Refresh Task Registry - Rescan workspace for tasks
Task Format:
// @angus-claude-task T-xxxxx
// - Brief task description (quick format)
/* @angus-claude-task T-xxxxx
status=ON_HOLD
Title:
- Description of the task
Intent:
- Why this task exists
[... full template ...]
*/
Note Format:
// @angus-claude-note ref=T-xxxxx
// This is a note about a potential issue related to task T-xxxxx
Features:
- Click task IDs to run them in Claude
- Click note references to jump to the original task
- Workspace-wide task registry
- Automatic task discovery and indexing
Log with util.inspect
Quick debugging helper that wraps selected code in console.log(util.inspect(...)) with full formatting options.
Usage:
- Select a variable or expression
- Run
Angus: Log with util.inspect from command palette
- Or bind to a keyboard shortcut (recommended:
cmd+shift+l)
Example:
// Before: selected `myObject`
// After:
import util from 'util';
console.log(util.inspect(myObject, { showHidden: false, depth: null, colors: true }));
Installation
From Marketplace
Search for "Angus's VS Code Tools" in the VS Code Extensions panel.
From VSIX
- Download the latest
.vsix from releases
- In VS Code:
Extensions → ... → Install from VSIX
From Source
git clone https://github.com/anguskeatinge/hectic-vscode-extensions
cd hectic-vscode-extensions
pnpm install
pnpm release:prep
Then install the generated .vsix from releases/
Development
Build Commands
pnpm dev:build # Type check + compile
pnpm release:prep # Type check + compile + bundle VSIX
pnpm release:send-it # Publish to marketplace
pnpm test # Run tests
pnpm test:watch # Run tests in watch mode
Testing
- Press
F5 to launch Extension Development Host
- Test your changes in the new window
- Make edits and reload window to see updates
Adding New Commands
See /src/commands/README.md for implementation details.
Publishing
First-Time Setup
- Create publisher account at https://marketplace.visualstudio.com/manage
- Generate PAT at https://dev.azure.com (Scopes: Marketplace → Manage)
- Login:
pnpm vsce login <publisher-id>
Publishing Updates
pnpm vsce publish patch # 0.0.1 → 0.0.2
pnpm vsce publish minor # 0.0.1 → 0.1.0
pnpm vsce publish major # 0.0.1 → 1.0.0
Manage at: https://marketplace.visualstudio.com/manage
Tech Stack
- TypeScript
- SWC for fast compilation
- Vitest for testing
- Biome for linting
License
MIT
