[{"data":1,"prerenderedAt":567},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fboards":3,"docs-nav":281,"docs-updated":525,"site-nav-marketing":535},{"id":4,"title":5,"body":6,"description":269,"extension":270,"group":271,"icon":272,"meta":273,"navTitle":274,"navigation":275,"order":276,"path":277,"seo":278,"stem":279,"__hash__":280},"docs\u002Fdocs\u002Fboards.md","Boards from GitHub Projects",{"type":7,"value":8,"toc":254},"minimark",[9,22,35,40,64,69,76,80,83,113,120,124,142,146,199,203,210,214,231,235],[10,11,12,13,17,18,21],"p",{},"A ",[14,15,16],"strong",{},"Board"," tab lets you work a ",[14,19,20],{},"GitHub project"," — the boards, tables and roadmaps GitHub Projects gives an organization or a user — inside Plexus: attach it to a workspace or a project as a tool, and every one of its views opens in the tab.",[10,23,24,25,30,31,34],{},"Like the ",[26,27,29],"a",{"href":28},"\u002Fdocs\u002Fissues","Issues"," tab, everything here goes ",[14,32,33],{},"from your machine to GitHub"," with the account you connected, and nothing about it reaches us.",[36,37,39],"h2",{"id":38},"attaching-a-project","Attaching a project",[10,41,42,43,47,48,51,52,55,56,59,60,63],{},"Open the ",[26,44,46],{"href":45},"\u002Fdocs\u002Ftoolchain","Toolchain"," page from the ",[14,49,50],{},"Settings"," button at the right end of the tab strip, press ",[14,53,54],{},"Install"," on the ",[14,57,58],{},"GitHub Projects"," card, and pick the project. The picker lists the projects of the repository's owner when the scope has a repository on GitHub, and lets you type any user or organization to list theirs. A ",[14,61,62],{},"Board · Roadmap"," tab appears on the strip, named after the project.",[65,66,68],"h3",{"id":67},"access-to-projects","Access to projects",[10,70,71,72,75],{},"GitHub keeps projects behind a permission of their own that a repository connection does not carry. A GitHub connection made before Plexus asked for it lacks it, and the picker — or the Board tab, if the connection changed later — says so and offers ",[14,73,74],{},"Reconnect GitHub",". Reconnecting is enough: GitHub grants the permissions Plexus asks for, and the boards load once you are back. Nobody is asked to reconnect until they attach a project, and a connection with no project attached is left exactly as it was.",[36,77,79],{"id":78},"the-board-tab","The Board tab",[10,81,82],{},"The tab opens on the project's first view and lists every view along its top, in the order GitHub shows them; pick one to switch, and the choice is remembered per tool.",[84,85,86,101,107],"ul",{},[87,88,12,89,92,93,96,97,100],"li",{},[14,90,91],{},"board"," view renders as columns — one per option of the field the view groups by, usually ",[14,94,95],{},"Status",", plus a ",[14,98,99],{},"No Status"," column for cards without a value — with the project's cards inside. A view grouped by something Plexus cannot lay out as columns renders as a table instead and says so.",[87,102,12,103,106],{},[14,104,105],{},"table"," view renders the columns the view shows on GitHub.",[87,108,12,109,112],{},[14,110,111],{},"roadmap"," view renders as a table too; Plexus does not draw the timeline.",[10,114,115,116,119],{},"A card shows the item's kind (an issue, a pull request, or a draft), its number and repository, its title, its labels and who is assigned. Click a card to open the issue behind it — the same view the Issues tab opens, with the same editing; a draft opens read-only, since a draft has no issue, and a pull request opens on GitHub. Every issue card has ",[14,117,118],{},"Start session",", which opens the New session dialog exactly as the Issues tab does, linked to the issue.",[65,121,123],{"id":122},"dragging-cards","Dragging cards",[10,125,126,127,129,130,137,138,141],{},"Drag a card to another column and its field changes on GitHub — the card moves at once and comes back with a message if GitHub refused. The one column you cannot drop into is ",[14,128,99],{}," (or ",[131,132,133,134],"em",{},"No ",[135,136],"field",{},"): clearing a field is not something Plexus does, so do that on GitHub. Drag a card up or down within a column and its position in the project changes the same way. Position is something GitHub keeps per project, not per view, so a view that is ",[14,139,140],{},"sorted"," by a field has nothing for a reorder to mean: on such a view cards can still move between columns but not within one, and the tab says why when you try.",[65,143,145],{"id":144},"the-views-filter","The view's filter",[10,147,148,149,153,154,157,158,161,162,165,166,161,169,161,172,175,176,179,180,183,184,187,188,183,191,194,195,198],{},"A GitHub view can carry a filter — ",[150,151,152],"code",{},"is:issue status:\"In progress\" -label:blocked",". GitHub does not send Plexus a filtered list; it sends the filter, and Plexus applies it itself. The common parts are understood — ",[150,155,156],{},"is:"," (issue, pr, draft, open, closed), ",[150,159,160],{},"label:",", ",[150,163,164],{},"assignee:"," including ",[150,167,168],{},"@me",[150,170,171],{},"no:assignee",[150,173,174],{},"no:label",", any single-select field by its name such as ",[150,177,178],{},"status:",", quoted values, ",[150,181,182],{},","," for ",[131,185,186],{},"or",", and ",[150,189,190],{},"-",[131,192,193],{},"not",". Anything else is left out, and the tab says ",[14,196,197],{},"Filter partly applied"," and names the parts it skipped, so a board never quietly shows fewer cards than GitHub does without saying so.",[65,200,202],{"id":201},"how-often-it-refreshes","How often it refreshes",[10,204,205,206,209],{},"A board asks GitHub again about every two minutes while Plexus is the focused window, every ten minutes while it is merely visible, and not at all while hidden; ",[14,207,208],{},"Refresh"," asks now, and every change you make refreshes it. Projects are more expensive to ask about than issues, which is why the pace is slower than the Issues tab's. Rate limits and a rejected token are shown in a line above the board, as on the Issues tab.",[36,211,213],{"id":212},"what-a-plan-gates","What a plan gates",[10,215,216,217,221,222,225,226,230],{},"The Board tab is behind the same ",[26,218,220],{"href":219},"\u002Fdocs\u002Fbilling","plan"," as the Issues tab — everything in it goes from your machine to GitHub with your own token. Attaching a project, the picker and the ",[14,223,224],{},"Share with projects"," switch stay free; see ",[26,227,229],{"href":228},"\u002Fdocs\u002Fissues#what-a-plan-gates","Issues — What a plan gates",".",[36,232,234],{"id":233},"related","Related",[84,236,237,242,247],{},[87,238,239,241],{},[26,240,46],{"href":45}," — attaching tools and sharing them across a workspace",[87,243,244,246],{},[26,245,29],{"href":28}," — the issue view behind every card, and starting a session",[87,248,249,253],{},[26,250,252],{"href":251},"\u002Fdocs\u002Fconnections","Git providers"," — the GitHub connection the boards run on",{"title":255,"searchDepth":256,"depth":256,"links":257},"",2,[258,262,267,268],{"id":38,"depth":256,"text":39,"children":259},[260],{"id":67,"depth":261,"text":68},3,{"id":78,"depth":256,"text":79,"children":263},[264,265,266],{"id":122,"depth":261,"text":123},{"id":144,"depth":261,"text":145},{"id":201,"depth":261,"text":202},{"id":212,"depth":256,"text":213},{"id":233,"depth":256,"text":234},"Work a GitHub Projects board inside Plexus: attach it to a workspace or project, switch views, drag cards, open the issue behind a card, start a session.","md","Integrations","SquareKanban",{},"Boards",true,50,"\u002Fdocs\u002Fboards",{"title":5,"description":269},"docs\u002Fboards","iKIqQfd25nbUpKxHqC6trqnrAncwUt0z5A59bN2rd94",[282,289,294,299,305,312,318,325,332,339,347,353,360,367,374,381,387,394,398,404,410,418,425,431,438,443,450,456,463,470,476,482,488,493,498,499,506,511,518],{"path":283,"title":284,"navTitle":284,"description":285,"icon":286,"group":287,"order":288},"\u002Fdocs","Introduction","Plexus runs Claude Code sessions in parallel, each in its own git worktree, in one native desktop app with diff review, a git client and hooks built in.","BookOpen","Overview",1,{"path":290,"title":291,"navTitle":54,"description":292,"icon":293,"group":287,"order":256},"\u002Fdocs\u002Finstall","Installation","Download and install Plexus on macOS (Apple Silicon or Intel), Linux (.deb or AppImage) or Windows, check Claude Code and Git, and get automatic updates.","Download",{"path":295,"title":296,"navTitle":296,"description":297,"icon":298,"group":287,"order":261},"\u002Fdocs\u002Frequirements","Requirements","What Plexus needs on your machine: the Claude Code CLI and Git, plus optional GitHub or Bitbucket access, notify-send on Linux, and supported platforms.","Check",{"path":300,"title":301,"navTitle":301,"description":302,"icon":303,"group":287,"order":304},"\u002Fdocs\u002Fgetting-started","Getting started","Your first run of Plexus: add a git repository, create a session in its own worktree, start Claude Code and send your first prompt.","Rocket",4,{"path":306,"title":307,"navTitle":308,"description":309,"icon":310,"group":287,"order":311},"\u002Fdocs\u002Fconcepts","Core concepts","Concepts","Workspaces, projects and sessions in Plexus — each session usually its own git worktree running Claude Code — and the two status indicators on every row.","Boxes",5,{"path":313,"title":314,"navTitle":314,"description":315,"icon":316,"group":287,"order":317},"\u002Fdocs\u002Farchitecture","Architecture","How Plexus is built: a Tauri desktop app with a Vue UI and a Rust backend that wraps the Claude Code CLI, runs git natively and keeps your code local.","Package",6,{"path":319,"title":320,"navTitle":320,"description":321,"icon":322,"group":323,"order":324},"\u002Fdocs\u002Fdashboard","Dashboard","One live table of every Claude Code session across your Plexus workspaces, with activity state, PR status, summary counts, filters and sorting.","LayoutGrid","Working with projects",10,{"path":326,"title":327,"navTitle":328,"description":329,"icon":330,"group":323,"order":331},"\u002Fdocs\u002Fproject-git","Project Git client","Git GUI","A full git GUI for a project's main checkout: commit graph with branches, tags, stashes and worktrees, pull, push, line staging, compare, blame, history rewrites, undo and conflict resolution.","GitGraph",11,{"path":333,"title":334,"navTitle":335,"description":336,"icon":337,"group":323,"order":338},"\u002Fdocs\u002Fproject-terminal","Project Terminal","Terminal","Open plain shell terminals in a project's root folder from the project view. They keep running in the background, so a dev server or file watcher stays up.","MonitorDot",12,{"path":340,"title":341,"navTitle":342,"description":343,"icon":344,"group":345,"order":346},"\u002Fdocs\u002Fsessions","Sessions & worktrees","Sessions","Create a Plexus session — one Claude Code agent in its own git worktree, on a new or existing branch — and start, stop, resume, archive or remove it.","Bot","Working with sessions",20,{"path":348,"title":349,"navTitle":95,"description":350,"icon":351,"group":345,"order":352},"\u002Fdocs\u002Fstatus","Status & notifications","What Plexus's status dots and PR colors mean — working, waiting, idle, background work — and the alerts you get when a Claude Code session needs you.","Activity",21,{"path":354,"title":355,"navTitle":356,"description":357,"icon":358,"group":345,"order":359},"\u002Fdocs\u002Fagent","The Agent tab","Agent","The Agent tab is the Claude Code terminal in every session: send prompts, paste images, compose multi-line input, rewind, and choose the permission mode.","Sparkles",22,{"path":361,"title":362,"navTitle":363,"description":364,"icon":365,"group":345,"order":366},"\u002Fdocs\u002Fexplorer","Explorer & editor","Explorer","Browse a session's git worktree and edit files in the built-in Monaco editor, with tabs, change markers against the base branch and a Markdown preview.","FileText",23,{"path":368,"title":369,"navTitle":370,"description":371,"icon":372,"group":345,"order":373},"\u002Fdocs\u002Freview","Review & diffs","Review","Review a Claude Code session's changes as a PR-style diff, leave inline comments the agent acts on, run an AI code review and answer PR threads.","GitPullRequestArrow",24,{"path":375,"title":376,"navTitle":377,"description":378,"icon":379,"group":345,"order":380},"\u002Fdocs\u002Fgit","Git workflow","Session Git","The session Git tab lets you stage, commit, stash and push, and rebase, merge or squash a Claude Code session's branch, with AI-drafted commit messages.","GitMerge",25,{"path":382,"title":383,"navTitle":383,"description":384,"icon":385,"group":345,"order":386},"\u002Fdocs\u002Fpull-requests","Pull requests","Open a GitHub or Bitbucket pull request from a session's branch, let AI draft the title and description, and track PR and CI status without leaving Plexus.","Github",26,{"path":388,"title":389,"navTitle":390,"description":391,"icon":392,"group":345,"order":393},"\u002Fdocs\u002Fstacks","Stacks & ordered merging","Stacks & merging","Stack Claude Code sessions on each other's branches, keep every branch synced as the stack moves, see the whole stack as a map, and merge a stack — or a list of pull requests — in order, including through GitHub's and Bitbucket's merge queues.","Layers",27,{"path":395,"title":335,"navTitle":335,"description":396,"icon":337,"group":345,"order":397},"\u002Fdocs\u002Fterminal","Open plain shell terminals in a session's git worktree with ⌘J: several tabs, copy and paste, drag-and-drop file paths, and your choice of shell.",28,{"path":399,"title":400,"navTitle":400,"description":401,"icon":402,"group":345,"order":403},"\u002Fdocs\u002Fsplit-view","Split view","Put up to six sessions of one project side by side in a split view: each pane is a full session with its own tabs, and every agent keeps running whether its pane is on screen or not.","Grid2x2",29,{"path":405,"title":406,"navTitle":406,"description":407,"icon":408,"group":345,"order":409},"\u002Fdocs\u002Fwindows","Multiple windows","Open a session, a project, a single terminal or the dashboard in a window of its own: put an agent on a second monitor and keep the main window for everything else.","AppWindow",30,{"path":411,"title":412,"navTitle":413,"description":414,"icon":415,"group":416,"order":417},"\u002Fdocs\u002Fhooks","Lifecycle hooks","Hooks","Run your own shell scripts when a session's git worktree is created, when the agent starts, and at teardown — set globally, per project or in the repo.","RefreshCw","Automation",31,{"path":419,"title":420,"navTitle":421,"description":422,"icon":423,"group":416,"order":424},"\u002Fdocs\u002Fworktrees","Worktrees & env files","Worktrees & env","Where Plexus puts each session's git worktree, how .env and other gitignored files are copied in, and the block of dev server ports every session gets.","FolderGit2",32,{"path":426,"title":427,"navTitle":427,"description":428,"icon":429,"group":416,"order":430},"\u002Fdocs\u002Fsecrets","Secrets","Plexus keeps secrets in your OS keychain — macOS Keychain, Windows Credential Manager or Linux Secret Service — write-only, and out of every hook it runs.","KeyRound",33,{"path":432,"title":433,"navTitle":434,"description":435,"icon":436,"group":416,"order":437},"\u002Fdocs\u002Fprompts","Prompt templates","Prompts","Save Claude Code prompts you keep rewriting as templates with fill-in fields — text, choices, files, branches — and run them in a new or a running session.","Copy",34,{"path":251,"title":439,"navTitle":252,"description":440,"icon":441,"group":271,"order":442},"Connecting a git provider","Connect GitHub or Bitbucket to Plexus with a one-click browser sign-in, no personal access token, to open pull requests, clone repos and push over https.","PlugZap",40,{"path":444,"title":445,"navTitle":446,"description":447,"icon":448,"group":271,"order":449},"\u002Fdocs\u002Faccount","Your Plexus account","Plexus account","Create a free, optional Plexus account to set up organizations, manage signed-in devices and turn on cross-device sync. The app works the same without one.","UsersRound",41,{"path":219,"title":451,"navTitle":452,"description":453,"icon":454,"group":271,"order":455},"Plans, seats and billing","Billing","What a paid Plexus plan unlocks, individual and per-seat organization plans, buying through Moneybird, invitations, invoices and VAT, and cancelling.","CreditCard",42,{"path":457,"title":458,"navTitle":459,"description":460,"icon":461,"group":271,"order":462},"\u002Fdocs\u002Fsync","Cross-device sync","Sync","Sync your Plexus settings, workspaces and projects to every machine you sign in on, after a preview of exactly what would leave this one.","Cloud",43,{"path":464,"title":465,"navTitle":466,"description":467,"icon":468,"group":271,"order":469},"\u002Fdocs\u002Froles","Roles and permissions","Roles","Control what each member of a Plexus organization may do: five built-in roles, custom roles you copy and edit, and how roles combine. Free, on the web.","ShieldCheck",44,{"path":471,"title":472,"navTitle":472,"description":473,"icon":474,"group":271,"order":475},"\u002Fdocs\u002Fshared-workspaces","Shared workspaces","Set up a workspace once in a Plexus organization so every member gets the same repositories in their sidebar: join modes, leaving, cloning, and seats.","Building2",45,{"path":477,"title":478,"navTitle":478,"description":479,"icon":480,"group":271,"order":481},"\u002Fdocs\u002Fmanaged-settings","Managed settings","Let a Plexus organization recommend, enforce or dry-run settings on members' machines: the three levels, locked rows, eligible settings and offline rules.","Lock",46,{"path":483,"title":484,"navTitle":485,"description":486,"icon":436,"group":271,"order":487},"\u002Fdocs\u002Forg-prompts","Prompts your organization publishes","Organization prompts","Publish Claude Code prompt templates to every member of a Plexus organization as numbered revisions: proposing, publishing, rolling back, limits and seats.",47,{"path":28,"title":489,"navTitle":29,"description":490,"icon":491,"group":271,"order":492},"Issues from your tracker","Read, edit and create a project's GitHub issues inside Plexus with your own GitHub account, and start a Claude Code session that stays linked to an issue. Plnnrly has a page of its own.","CircleDot",48,{"path":45,"title":494,"navTitle":46,"description":495,"icon":496,"group":271,"order":497},"The Toolchain","Attach GitHub issues, GitHub Projects boards and Plnnrly projects to a workspace or project as tabs in Plexus, and choose whether a workspace shares each with its projects.","Wrench",49,{"path":277,"title":5,"navTitle":274,"description":269,"icon":272,"group":271,"order":276},{"path":500,"title":501,"navTitle":502,"description":503,"icon":504,"group":271,"order":505},"\u002Fdocs\u002Fplnnrly","Plnnrly work items, boards and sprints","Plnnrly","Connect a Plnnrly organization and work a Plnnrly project inside Plexus: its backlog, board and sprints, every work item editable, and a session started from any of them.","ClipboardList",51,{"path":507,"title":50,"navTitle":50,"description":508,"icon":50,"group":509,"order":510},"\u002Fdocs\u002Fsettings","Every Plexus setting and its default, and how settings layer from global to workspace, project and session — including organization-enforced values.","Reference",52,{"path":512,"title":513,"navTitle":514,"description":515,"icon":516,"group":509,"order":517},"\u002Fdocs\u002Fshortcuts","Keyboard shortcuts","Shortcuts","Every Plexus keyboard shortcut — session tabs, terminal and dashboard, ⌘K search, stack layers, the Claude Code prompt, rebase and squash, project Git undo — and how to rebind each.","Keyboard",53,{"path":519,"title":520,"navTitle":521,"description":522,"icon":523,"group":509,"order":524},"\u002Fdocs\u002Ffeedback","Sending feedback","Feedback","Send a bug report or idea to the Plexus team from inside the app, with an optional screenshot and diagnostic logs you can preview before anything is sent.","SquarePen",54,{"\u002Fdocs\u002Faccount":526,"\u002Fdocs\u002Fagent":527,"\u002Fdocs\u002Farchitecture":527,"\u002Fdocs\u002Fbilling":526,"\u002Fdocs\u002Fboards":527,"\u002Fdocs\u002Fconcepts":528,"\u002Fdocs\u002Fconnections":529,"\u002Fdocs\u002Fdashboard":526,"\u002Fdocs\u002Fexplorer":530,"\u002Fdocs\u002Ffeedback":528,"\u002Fdocs\u002Fgetting-started":531,"\u002Fdocs\u002Fgit":526,"\u002Fdocs\u002Fhooks":532,"\u002Fdocs":527,"\u002Fdocs\u002Finstall":527,"\u002Fdocs\u002Fissues":528,"\u002Fdocs\u002Fmanaged-settings":530,"\u002Fdocs\u002Forg-prompts":530,"\u002Fdocs\u002Fplnnrly":528,"\u002Fdocs\u002Fproject-git":529,"\u002Fdocs\u002Fproject-terminal":533,"\u002Fdocs\u002Fprompts":532,"\u002Fdocs\u002Fpull-requests":526,"\u002Fdocs\u002Frequirements":531,"\u002Fdocs\u002Freview":530,"\u002Fdocs\u002Froles":527,"\u002Fdocs\u002Fsecrets":532,"\u002Fdocs\u002Fsessions":526,"\u002Fdocs\u002Fsettings":526,"\u002Fdocs\u002Fshared-workspaces":530,"\u002Fdocs\u002Fshortcuts":534,"\u002Fdocs\u002Fsplit-view":526,"\u002Fdocs\u002Fstacks":526,"\u002Fdocs\u002Fstatus":526,"\u002Fdocs\u002Fsync":526,"\u002Fdocs\u002Fterminal":533,"\u002Fdocs\u002Ftoolchain":528,"\u002Fdocs\u002Fwindows":532,"\u002Fdocs\u002Fworktrees":532},"2026-10-16","2026-10-06","2026-10-15","2026-10-22","2026-10-09","2026-10-11","2026-10-14","2026-10-13","2026-10-19",{"features":536,"compare":554},[537,540,542,545,548,551],{"label":538,"to":539},"Sessions & status","\u002Ffeatures\u002Fsessions-and-status",{"label":370,"to":541},"\u002Ffeatures\u002Freview",{"label":543,"to":544},"Worktrees & hooks","\u002Ffeatures\u002Fworktrees-and-hooks",{"label":546,"to":547},"Git & issues","\u002Ffeatures\u002Fgit-and-issues",{"label":549,"to":550},"Stacks","\u002Ffeatures\u002Fstacks",{"label":552,"to":553},"Teams","\u002Ffeatures\u002Fteams",[555,558,561,564],{"label":556,"to":557},"vs Claude Code","\u002Fcompare\u002Fclaude-code",{"label":559,"to":560},"vs Claude Squad and Nimbalyst","\u002Fcompare\u002Fclaude-squad-and-nimbalyst",{"label":562,"to":563},"vs Conductor","\u002Fcompare\u002Fconductor",{"label":565,"to":566},"vs Cursor","\u002Fcompare\u002Fcursor",1792695509020]