cyrusagents

Set up Cyrus end-to-end — install prerequisites, configure authentication, create integrations (Linear, GitHub, Slack), add repositories, and launch. Run this once to get Cyrus running as a background agent.

Create a Linear OAuth application and configure Cyrus to use it — supports agent-browser automation or guided manual setup.

Configure Claude Code authentication for Cyrus — API key, OAuth token, or third-party provider.

Configure GitHub for Cyrus — gh CLI login and git config for PRs, with optional webhook setup to enable @mention responses in PR comments, automated rebases and merges, and auto-fixing based on CI failures (coming soon).

Check and install prerequisites for Cyrus — Node.js, jq, gh CLI, and the cyrus-ai npm package.

Configure the public webhook endpoint for Cyrus — ngrok, Cloudflare Tunnel, or custom URL.

Add one or more Git repositories to Cyrus configuration so it can process issues from those repos.

Print a summary of the Cyrus setup and offer to start the agent.

Search the web for information. Use when you need to look something up, find current information, or research a topic.

Configure Slack integration for Cyrus — create a Slack app from manifest, then guide the user to save credentials.

Format a final summary message for Linear. Your output is automatically streamed to the Linear agent session — just format it well, do not post it yourself.

Research the codebase to answer questions. Search for relevant files, gather context, and provide clear answers.

Implement the requested changes. Write production-ready code, follow existing patterns, and use proportionate verification.

Choose proportionate validation, fix failures, update the changelog, commit, push, and create/update the pull request or merge request.

Prepare, verify, publish, and finish a coordinated Cyrus CLI release. Use when a user asks to release Cyrus, publish cyrus-ai, run a CLI release, or perform the /release workflow.

Full debugging workflow — reproduce the bug with a focused check, perform root cause analysis, then implement a minimal fix.

Assess F1 applicability, then validate changed product workflows or the F1 harness end-to-end. Skip drives and reports when no relevant workflow behavior changes.

Configure GitLab authentication for Cyrus — glab CLI login and git config for creating merge requests.

Invoke when dev-testing a Cyrus change that spans CYPACK (edgeworker + CLI) and CYHOST (Vercel-hosted GUI) and the hosted GUI needs to point at an unreleased cyrus-core from this repo. Publishes cyrus-core (and claude-runner if needed) as a -test.N prerelease under the npm test dist-tag so CYHOST can install it via cyrus-core@test without affecting the latest dist-tag or shipping a real release.