DeepSeek Harness (DSH) is a plugin-based development environment designed to integrate external tool capabilities into a unified conversation and interface. When using GitHub Actions, developers often need to switch frequently between the browser and the terminal to check build status and logs. The dsh-github-ci plugin solves this fragmentation by providing a real-time Pipeline Dashboard in the DSH Web interface and encapsulating GitHub Actions operational capabilities as Agent tools.

Plugin Positioning

dsh-github-ci is a GitHub Actions CI management plugin maintained by knownasmobin. It provides a visual pipeline monitoring panel for the DeepSeek Harness Web interface and supports operating workflows directly within conversations through the github_ci agent tool.

Core Features

  • Pipeline Dashboard: Provides a dashboard in a Web overlay or settings page, displaying summaries of passed/failed/running status, status badges, and quick action buttons for each run (such as cancel, retry, and open GitHub).
  • Authentication Methods: Supports GitHub OAuth Device Flow (no client secret required) or Personal Access Token (PAT). Tokens are persistently stored in the DSH credential store and reused across sessions.
  • Repository Browser: Supports listing your private repositories and organization repositories, or searching public user/organization repositories for browsing.
  • Run Operations: Supports canceling in-progress runs, retrying failed jobs, and directly opening the corresponding page on GitHub.
  • Logs and Detection: Provides run logs and includes failure step detection, pushing relevant logs to the Agent.
  • Agent Tool: The github_ci tool can be used to list workflows/runs, inspect jobs, retrieve logs, trigger, cancel, and retry.
  • Fix and Recovery: Supports the “Fix with Agent” feature, allowing one-click drafting of structured debugging requests that include run metadata and failure logs. Supports recovery when credentials expire and error messages for specific sources.

Installation and Enablement

Install it via the command line. The plugin must be mounted to the Web client, so the --profile web parameter must be specified.

dsh plugin --profile web add dsh-github-ci

Typical Usage

To use the github_ci tool in a DSH conversation, specify the action parameter and related parameters.

  • List workflows:
    github_ci({ action: "list_workflows", owner: "vercel", repo: "next.js" })
  • Get logs:
    github_ci({ action: "get_logs", repo: "owner/repo", run_id: 123456789 })
  • Trigger workflow:
    github_ci({ action: "trigger", owner, repo, workflow_id: "deploy.yml", ref: "main" })

Use Cases and Considerations

  • Use Cases: Developers who need to monitor GitHub Actions status directly in the DSH Web interface, or who need to trigger, cancel, and troubleshoot CI issues through Agent automation.
  • Considerations:
    • Dependency Check: The peer dependency requirement of @deepseek-ai/dsh-tools >=0.1.1-rc.1 must be satisfied.
    • OAuth Configuration: When using OAuth login, “Device Flow” must be enabled in GitHub Developer Settings.
    • PAT Permissions: When using a Personal Access Token, the repo and workflow permission scopes must be included.
    • Anonymous Access: Browsing public repositories does not require login; anonymous reads are sufficient.
    • Secure Storage: Tokens are stored only in the DSH credential store and are not written to the source tree.

Summary

dsh-github-ci fully integrates GitHub Actions control into the DeepSeek Harness ecosystem. By combining the dashboard and Agent tools, developers can seamlessly manage CI processes in their local environment. For more details, refer to the catalog page or the GitHub repository.