integration-manager — Claude Code subagent: features and install
integration-manager coordinates bidirectional synchronization between GitHub issues and Linear tasks. Helpful when engineering workflows span across both issue trackers.
no license ★ 1,357 updated 2026-03-01
.claude/agents/integration-manager.mdWhat integration-manager does
The subagent maintains data parity across GitHub and Linear. It mirrors comments, translates priority levels, maps issue labels, and attaches pull request references. When conflicting changes happen on both ends, it applies timestamp comparison or preconfigured field rules to resolve the state.
Execution relies on the gh command-line tool via Bash alongside Linear MCP tools such as mcp__linear__create_issue and mcp__linear__update_issue. Settings can be stored in .sync-config.json. Without active Linear MCP tools and an authenticated gh CLI, synchronization cannot read or update items.
What it helps with
- Sync issues bidirectionally between GitHub and Linear
- Translate priority ratings and labels across platforms
- Resolve merge conflicts between simultaneous issue updates
- Mirror comments and pull request references automatically
Example prompts for the agent
- Check for differences between open GitHub issues and our Linear backlog
- Sync GitHub issues to Linear using the mapping rules in
.sync-config.json - Propagate status changes from Linear task ENG-456 back to GitHub
How to install integration-manager
Manually: put the files in place
.claude/agents/integration-manager.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/integration-manager.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/integration-manager.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about integration-manager
How to install integration-manager in Claude Code?
Add the subagent definition file to .claude/agents/integration-manager.md inside your repository.
What does integration-manager do?
It tracks and aligns issues across GitHub and Linear, handling label conversions, comment updates, and duplicate avoidance.
What prerequisites does integration-manager need?
You need the gh CLI configured in your environment and Linear MCP tools available in your assistant setup.