Skip to main content

@happyvertical/repos

Standardized repository interface for GitHub, GitLab, Bitbucket, and Azure DevOps.

Installation​

pnpm add @happyvertical/repos

Claude Code Context​

Install Claude Code context files for AI-assisted development:

npx have-repos-context

This copies the package's AGENT.md documentation and metadata.json metadata to your project's .claude/ directory, enabling Claude to provide better assistance when working with this package.

Usage​

import { getRepository } from '@happyvertical/repos';

// Create a GitHub repository client
const repo = await getRepository({
  type: 'github',
  owner: 'happyvertical',
  repo: 'sdk',
  token: process.env.GITHUB_TOKEN
});

// Get issue
const issue = await repo.getIssue(352);

// Add labels
await repo.addLabels(352, ['type: feature', 'priority: high', 'size: xl']);

// Post comment
await repo.addComment(352, '## 🤖 AI Triage\n\n**Type**: feature...');

// Search for duplicates
const duplicates = await repo.searchIssues('kanban automation', {
  state: 'open',
  labels: ['type: feature'],
});

Features​

  • Platform-agnostic: Works with GitHub, GitLab, Bitbucket, Azure DevOps
  • Type-safe: Full TypeScript support
  • Consistent API: Same interface across all platforms
  • Factory pattern: Simple getRepository() function
  • Comprehensive: Issues, PRs, labels, comments, assignments, search

API​

Issues​

  • getIssue(number) - Get issue details
  • createIssue(data) - Create new issue
  • updateIssue(number, data) - Update issue
  • closeIssue(number) - Close issue

Labels​

  • addLabels(issueNumber, labels) - Add labels to issue
  • removeLabel(issueNumber, label) - Remove label from issue
  • createLabel(label) - Create repository label
  • updateLabel(name, label) - Update existing label
  • listLabels() - List all repository labels

Comments​

  • addComment(issueNumber, body) - Add comment to issue
  • updateComment(commentId, body) - Update existing comment
  • deleteComment(commentId) - Delete comment
  • listComments(issueNumber) - List all comments on issue

Assignments​

  • assignIssue(issueNumber, assignees) - Assign users to issue
  • unassignIssue(issueNumber, assignees) - Unassign users from issue

Pull Requests​

  • getPullRequest(number) - Get PR details
  • createPullRequest(data) - Create new PR
  • mergePullRequest(number, method) - Merge PR
  • searchIssues(query, filters) - Search issues with filters

Node IDs (for Projects V2)​

  • getIssueNodeId(issueNumber) - Get GraphQL node ID for issue
  • getPRNodeId(prNumber) - Get GraphQL node ID for PR

Supported Platforms​

  • ✅ GitHub - Full support
  • ⏳ GitLab - Coming soon
  • ⏳ Bitbucket - Coming soon
  • ⏳ Azure DevOps - Coming soon

License​

MIT