Support

Get help with pair installation, configuration, and usage.

Get help with pair installation, configuration, and usage.

  • FAQ — Common questions about pair, process, languages, and PM tools
  • Installation FAQ — Solutions for common install issues
  • GitHub Issues — Report bugs and feature requests

Support Scope

We provide support for:

  • Installation and setup issues
  • Configuration problems
  • Bug reports with reproducible cases
  • Feature requests and enhancement suggestions
  • Documentation improvements

We cannot help with:

  • General Node.js or npm troubleshooting (see their docs)
  • Corporate network/proxy configuration (consult your IT team)
  • Custom modifications to pair source code
  • Integration with third-party tools not mentioned in docs

Before Reporting Issues

  1. Check the FAQ first: The Installation FAQ covers 80%+ of issues
  2. Search existing issues: GitHub Issues
  3. Test with clean environment: Isolate the issue from other tools/configs

Escalation Path

Step 1: Self-Service

Step 2: Community Support

  • GitHub Discussions: pair Discussions
    • Best for: Usage questions, best practices, community tips
    • Response time: 1-3 days (community-driven)

Step 3: Issue Reporting

  • GitHub Issues: Create New Issue
    • Best for: Bug reports, feature requests, installation problems
    • Response time: 3-5 business days

Issue Reporting Template

When opening a GitHub issue, include:

**Environment:**
- OS: [macOS/Linux/Windows + version]
- Node.js version: [output of `node --version`]
- npm version: [output of `npm --version`]
- pnpm version: [output of `pnpm --version` or "not installed"]
 
**pair-cli Info:**
- Version: [output of `pair-cli --version` or "not installed"]
- Install method: [npm global/pnpm global/manual download]
 
**Issue Description:**
[Clear description of the problem]
 
**Steps to Reproduce:**
1. [First step]
2. [Second step]
 
**Expected Behavior:**
[What you expected to happen]
 
**Actual Behavior:**
[What actually happened]

Privacy and Data Redaction

Before sharing diagnostic output, remove:

  • Personal usernames and home directories
  • Corporate network configurations
  • API keys, tokens, or credentials
  • Internal company domain names

Contacts

On this page