skills.rest
paarths-collab
paarths-collabCOMMUNITY
Explore all skills by this author →
GitHub

integration-linear

Connect Linear to a self-hosted Hermes agent over SSH with API key validation.

13|1|Updated Jun 1, 2026
Search Tags:#automation#mcp#linear#api key#ssh#hermes
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill integration-linear
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: integration-linear
Source: https://github.com/paarths-collab/hstack/tree/main/skills/integration-linear
Command: npx skills add https://github.com/paarths-collab/hstack --skill integration-linear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill connects Linear to a self-hosted Hermes agent without requiring a browser-based OAuth flow, so the integration can be completed headlessly and safely over SSH.

Core Features & Use Cases

  • Headless Linear MCP Wiring: Registers Linear with a remote Hermes gateway using the supported bearer-header path.
  • Key Validation and Safety Checks: Verifies the Linear API key against the raw GraphQL API before changing any configuration.
  • Rollback-Safe Operations: Stores secrets in the Hermes environment, reloads the gateway correctly, confirms registration in logs, and supports clean rollback if anything fails.
  • Use Case: A team wants their AI coding agent to read and act on Linear issues, projects, and cycles from a VPS-hosted Hermes setup without manual reconfiguration every time.

Quick Start

Ask the assistant to connect Linear to your self-hosted Hermes agent on the VPS using your personal API key and verify that the integration is registered and working.

Frequently Asked Questions about integration-linear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Linear to a self-hosted Hermes agent over SSH?▼

The integration registers Linear with a remote Hermes gateway using a bearer-header path, validates the API key against raw GraphQL, and stores secrets in environment variables for headless access.

Can I automate Linear issue tracking without a browser-based OAuth flow?▼

Yes, this integration uses raw API-key validation against the GraphQL API to configure the remote Hermes gateway directly over SSH, entirely bypassing browser-based OAuth flows.

Does the Linear MCP integration validate API keys before modifying Hermes configuration?▼

Yes, key validation checks verify the Linear API key against the raw GraphQL API before changing any Hermes configuration to ensure safe and rollback-ready registration.

What is the best way to securely store a Linear API key for headless MCP access?▼

The recommended approach is storing secrets as environment variables in the ~/.hermes/.env file, which keeps the API key secure for headless access and gateway reloads.

Why does my remote MCP gateway fail to register Linear tools after a reload?▼

Gateway registration failures may occur if the bearer-header MCP path is incomplete or API key validation fails, requiring idempotent verification of Linear tool registration and log confirmation.

Do I need SSH access to integrate Linear with a VPS-hosted Hermes setup?▼

Yes, SSH access is required to connect Linear to a VPS-hosted Hermes setup, allowing secure API key storage, gateway reloads, and headless verification of tool registration.

Related Skills

Explore More Software Engineering Skills→
paarths-collabpaarths-collab
13

integration-github

Connect GitHub to a self-hosted Hermes agent over SSH.

Community
Advanced
paarths-collabpaarths-collab
13

integration-mailchimp

Connect Mailchimp Marketing and Mandrill APIs to a self-hosted Hermes agent over SSH.

Community
Advanced
paarths-collabpaarths-collab
13

integration-supabase

Connect Supabase to a self-hosted Hermes agent over SSH.

Community
Advanced
akiyoshiakiyoshi

pair-agent

Coordinates multi-agent browser sharing sessions with isolated tabs and token-based security.

Community
Advanced