cross-reference-manager — Claude Code command: features and setup
Audit and repair references between GitHub and Linear, find orphaned links, and export mapping reports. Useful when you need to check cross-platform link consistency.
npx claude-code-templates@latest --command sync/cross-reference-managerWhat cross-reference-manager does
The command manages references between GitHub and Linear. It can audit mappings, find orphaned links and mismatches, repair outdated references, remove invalid entries, and consolidate duplicates. Ask it to audit, repair, map, validate, or export.
Mapping data can live in .reference-mappings.json or reference state files. The command checks GitHub CLI availability and Linear MCP connectivity and authentication, then looks for sync and reference files. Backups, rollback, and logging are part of the described data-protection workflow. Link checks may fail if the required tools are unavailable.
What it helps with
- find orphaned GitHub–Linear references
- detect mismatched cross-platform links
- repair outdated mappings and remove invalid entries
- consolidate duplicate references
- export mapping reports and backups
Example prompts for the agent
- Audit the references between GitHub and Linear.
- Repair broken mappings and consolidate duplicates.
- Show the reference map and export a report.
How to install cross-reference-manager
1claude-code-templates
npx claude-code-templates@latest --command sync/cross-reference-manager2Manually: put the files in place
.claude/commands/cross-reference-manager.mdCall it with /cross-reference-manager. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/cross-reference-manager.mdCall it with /prompts:cross-reference-manager. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/cross-reference-manager.prompt.mdManually: put the files in place
.gemini/commands/cross-reference-manager.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about cross-reference-manager
How do I install cross-reference-manager in Claude Code?
Run npx claude-code-templates@latest --command sync/cross-reference-manager. The command file is .claude/commands/cross-reference-manager.md.
What does cross-reference-manager do?
It audits and manages links between GitHub and Linear, identifies orphaned or inconsistent references, and can repair mappings. It can also display a reference map and export reports.
Which integrations does the command check?
It checks whether GitHub CLI is available and tests Linear MCP connectivity and authentication. It also searches for mapping and reference state files.
Source text
cross-reference-manager.md · MIT
--- allowed-tools: Read, Write, Edit, Bash argument-hint: "[action] | audit | repair | map | validate | export" description: Manage cross-platform reference links between GitHub and Linear with integrity checking --- # Cross-Reference Manager Manage comprehensive cross-platform reference links with integrity validation: **$ARGUMENTS** ## Current Reference State - GitHub CLI: !`gh --version 2>/dev/null && echo "✓ Available" || echo "⚠ Not available"` - Linear MCP: Check Linear MCP server connectivity and authentication - Reference database: @.reference-mappings.json or reference state files - Link integrity: !`find . -name "*sync*" -o -name "*reference*" | wc -l` mapping files found ## Task Implement comprehensive cross-reference management for GitHub-Linear integration: **Management Action**: Use $ARGUMENTS to specify audit, repair, mapping, validation, or export operations **Reference Management Framework**: 1. **Reference Database** - Initialize mapping storage, track bidirectional links, maintain sync history 2. **Integrity Auditing** - Scan cross-references, identify orphaned links, detect mismatches, validate consistency 3. **Smart Repair** - Fix broken references, update outdated links, consolidate duplicates, remove invalid entries 4. **Mapping Visualization** - Display reference networks, show connection health, highlight problems, provide statistics 5. **Deep Validation** - Verify link functionality, test bidirectional navigation, check field consistency, ensure data integrity 6. **Export & Documentation** - Generate mapping reports, create backup files, provide import instructions, maintain audit trails **Advanced Features**: Automated orphan detection, intelligent reference reconstruction, duplicate consolidation, comprehensive validation. **Data Protection**: Backup before modifications, transaction-based operations, rollback capabilities, comprehensive logging. **Output**: Complete reference management system with integrity reports, repair summaries, mapping visualizations, and comprehensive cross-platform link maintenance.
© davila7 · MIT · davila7/claude-code-templates