---
title: "GitHub: the repo knows its project · Projectify"
description: "A Claude Code session in a GitHub repo finds its Projectify project from the remote. Claims carry the worktree and branch, and PRs land in the task outcome."
url: https://projectify.si/integrations/github
---

# GitHub and Projectify

Open a Claude Code session in the repo and it matches the remote to its project. A claim carries the worktree and branch it works in, other chats keep out of them, and the task's outcome names the PR.

## How it works

- **find_project.** The session passes every identifier it sees (the remote, URLs, names) and gets the project back. It never creates a second project for a repo that has one.
- **Claims carry the worktree.** claim_task takes the worktree and branch. Other chats are told to keep out, the room shows who touches what, and a lapsed claim frees them.
- **The repo block.** A CLAUDE.md block, added by Projectify, tells every session to start its Projectify session first and follow the project's Always lines.

## Set it up

1. **Link the repository.** Setup › Sources, or let the first session do it: find_project with the remote matches or imports the repo.
2. **Add the repo block.** Projectify writes the CLAUDE.md block and the .mcp.json entry so every session on the repo connects and reads the briefing first.
3. **Work in worktrees.** Each claim names its worktree and branch; the task ends with a PR against main in its outcome. Runs started by a routine never push to main.

## What your agents see

A session in the repo starts briefed, claims with its worktree and branch, posts in the room before touching shared code and ends with a handoff that names the PR.

Several sessions on one repo each hold their own claim and worktree; the Orchestrator sends the right chat to the next free task.

Other integrations: [claude.ai](https://projectify.si/integrations/claude-ai.md), [Claude Desktop](https://projectify.si/integrations/claude-desktop.md), [Trello](https://projectify.si/integrations/trello.md), [Monday](https://projectify.si/integrations/monday.md), [Azure DevOps](https://projectify.si/integrations/azure-devops.md), [Figma](https://projectify.si/integrations/figma.md), [Claude Code](https://projectify.si/claude-code.md).