[{"data":1,"prerenderedAt":553},["ShallowReactive",2],{"navigation_docs_en":3,"-en-guides-github":101,"-en-guides-github-surround":548},[4,26,51,84],{"title":5,"path":6,"stem":7,"children":8,"page":25},"Getting Started","/en/getting-started","en/1.getting-started",[9,13,17,21],{"title":10,"path":11,"stem":12},"Introduction","/en/getting-started/introduction","en/1.getting-started/1.introduction",{"title":14,"path":15,"stem":16},"Workspaces","/en/getting-started/workspaces","en/1.getting-started/2.workspaces",{"title":18,"path":19,"stem":20},"Projects","/en/getting-started/projects","en/1.getting-started/3.projects",{"title":22,"path":23,"stem":24},"Quick Start","/en/getting-started/quick-start","en/1.getting-started/quick-start",false,{"title":27,"path":28,"stem":29,"children":30,"page":25},"Features","/en/features","en/2.features",[31,35,39,43,47],{"title":32,"path":33,"stem":34},"Tasks","/en/features/tasks","en/2.features/1.tasks",{"title":36,"path":37,"stem":38},"Targets","/en/features/goals","en/2.features/2.goals",{"title":40,"path":41,"stem":42},"Documents","/en/features/documents","en/2.features/3.documents",{"title":44,"path":45,"stem":46},"Chat","/en/features/chat","en/2.features/4.chat",{"title":48,"path":49,"stem":50},"Inbox","/en/features/inbox","en/2.features/5.inbox",{"title":52,"path":53,"stem":54,"children":55,"page":25},"Guides","/en/guides","en/3.guides",[56,60,64,68,72,76,80],{"title":57,"path":58,"stem":59},"Settings","/en/guides/settings","en/3.guides/1.settings",{"title":61,"path":62,"stem":63},"Admin Panel","/en/guides/admin","en/3.guides/2.admin",{"title":65,"path":66,"stem":67},"Mobile & PWA","/en/guides/mobile","en/3.guides/3.mobile",{"title":69,"path":70,"stem":71},"Tips & Features","/en/guides/tips","en/3.guides/4.tips",{"title":73,"path":74,"stem":75},"Integrations","/en/guides/integrations","en/3.guides/5.integrations",{"title":77,"path":78,"stem":79},"GitHub","/en/guides/github","en/3.guides/6.github",{"title":81,"path":82,"stem":83},"MCP","/en/guides/mcp","en/3.guides/7.mcp",{"title":85,"path":86,"stem":87,"children":88,"page":25},"Reference","/en/reference","en/4.reference",[89,93,97],{"title":90,"path":91,"stem":92},"Pricing & Plans","/en/reference/pricing","en/4.reference/1.pricing",{"title":94,"path":95,"stem":96},"Getting Help","/en/reference/support","en/4.reference/2.support",{"title":98,"path":99,"stem":100},"Permissions & Roles","/en/reference/permissions-roles","en/4.reference/3.permissions-roles",{"id":102,"title":77,"body":103,"description":541,"extension":542,"links":543,"meta":544,"navigation":545,"path":78,"seo":546,"stem":79,"__hash__":547},"docs_en/en/3.guides/6.github.md",{"type":104,"value":105,"toc":522},"minimark",[106,111,115,120,133,161,168,173,176,179,197,201,204,219,223,234,238,245,249,252,269,273,324,331,335,338,342,349,376,379,393,397,400,461,467,471,474,478],[107,108,110],"h1",{"id":109},"github-integration","GitHub Integration",[112,113,114],"p",{},"Connect your GitHub repositories to Projectyl to create branches directly from tasks and automatically track pull requests through their lifecycle.",[116,117,119],"h2",{"id":118},"setup","Setup",[121,122,123,124,128,129,132],"note",{},"Only workspace ",[125,126,127],"strong",{},"Owners"," and ",[125,130,131],{},"Admins"," can connect GitHub.",[134,135,136,143,149,152,155,158],"ol",{},[137,138,139,140],"li",{},"Go to ",[125,141,142],{},"Settings → Integrations",[137,144,145,146],{},"Click ",[125,147,148],{},"Connect GitHub",[137,150,151],{},"You'll be redirected to GitHub to authorize the Projectyl GitHub App",[137,153,154],{},"Select the organization or personal account you want to connect",[137,156,157],{},"Choose which repositories to grant access to (you can change this later)",[137,159,160],{},"Confirm the installation",[112,162,163,164,167],{},"Once connected, the integration appears in your Settings with an ",[125,165,166],{},"Active"," status.",[169,170,172],"h3",{"id":171},"connecting-multiple-accounts","Connecting Multiple Accounts",[112,174,175],{},"You can connect multiple GitHub organizations or personal accounts to a single workspace. If you have several GitHub App installations, a picker dialog will appear after authorization so you can choose which account to connect.",[112,177,178],{},"To add another account after initial setup:",[134,180,181,185,194],{},[137,182,139,183],{},[125,184,142],{},[137,186,145,187,190,191],{},[125,188,189],{},"Install on another account"," in the connection picker, or ",[125,192,193],{},"Add GitHub Account",[137,195,196],{},"Follow the GitHub authorization flow and select the new account",[169,198,200],{"id":199},"managing-access","Managing Access",[112,202,203],{},"To change which repositories Projectyl can access after installation:",[134,205,206,210,216],{},[137,207,139,208],{},[125,209,142],{},[137,211,145,212,215],{},[125,213,214],{},"Manage"," next to your GitHub connection",[137,217,218],{},"This opens GitHub's installation settings for that specific account where you can add or remove repositories",[169,220,222],{"id":221},"suspended-connections","Suspended Connections",[112,224,225,226,229,230,233],{},"If your GitHub connection becomes ",[125,227,228],{},"suspended"," (e.g., due to billing or admin action on GitHub), click ",[125,231,232],{},"Unsuspend"," in Settings → Integrations. This will take you directly to the GitHub installation settings page where you can resolve the issue.",[169,235,237],{"id":236},"removing","Removing",[112,239,240,241,244],{},"To disconnect GitHub entirely, click ",[125,242,243],{},"Remove"," next to the connection. This removes the link between Projectyl and the GitHub installation but does not delete any branches or pull requests on GitHub.",[116,246,248],{"id":247},"setting-a-preferred-repository","Setting a Preferred Repository",[112,250,251],{},"You can set a default repository for each project so developers don't have to select one every time they create a branch.",[134,253,254,259,266],{},[137,255,256,257],{},"Open your project's ",[125,258,57],{},[137,260,261,262,265],{},"Under ",[125,263,264],{},"Preferred Repository",", select a repository from the dropdown",[137,267,268],{},"This repository will be pre-selected in the branch creation dialog",[116,270,272],{"id":271},"creating-branches-from-tasks","Creating Branches from Tasks",[134,274,275,278,285,290,319],{},[137,276,277],{},"Open a task's detail view",[137,279,280,281,284],{},"Scroll to the ",[125,282,283],{},"Development"," section",[137,286,145,287],{},[125,288,289],{},"Create Branch",[137,291,292,293],{},"In the dialog:\n",[294,295,296,302,308],"ul",{},[137,297,298,301],{},[125,299,300],{},"Repository"," — Select a repo (pre-filled if a preferred repository is set)",[137,303,304,307],{},[125,305,306],{},"Source Branch"," — The branch to create from (defaults to the repo's development branch or default branch)",[137,309,310,313,314,318],{},[125,311,312],{},"Branch Name"," — Auto-generated from the task key and title (e.g., ",[315,316,317],"code",{},"feat/PROJ-42-user-login","). You can edit this before creating.",[137,320,145,321],{},[125,322,323],{},"Create",[112,325,326,327,330],{},"The branch is created on GitHub immediately, and a ",[125,328,329],{},"Branched"," indicator appears in the Development section.",[116,332,334],{"id":333},"automatic-pr-tracking","Automatic PR Tracking",[112,336,337],{},"When a pull request is opened on GitHub, Projectyl automatically detects task references and links the PR to the corresponding tasks. No manual action is required.",[169,339,341],{"id":340},"how-task-keys-are-matched","How Task Keys Are Matched",[112,343,344,345,348],{},"Projectyl looks for task keys (e.g., ",[315,346,347],{},"PROJ-42",") in three places:",[294,350,351,360,368],{},[137,352,353,356,357],{},[125,354,355],{},"Branch name"," — ",[315,358,359],{},"fix/PROJ-42-login-bug",[137,361,362,356,365],{},[125,363,364],{},"PR title",[315,366,367],{},"feat: add login validation (PROJ-42)",[137,369,370,356,373],{},[125,371,372],{},"PR body",[315,374,375],{},"Fixes PROJ-42 and PROJ-43",[112,377,378],{},"A single PR can reference multiple tasks, and each will be linked automatically.",[121,380,381,382,385,386,388,389,392],{},"Task keys are case-sensitive and follow the format ",[315,383,384],{},"PREFIX-NUMBER",", matching your project's identifier (e.g., ",[315,387,347],{},", ",[315,390,391],{},"API-15",").",[116,394,396],{"id":395},"development-lifecycle","Development Lifecycle",[112,398,399],{},"Each linked branch/PR shows a three-stage progress indicator in the task's Development section:",[401,402,403,419],"table",{},[404,405,406],"thead",{},[407,408,409,413,416],"tr",{},[410,411,412],"th",{},"Stage",[410,414,415],{},"Trigger",[410,417,418],{},"What's Shown",[420,421,422,435,448],"tbody",{},[407,423,424,429,432],{},[425,426,427],"td",{},[125,428,329],{},[425,430,431],{},"Branch created from Projectyl",[425,433,434],{},"Branch name, repository",[407,436,437,442,445],{},[425,438,439],{},[125,440,441],{},"PR Open",[425,443,444],{},"PR opened on GitHub referencing the task",[425,446,447],{},"PR number, title, author",[407,449,450,455,458],{},[425,451,452],{},[125,453,454],{},"Merged",[425,456,457],{},"PR merged on GitHub",[425,459,460],{},"Merge date",[112,462,463,464,466],{},"If a PR is closed without merging, the stage reverts to ",[125,465,329],{},".",[116,468,470],{"id":469},"dismissing-links","Dismissing Links",[112,472,473],{},"To remove a development link from a task, click the dismiss button on the link. This only removes the link in Projectyl — it does not delete the branch or PR on GitHub.",[116,475,477],{"id":476},"permissions","Permissions",[401,479,480,490],{},[404,481,482],{},[407,483,484,487],{},[410,485,486],{},"Action",[410,488,489],{},"Required Role",[420,491,492,500,507,515],{},[407,493,494,497],{},[425,495,496],{},"Connect / disconnect GitHub",[425,498,499],{},"Owner or Admin",[407,501,502,505],{},[425,503,504],{},"Set preferred repository",[425,506,499],{},[407,508,509,512],{},[425,510,511],{},"Create branches from tasks",[425,513,514],{},"Any workspace member",[407,516,517,520],{},[425,518,519],{},"View development lifecycle",[425,521,514],{},{"title":523,"searchDepth":524,"depth":524,"links":525},"",2,[526,533,534,535,538,539,540],{"id":118,"depth":524,"text":119,"children":527},[528,530,531,532],{"id":171,"depth":529,"text":172},3,{"id":199,"depth":529,"text":200},{"id":221,"depth":529,"text":222},{"id":236,"depth":529,"text":237},{"id":247,"depth":524,"text":248},{"id":271,"depth":524,"text":272},{"id":333,"depth":524,"text":334,"children":536},[537],{"id":340,"depth":529,"text":341},{"id":395,"depth":524,"text":396},{"id":469,"depth":524,"text":470},{"id":476,"depth":524,"text":477},"Connect GitHub to create branches from tasks and automatically track pull requests.","md",null,{},true,{"title":77,"description":541},"BRXZfH2GUeXcJ4FpDCICgOD7PyujVjIRpf2tBS450sQ",[549,551],{"title":73,"path":74,"stem":75,"description":550,"children":-1},"Connect Projectyl with your development tools.",{"title":81,"path":82,"stem":83,"description":552,"children":-1},"Connect AI assistants like Claude Code and Cursor to your workspace using the Model Context Protocol.",1776307256978]