view-workflow

---
name: view-workflow
description: View GitHub Actions workflow runs and status
---

# View GitHub Actions Workflow

## Name

github:view-workflow - View GitHub Actions workflow runs and status

## Synopsis

```
/view-workflow [arguments]
```

## Description

View GitHub Actions workflow runs and status

## Implementation

View the status of GitHub Actions workflow runs for a repository or pull request.

## Usage

```
/view-workflow [owner/repo] [run-id or pr-number]
```

This command displays comprehensive workflow and job information.

## What This Command Does

1. Fetches workflow run data for a repository or PR
2. Retrieves all jobs in the workflow using `list_workflow_runs`
3. Displays:
   - Workflow status and duration
   - Individual job statuses
   - Failed job logs (if any)
   - Job durations and timestamps
   - Workflow trigger information

## Prerequisites

- GitHub MCP server must be installed and configured
- You must have access to the repository
- OAuth authentication must be completed

## Example Interaction

### View Latest Workflow Runs

```
User: /view-workflow my-org/my-repo

Claude: Fetching workflow runs for my-org/my-repo...

## Recent Workflow Runs

### Run #1234 - CI Pipeline
**Status**: Running
**Branch**: feature/user-auth
**Triggered by**: Push by @johndoe
**Started**: 3 minutes ago

Jobs:
- build: Passed (1m 23s)
- test: Running (2m 15s elapsed)
- lint: Pending
- deploy: Pending

### Run #1233 - CI Pipeline
**Status**: Success
**Branch**: main
**Duration**: 4m 32s
**Completed**: 1 hour ago

All jobs passed.
```

### View Failed Workflow

```
User: /view-workflow my-org/my-repo 1232

Claude: Fetching workflow run #1232...

## Workflow Run #1232 - CI Pipeline
**Status**: Failed
**Branch**: feature/new-feature
**Duration**: 2m 45s

### Jobs by Status

#### Failed
- test (2m 15s)
  **Error**: Test suite failed with 3 failures
  ```

  FAIL src/auth.test.ts
    Authentication API
      POST /login
        should return JWT token
        Expected: 200
        Received: 500

  ```

#### Passed
- build (1m 18s)
- lint (24s)

#### Skipped
- deploy (skipped due to test failure)

### Recommendations
1. Check database connection in test environment
2. Review test timeout settings
3. Re-run workflow after fixes
```

## Arguments

- `owner/repo` (required): Repository in owner/repo format
- `run-id` (optional): Specific workflow run ID to view
- `pr-number` (optional): View workflows for a specific PR

## Tips

- Monitor workflows during active development
- Investigate failed jobs immediately
- Compare run times to identify bottlenecks
- Check if tests are flaky or consistently failing
- Review job logs for specific error messages
- Use workflow status to determine PR readiness

## Common Issues

### Failed Tests

- Review test logs for specific failures
- Check if tests pass locally
- Verify test environment configuration
- Look for flaky tests

### Build Errors

- Check for missing dependencies
- Verify build configuration
- Look for syntax or compilation errors

### Timeout Issues

- Increase timeout values if needed
- Optimize slow tests or builds
- Check for infinite loops

## Related Commands

- `/review-pr`: Full PR review including workflow status
- `/create-pr`: Create PR that will trigger workflows
- `/create-issue`: Create issue for workflow failures