[{"data":1,"prerenderedAt":337},["ShallowReactive",2],{"legal:gitlab-issues:support":3,"legal:gitlab-issues:parent":258},{"id":4,"title":5,"body":6,"description":247,"extension":248,"lastUpdated":249,"meta":250,"navigation":251,"pageType":252,"parentSlug":253,"path":254,"seo":255,"stem":256,"__hash__":257},"legals\u002Flegals\u002Fgitlab-issues\u002Fsupport.md","Support — GitLab Issues",{"type":7,"value":8,"toc":224},"minimark",[9,19,24,29,75,78,82,95,99,103,106,110,113,117,129,137,141,152,156,159,163,166,170,174,180,184,187,191,198,202,205,221],[10,11,12,13,18],"p",{},"Stuck on something? Most things are covered here. If not, email ",[14,15,17],"a",{"href":16},"mailto:larry@lostendfound.com","larry@lostendfound.com",".",[20,21,23],"h2",{"id":22},"getting-started","Getting started",[25,26,28],"h3",{"id":27},"connecting-a-gitlab-instance","Connecting a GitLab instance",[30,31,32,41,53,68],"ol",{},[33,34,35,36,40],"li",{},"Open the app and click ",[37,38,39],"strong",{},"Add Instance"," in the sidebar.",[33,42,43,44,48,49,52],{},"Enter the base URL of your GitLab instance — ",[45,46,47],"code",{},"https:\u002F\u002Fgitlab.com"," for the SaaS version, or your self-hosted URL (e.g. ",[45,50,51],{},"https:\u002F\u002Fgitlab.acme.internal",").",[33,54,55,56,59,60,63,64,67],{},"Paste a ",[37,57,58],{},"personal access token"," with at least the ",[45,61,62],{},"read_api"," scope. Add ",[45,65,66],{},"api"," if you want to comment, change labels, or edit issues from inside the app.",[33,69,70,71,74],{},"Click ",[37,72,73],{},"Connect",". The token is saved to the macOS Keychain.",[10,76,77],{},"You can connect as many instances as you like and switch between them from the sidebar.",[25,79,81],{"id":80},"creating-a-personal-access-token","Creating a personal access token",[10,83,84,85,88,89,91,92,94],{},"In GitLab: ",[37,86,87],{},"User Settings → Access Tokens",". Pick ",[45,90,62],{}," for read-only use or ",[45,93,66],{}," for full edit access. The app needs no other scopes.",[20,96,98],{"id":97},"common-questions","Common questions",[25,100,102],{"id":101},"does-the-app-work-with-self-hosted-gitlab","Does the app work with self-hosted GitLab?",[10,104,105],{},"Yes. Any GitLab Community Edition or Enterprise Edition install reachable from your Mac. If your instance is behind a VPN, make sure the VPN is connected before opening the app.",[25,107,109],{"id":108},"does-it-work-with-gitea-forgejo-or-github","Does it work with Gitea, Forgejo, or GitHub?",[10,111,112],{},"Not yet. The app speaks GitLab's REST and GraphQL APIs specifically.",[25,114,116],{"id":115},"where-does-the-app-keep-my-data","Where does the app keep my data?",[118,119,120,126],"ul",{},[33,121,122,123],{},"Issue caches → ",[45,124,125],{},"~\u002FLibrary\u002FApplication Support\u002FGitLab Issues\u002F",[33,127,128],{},"Tokens → macOS Keychain (under the app's bundle identifier)",[10,130,131,132,136],{},"Nothing leaves your Mac except the requests you'd make in a browser. See the ",[14,133,135],{"href":134},"\u002Fgitlab-issues\u002Fprivacy","Privacy Policy"," for details.",[25,138,140],{"id":139},"my-issues-arent-showing-up","My issues aren't showing up",[118,142,143,146,149],{},[33,144,145],{},"Check the instance is reachable: open its URL in Safari.",[33,147,148],{},"Confirm the token isn't expired (GitLab → User Settings → Access Tokens).",[33,150,151],{},"Pull-to-refresh on the issue list, or use ⌘R.",[25,153,155],{"id":154},"how-do-i-switch-between-assigned-opened-closed-views","How do I switch between assigned \u002F opened \u002F closed views?",[10,157,158],{},"The filter bar at the top of the issue list. Common filters have shortcuts: ⌘1 (assigned), ⌘2 (opened by me), ⌘3 (mentioned), ⌘4 (all open).",[25,160,162],{"id":161},"can-i-create-a-new-issue","Can I create a new issue?",[10,164,165],{},"Yes — ⌘N from any view. Pick a project, write title and body, set labels\u002Fassignee\u002Fmilestone, then ⌘↩ to submit.",[20,167,169],{"id":168},"troubleshooting","Troubleshooting",[25,171,173],{"id":172},"could-not-authenticate-error","\"Could not authenticate\" error",[10,175,176,177,179],{},"Your token is wrong, expired, or missing the ",[45,178,62],{}," scope. Regenerate it on GitLab and update the instance settings in the app.",[25,181,183],{"id":182},"app-is-slow-on-a-large-instance","App is slow on a large instance",[10,185,186],{},"Use the per-instance settings to scope the projects the app indexes — pin only the projects you actually work in instead of fetching every project you can see.",[25,188,190],{"id":189},"keyboard-shortcuts-cheatsheet","Keyboard shortcuts cheatsheet",[10,192,193,194,197],{},"Press ",[45,195,196],{},"⌘?"," anywhere in the app for the full list.",[20,199,201],{"id":200},"contact","Contact",[10,203,204],{},"For anything not covered above:",[118,206,207,215],{},[33,208,209,212,213],{},[37,210,211],{},"Email:"," ",[14,214,17],{"href":16},[33,216,217,220],{},[37,218,219],{},"Bug reports \u002F feature requests:"," include your GitLab version (CE\u002FEE and version number), macOS version, and steps to reproduce. Screenshots help.",[10,222,223],{},"Replies typically within two business days.",{"title":225,"searchDepth":226,"depth":226,"links":227},"",3,[228,233,241,246],{"id":22,"depth":229,"text":23,"children":230},2,[231,232],{"id":27,"depth":226,"text":28},{"id":80,"depth":226,"text":81},{"id":97,"depth":229,"text":98,"children":234},[235,236,237,238,239,240],{"id":101,"depth":226,"text":102},{"id":108,"depth":226,"text":109},{"id":115,"depth":226,"text":116},{"id":139,"depth":226,"text":140},{"id":154,"depth":226,"text":155},{"id":161,"depth":226,"text":162},{"id":168,"depth":229,"text":169,"children":242},[243,244,245],{"id":172,"depth":226,"text":173},{"id":182,"depth":226,"text":183},{"id":189,"depth":226,"text":190},{"id":200,"depth":229,"text":201},"Help, common questions, and troubleshooting for GitLab Issues on macOS.","md","May 2026",{},true,"support","gitlab-issues","\u002Flegals\u002Fgitlab-issues\u002Fsupport",{"title":5,"description":247},"legals\u002Fgitlab-issues\u002Fsupport","30Bp2pBRToaPsYJOpa6HaOujKDoThz059TYd-DJi3FA",{"id":259,"appName":260,"appStoreUrl":261,"cta":262,"extension":269,"features":270,"hero":303,"howItWorks":307,"meta":308,"privacyCallout":310,"requirements":307,"screenshotShowcase":314,"seo":318,"slug":253,"stem":321,"supportedFormats":307,"targetUsers":322,"whatsNew":307,"__hash__":336},"landings\u002Flandings\u002Fgitlab-issues.json","GitLab Issues","https:\u002F\u002Fapps.apple.com\u002Fus\u002Fapp\u002Fissues-tracker-for-gitlab\u002Fid6759206191?mt=12",{"title":263,"subtitle":264,"primaryCta":265,"additionalInfo":268},"Ready to try it?","Download GitLab Issues from the Mac App Store.",{"label":266,"href":261,"external":251,"badge":267},"Download on the Mac App Store","mac-app-store","One-time purchase. No subscription.","json",{"title":271,"columns":226,"items":272},"Everything you need to manage issues",[273,278,283,288,293,298],{"title":274,"description":275,"icon":276,"iconColor":277},"Native macOS App","Built with SwiftUI for a fast, responsive experience. No Electron, no web views — pure native performance.","i-lucide-monitor","blue",{"title":279,"description":280,"icon":281,"iconColor":282},"Multi-Instance Support","Connect to GitLab.com and any number of self-hosted GitLab instances. Switch between them instantly.","i-lucide-server","green",{"title":284,"description":285,"icon":286,"iconColor":287},"Full Markdown Rendering","Issue descriptions and comments render with full markdown support including code blocks, tables, and links.","i-lucide-file-text","purple",{"title":289,"description":290,"icon":291,"iconColor":292},"Keyboard-Driven","Command palette, keyboard shortcuts for everything. Navigate issues without touching your mouse.","i-lucide-keyboard","orange",{"title":294,"description":295,"icon":296,"iconColor":297},"Powerful Filtering","Filter by state, labels, assignee, milestone. Full-text search across all your issues.","i-lucide-filter","red",{"title":299,"description":300,"icon":301,"iconColor":302},"Offline Cache","Issues are cached locally so you can browse them even when offline. Syncs when you reconnect.","i-lucide-database","yellow",{"headline":260,"subtitle":304,"primaryCta":305,"additionalInfo":306},"Your GitLab issues, native on Mac. Browse, search and manage issues across all your instances.",{"label":266,"href":261,"external":251,"badge":267},"$9.99 one-time purchase • macOS 14+",null,{"$schema":309},"..\u002F..\u002F.nuxt\u002Fcontent\u002Flandings.schema.json",{"title":311,"headline":312,"description":313},"Privacy First","Your data stays on your Mac","Tokens are stored in the macOS Keychain. Issues are cached locally. No analytics, no tracking, no third-party services.",{"src":315,"alt":316,"frame":317},"\u002Fimg\u002Fgitlab-issues\u002Fhero.png","GitLab Issues app showing issue list with detail panel and metadata sidebar","macos",{"title":319,"description":320},"GitLab Issues — lost end found","A fast, native macOS app for browsing and managing GitLab issues. Supports self-hosted instances. Keyboard-driven.","landings\u002Fgitlab-issues",{"title":323,"items":324},"Built for GitLab power users",[325,329,333],{"title":326,"description":327,"icon":328,"iconColor":277},"Developers","Stop context-switching to the browser. Browse and manage issues right from your Mac.","i-lucide-code",{"title":330,"description":331,"icon":332,"iconColor":282},"Project Managers","Track issues across multiple projects and instances. Stay on top of what matters.","i-lucide-clipboard-list",{"title":334,"description":335,"icon":281,"iconColor":292},"Self-Hosted Users","First-class support for self-hosted GitLab. Connect with a personal access token or OAuth.","QO3kI2k_pjomUsBDQ0yjLgdXjaV6s-qkwAzI1igUlJ4",1783603474210]