skills.rest
ceedaragents
ceedaragentsOFFICIAL
Explore all skills by this author →
GitHub

cyrus-setup-linear

Creates a Linear OAuth application and configures Cyrus credentials via automation or guided manual setup.

794|163|Updated Apr 19, 2025
Search Tags:#linear#webhook#Automation#self-hosted#Setup#cyrus#oAuth
One-click install
npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-linear
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cyrus-setup-linear
Source: https://github.com/ceedaragents/cyrus/tree/main/skills/cyrus-setup-linear
Command: npx skills add https://github.com/ceedaragents/cyrus --skill cyrus-setup-linear

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Setting up a Linear OAuth application for a self-hosted Cyrus agent involves many error-prone manual steps: building the app manifest, configuring callback and webhook URLs, copying secrets, and running the OAuth authorization flow. This Skill automates or guides the entire process so Cyrus can receive Linear webhooks and respond to issues.

Core Features & Use Cases

  • Manifest-based app creation: Generates a Linear OAuth app manifest URL with pre-filled redirect URIs, webhook URL, and event types, avoiding manual form filling.
  • Multiple setup paths: Supports claude-in-chrome MCP automation, agent-browser automation, or a fully guided manual flow depending on available tooling.
  • Secure credential handling: Never reads secrets into context; the user pastes Client ID, Client Secret, and Webhook Secret directly into ~/.cyrus/.env, then runs cyrus self-auth-linear to authorize the workspace.
  • Use Case: You are self-hosting Cyrus and need it to monitor Linear issues. Run this Skill to create the OAuth app, store credentials, and complete workspace authorization in one guided session.

Quick Start

Ask your AI agent to run the cyrus-setup-linear skill to create a Linear OAuth app and connect it to your self-hosted Cyrus instance.

Frequently Asked Questions about cyrus-setup-linear

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

FAQPage Schema
How do I create a Linear OAuth app for Cyrus?▼

The skill generates a manifest-backed Linear app creation URL with pre-filled redirect URIs, webhook URL, and event types. Open the URL, review the settings, click Create, then paste the credentials into ~/.cyrus/.env.

How do I authorize Cyrus with my Linear workspace?▼

Run cyrus self-auth-linear after saving your credentials. It starts a temporary OAuth callback server, opens Linear's authorization page, and saves workspace tokens to ~/.cyrus/config.json after you click Authorize.

Can the Linear setup be automated with a browser?▼

Yes, the skill supports two automation paths: claude-in-chrome MCP tools or agent-browser connected to a Chrome debug session. If neither is available, it falls back to a guided manual setup flow.

Why does Linear reject my OAuth application name?▼

Linear rejects OAuth client names containing the word Linear or a URL. Choose a different agent name before building the manifest, then regenerate the manifest URL.

What should I do if Linear is already configured for Cyrus?▼

The skill detects existing LINEAR_CLIENT_ID and workspace configuration and skips setup. To reconfigure, remove LINEAR_CLIENT_ID, LINEAR_CLIENT_SECRET, and LINEAR_WEBHOOK_SECRET from ~/.cyrus/.env and re-run.

Related Skills

Explore More Software Engineering Skills→
autonomy-cloudautonomy-cloud
2

public-ingress

Configure ngrok tunnels and persist the public URL as ingress.publicBaseUrl.

Official
Intermediate
wuyuxiangXwuyuxiangX

yux-linear-start

Create isolated git worktrees for Linear issues and update issue states.

Community
Intermediate
tangzheng202202tangzheng202202
1

openclaw-feishu-webhook-setup

Diagnose Feishu connectivity issues and switch to webhook mode via cloudflared tunnel.

Community
Advanced
shepherdjerredshepherdjerred

grafana-helper

Automate Grafana dashboards, datasources, alerts, and annotations via REST API.

Community
Advanced