Repository navigation
Releases
v1.5 - Step-level Log Viewing & Performance Improvements
[1.5.0] - 2025-12-27
β¨ New Features
-
Step-Level Log Viewing: View logs for individual job steps directly from the Job Steps Modal.
- Click the "View Logs" button on any step to open its logs in the interactive log viewer
- Logs are filtered to show only the selected step's output
- Maintains full log viewer functionality (search, expand/collapse, download)
-
Interactive Log Viewer in Job Graph: Click on any job in the dependency graph to open the interactive log viewer.
- Re-enabled interactive log viewing feature for job nodes
- View detailed logs with collapsible groups matching GitHub's native UI
π§ Technical Improvements
-
API Efficiency Optimization: Reduced GitHub API calls to minimize rate limit usage.
- Always fetches 100 runs per API request (GitHub's maximum) regardless of UI page size
- Reduces API calls by up to 5x when client-side filters have low match rates
perPageoption is now only used for UI display purposes
-
Large Log File Safety: Added protection against memory issues when viewing large logs.
- Warning notification for logs exceeding 50MB
- Automatic truncation for logs exceeding 100MB (preserves first 90MB + last 10MB)
- Suggests using "View Raw Logs" for better performance with large files
- Prevents UI freezing and out-of-memory errors
-
Improved Log Parsing: Enhanced log parsing algorithm for better accuracy.
- Sequential boundary approach for step-to-group matching
- Proper nesting depth tracking with MAX_PARSE_DEPTH safety cap (50 levels)
- Improved handling of self-hosted runner hook scripts
- Better categorization of setup, main, and post steps
- Enhanced action/command matching with comprehensive keyword mappings
- Circular reference detection in recursive log group rendering
-
Memory Leak Prevention: Improved resource cleanup in log viewer panel.
- Prevents double-dispose errors with tracking flag
- Clears raw logs and repository info on dispose
- Early return when panel is being disposed
-
Enhanced Workflow State Management: More robust handling of workflow and repository switching.
- Sentinel value for
pendingWorkflowIdprevents stale data during workflow ID resolution - Reset caches, watched runs, and UI state when repository changes
- Auto-refresh pauses during workflow switches to prevent race conditions
- Resume auto-refresh after error recovery
- Sentinel value for
-
Debug Logging: Added detailed logging for workflow run fetching and message handling.
- Traces workflow ID resolution and mismatches
- Warns when workflow filter is set but ID is undefined
- Logs progressive fetch parameters for troubleshooting
π Fixed
- Duplicate API Calls: Fixed duplicate workflow runs API calls during webview initialization.
- Webview now handles run fetching via
getWorkflowRunsmessage instead of automatic_sendWorkflowRuns()call
- Webview now handles run fetching via
Key Highlights
- β¨ New step-level log viewing feature - View logs for individual steps directly from the Job Steps Modal
- β¨ Interactive log viewer from job dependency graph - Click jobs to view logs with collapsible groups
- π§ API efficiency optimizations - Up to 5x fewer API calls, preserving your rate limit
- π§ Large log file safety protections - Warnings and truncation for files over 50MB/100MB
- π Bug fixes - Fixed duplicate API calls and memory leaks
v1.4.0 - Workflow Runs Panel Enhancements
β¨ New Features
π« Cancel Workflow Confirmation Modal
Added a detailed confirmation dialog before canceling workflow runs.
- Displays workflow name, branch, and author for verification
- Prevents accidental cancellation of important runs
- Clear "Dismiss" and "Cancel Run" action buttons
- Keyboard accessible (Escape to close)
β‘ Adaptive Auto-Refresh
Intelligent polling that adjusts based on workflow activity.
- Automatically speeds up refresh interval (5-10s configurable) when in-progress or queued runs are detected
- Falls back to your main auto-refresh interval when all runs are stable
- Configurable fast refresh interval via slider in Settings panel
- Enable/disable toggle with informative help modal
- Visual indicator shows when adaptive refresh is active ("β‘ Faster refresh active due to in-progress runs")
- Balances responsiveness with API quota preservation
π Real-Time Rate Limit Monitoring
Track GitHub API usage directly in the Settings panel.
- Live display of remaining API requests with color-coded progress bar (green β yellow β red)
- Shows exact remaining/limit values (e.g., "4,521 / 5,000")
- Displays time until rate limit resets
- Updates automatically with each API response
π‘οΈ Rate Limit Protection
Automatic throttling to prevent hitting API limits.
- Configurable threshold (50-90%, default 70%) at which protection activates
- When enabled, auto-refresh is paused to preserve API quota
- Warning indicator appears in API Usage tab when threshold is exceeded
- Toggle to enable/disable protection with persistent settings
π₯ Health Monitor Notification Banner
Detects and helps recover from unresponsive panel states.
- Automatically detects stuck loading states and stale timers
- Displays informative banner with specific issue details
- Three recovery actions: Reset State, Refresh Data, Restart Auto-refresh
- Respects user activity to avoid false positives
- Dismissible with automatic re-detection if issue persists
βΉοΈ Filter Help Modals
Added help buttons to Watched Runs and Favorites filter messages.
- Explains what each filter mode does
- Describes which filters are disabled and why
- Accessible via βΉοΈ icon next to filter status messages
π§ Memory Management System
Improved performance and resource usage for workflow runs.
- Clears per-run state (expanded sections, job data) when runs are no longer visible
- Limits cache entries to prevent memory bloat during long sessions
- Automatic cleanup during background refresh cycles
- Reduces memory footprint when monitoring many workflow runs
π¨ Enhancements
Improved Workflow Filtering
- More accurate filtering when combining multiple filter criteria
- Better handling of edge cases with watched runs
- Consistent sorting behavior across filter modes
Enhanced Disabled Filter Visual Feedback
- Dashed borders on disabled filter controls
- Lock icon overlay indicating the filter cannot be changed
- Reduced opacity for disabled state
- Tooltip explaining why the filter is disabled
Settings Panel Improvements
- API Usage tab now shows real-time rate limit data
- Improved slider controls for adaptive refresh interval
- Better visual hierarchy in General tab
π§ Technical Improvements
- Refactored code structure for improved readability and maintainability
- Added debouncing for adaptive refresh recalculation to prevent timer thrashing
- Protection against concurrent background refresh calls during fast refresh intervals
- New storage utilities for persisting adaptive refresh, rate limit, and memory management settings
- Throttled filter recalculation to handle rapid API responses gracefully
- Added
requestAnimationFramefor job and artifact rendering to improve performance - Generation counters to invalidate stale API responses during rapid filter changes
- Rate limit information extracted from GitHub API response headers
- Improved error handling with detailed console logging for cancel workflow operations
- Webview ready state tracking to prevent premature message sending
Full Changelog: v1.3...v1.4
v1.3.0
π Release v1.3.0 - Smart File Input
Overview
This release introduces Smart File Input, a powerful new feature that transforms how you enter workflow input values. Load values directly from files, save favorites, and work with multi-value inputs more efficiently β all without leaving VS Code.
β¨ New Features
Smart File Input
Enhanced input fields for workflow parameters with intelligent file handling:
Three Input Modes
Switch between modes using the mode selector icon:
- Text Mode β Direct text input (default)
- Path Mode β Browse and insert file paths from your workspace
- Content Mode β Extract values from files with multi-select
Content Extraction
Load values from multiple file types:
- JSON β Extract property names, values, or specific keys from arrays
- YAML β Line-by-line extraction
- CSV β Row-by-row with automatic header detection
- ENV β Environment variable extraction
- Text files β Line-by-line extraction
Advanced extraction features:
- Support for nested arrays with path selection
- Configurable delimiters (comma, pipe, newline, space, or custom)
- Multi-select to choose specific values
File Favorites
- Save frequently used files with custom nicknames
- Quick access from the Content mode dropdown
- Persisted across sessions
Recent Files History
- Automatically tracks recently used files per input field
- Quick access to previously used configurations
Preview/Edit Modal
View and edit multi-value inputs in a list format:
- Add, remove, and reorder items
- Value favorites for frequently used values
- Reload from file with saved configuration
Open in Editor
Quick action to open any file path directly in VS Code editor.
Discoverability Improvements
- Mode selector button features a hover chevron indicator (βΌ)
- First-time pulse animation to help new users discover the feature
π§ Technical Improvements
- Added typed message interfaces for Smart File Input communication
- Extracted constants for display limits and priority keys to improve maintainability
- New
SmartFileInputManagerutility class for managing file favorites and recent files
πΈ Screenshots
See the README for screenshots demonstrating:
- Mode selector dropdown
- Content mode with favorites and recent files
- File content modal with extraction options
- Preview/Edit modal with list mode
π¦ Installation
- Open VS Code
- Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search for "GitHub Workflow Runner"
- Click Install or Update
Full Changelog: v1.2...v1.3.0
v1.2
π v1.2.0
What's New
π GitHub Summary Modal
View workflow run summaries directly in VS Code without leaving your editor!
- New "View GitHub Summary" button in the Run Summary section
- Parses and displays
$GITHUB_STEP_SUMMARYcontent from job logs - Open summaries in a new editor tab or view on GitHub
π¨ Syntax Highlighting for Logs
GitHub Actions logs now have proper syntax highlighting with a new TextMate grammar that highlights group markers, timestamps, error/warning messages, and more.
β¨ Presets UI Redesign
Presets have been moved from Advanced Configuration to a dedicated, more accessible section:
- New "Presets βΌ" labeled button in the workflow actions toolbar
- Enhanced button design with chevron indicator showing expand/collapse state
- New βΉοΈ help icon with comprehensive documentation modal
Improvements
- Step Duration Display: Shows
<1sfor steps under one second; fixed step numbering to use sequential display index - Job Logs Error Handling: Better error feedback when job logs cannot be loaded
Documentation
- Updated README with new presets button instructions
- New Presets Help Modal with step-by-step guides and best practices
Full Changelog: v1.1.0...v1.2.0
v1.1
π Release v1.1.0 - Job Dependencies Graph Visualization
Overview
This release introduces a major new visualization feature that brings GitHub's native workflow graph experience directly into VS Code. The interactive Job Dependencies Graph allows you to visualize, monitor, and debug your workflow runs more efficiently without ever leaving your editor.
β¨ New Features
Interactive Job Dependencies Graph
Visualize your workflow's job structure with an interactive graph view inspired by GitHub's native UI:
- Horizontal left-to-right layout showing execution stages and job dependencies
- Color-coded status indicators for success, failure, in-progress, queued, and skipped jobs
- Animated indicators for running jobs with real-time status updates
- Click-to-inspect - Click on any job to view step details or logs
- Full-screen modal view for complex workflows with many jobs
- Real-time updates during workflow execution
Matrix Job Support
Matrix jobs are now intelligently visualized:
- Collapsible matrix job groups with aggregated status badges
- Expandable groups to see individual matrix variants
- Clear visual distinction between regular jobs and matrix groups
Job Steps Modal
View detailed step information for any job:
- Step-by-step breakdown with status icons and duration
- Quick access to view full job logs for any step
- In-progress step highlighting during execution
Customizable Notification Settings
New fine-grained controls for notification behavior:
- Workflow Toast Notifications: Toggle toast messages in the top-right corner for workflow start/complete/fail events
- Progress Indicators: Toggle inline job progress display (e.g., "2/5 jobs completed")
- All settings are persisted across sessions
π¨ Changes & Improvements
Default View Behavior
- New default: Clicking on a workflow run now opens the Job Dependencies Graph view (previously opened the Jobs list)
- Added a new "Graph" action button to each run for quick access to the dependency visualization
Improved Progress Display
- In-progress runs now show a mini job progress indicator in the run header
Better Panel Focus Behavior
- "View Workflow Runs" and "View Last Run" actions now always focus the panel
- "Dispatch" action shows a non-modal prompt asking if you want to switch to the panel (when panel is open but not visible)
- Panel state (scroll position, expanded sections, filters) is preserved when switching focus
State Preservation
- Replaced internal
_update()calls withpostMessageto avoid HTML reloads - Sidebar and runs panels now use
retainContextWhenHiddenfor better state preservation
Auto-Refresh Default
- Default auto-refresh interval changed from 60s to 15 seconds for more responsive monitoring
π Bug Fixes
- Watch Runs Only Auto-Refresh: Fixed auto-refresh functionality not working in "Watch Runs Only" mode. Background data updates now refresh the UI automatically without requiring manual refresh button clicks. The fix ensures watched runs are always updated with fresh data from the API.
π§ Technical Improvements
New API Capabilities
- Added new API functions to fetch individual job details (
getWorkflowJob) - Added endpoint to check job log availability before attempting download (
checkJobLogsAvailable)
Extended TypeScript Types
- New graph visualization types:
JobGraphNode,JobGraphEdge,JobDependencyGraph,MatrixJobGroup - Extended types for job steps and matrix job metadata
New Webview Components
JobDependencyGraph- Main graph visualization componentJobGraphModal- Full-screen graph modalJobNode- Individual job node renderingGraphConnector- Edge/connection renderingMatrixJobGroup- Collapsed matrix job displayJobStepsModal- Step details modal
New Utilities
- Graph layout algorithms in
webview/utils/graph-utils.ts - Extended workflow parser to extract job definitions and dependencies from YAML
Other Changes
- Added GitHub Actions workflow language support for
.github/workflows/*.ymlfiles - Added "Reload Extension Data" command for refreshing Git context
- Improved log fetching with better redirect handling for Azure Storage URLs
π Documentation
Updated README and in-extension help with:
- Comprehensive documentation for the Job Dependencies Graph features
- New screenshots showing the graph visualization
- Updated usage instructions reflecting the new default view
- Notification Settings configuration guide
- Troubleshooting examples using the graph view
π Stats
- Files Changed: 25
- Lines Added: +6,996
- Lines Removed: -679
- Commits: 7
π Contributors
Full Changelog: v1.0...v1.1
v1.0
π Release v1.0.0 - Initial Public Release
Overview
GitHub Workflow Runner is now available! This is the initial public release of a powerful VS Code extension that allows you to run, monitor, and manage GitHub Actions workflows directly from your editor β no browser needed.
Dispatch workflows with dynamic inputs, save reusable presets, track runs with advanced filtering, view logs, download artifacts, and more β all without leaving VS Code.
β¨ Key Features
Workflow Dispatch
Trigger GitHub Actions workflows directly from VS Code:
- Dynamic inputs support for string, choice, boolean, number, and environment types
- Auto-detection of current Git branch for dispatch
- Manual branch selection when needed
- File Path Detection: Automatically detects file path inputs and provides a native VS Code file picker
Real-Time Monitoring
Monitor your workflows without switching to the browser:
- Workflow Runs Panel: A dedicated view to monitor workflow runs in real-time
- Live Updates: Status indicators (queued, in-progress, success, failure) update automatically
- View Logs: See live job logs directly in the VS Code editor
- Download Artifacts: Download workflow artifacts (ZIP) with one click
Productivity Tools
Save time with built-in productivity features:
- Presets: Save frequently used workflow configurations as named presets
- Favorites: Mark workflows as favorites for quick access
- History: Tracks your dispatch history for easy reruns
- Rerun: Rerun failed jobs or entire workflows with previous inputs
- Smart Recovery: Recover inputs from previous runs (even from artifacts)
Advanced Filtering & Search
Find what you need quickly:
- Filter runs by Status, Actor (User), Branch, PR, or Workflow
- "My Runs" filter to see only your dispatches
- Search workflows by name
Secure Authentication
Multiple authentication options:
- GitHub OAuth (VS Code built-in) for seamless login
- Personal Access Tokens (PAT) for fine-grained control
- Secure token storage using VS Code SecretStorage API
Configuration Options
Customize the extension to your workflow:
- Customizable refresh intervals
- Workspace-specific or global favorites
- Configurable notifications for workflow completion
π§ CI/CD & Code Quality (PR #3)
This release includes comprehensive CI/CD setup and code quality improvements:
Code Quality Tooling
- ESLint Configuration: New
eslint.config.mjswith recommended settings for JavaScript, TypeScript, and Svelte files - Prettier Integration: Added
.prettierrcwith consistent formatting rules and Svelte support - Linting Scripts: New
lintandcheck-formatnpm scripts for automated code quality checks
Continuous Integration
- GitHub Actions Workflow: Automated CI pipeline (
.github/workflows/build-and-test.yml) that runs on push and pull requests - Matrix Strategy: Optimized build pipeline using matrix strategy for efficient testing
- Automated Checks: Linting, formatting verification, packaging, and testing on every change
Code Improvements
- Refactored code structure for improved readability and maintainability
- Added Vitest configuration for testing setup
- Fixed npm ci issues by explicitly adding yaml dependency
- Applied Prettier formatting across the codebase
π Documentation
- Comprehensive README with feature overview, installation guide, and usage instructions
- CHANGELOG documenting all notable changes
- Apache 2.0 License for open source usage
π Stats
- Files Changed: 30
- Lines Added: +3,512
- Lines Removed: -3,311
- Commits: 5 (in PR #3)
π₯ Contributors
π¦ Installation
- Open VS Code
- Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search for "GitHub Workflow Runner"
- Click Install
- Authenticate with GitHub using OAuth or PAT
Full Changelog: https://github.com/Asher-Kaligski/vscode-github-workflow-runner/commits/v1.0