[{"data":1,"prerenderedAt":379},["ShallowReactive",2],{"doc:en:\u002Fusing-zekoder\u002Fprojects-and-workspaces":3,"navigation:en":291,"surround:en:\u002Fusing-zekoder\u002Fprojects-and-workspaces":374},{"page":4,"fallback":290},{"id":5,"title":6,"body":7,"description":281,"extension":282,"meta":283,"navigation":284,"path":286,"seo":287,"stem":288,"__hash__":289},"docs_en\u002Fusing-zekoder\u002Fprojects-and-workspaces.md","Projects and workspaces",{"type":8,"value":9,"toc":273},"minimark",[10,23,28,52,56,67,159,165,168,172,175,212,231,246,250,257,266],[11,12,13,14,18,19,22],"p",{},"A ",[15,16,17],"strong",{},"project"," is a git repository on a host. A ",[15,20,21],{},"workspace"," is one place inside that project where agents and terminals work: either the project folder itself or a separate git worktree. The sidebar lists projects with their workspaces under them.",[24,25,27],"h2",{"id":26},"add-a-project","Add a project",[11,29,30,31,34,35,39,40,43,44,47,48,51],{},"Select ",[15,32,33],{},"Add project"," at the bottom of the sidebar, or press ",[36,37,38],"code",{},"Cmd+O"," (",[36,41,42],{},"Ctrl+O"," on Windows and Linux). Type to search folders on the host, select ",[15,45,46],{},"Browse…",", or paste a path and select ",[15,49,50],{},"Open path",".",[24,53,55],{"id":54},"create-a-workspace","Create a workspace",[11,57,58,59,62,63,66],{},"Press ",[36,60,61],{},"Cmd+N"," or select ",[15,64,65],{},"New workspace"," on a project. The form has:",[68,69,70,83],"table",{},[71,72,73],"thead",{},[74,75,76,80],"tr",{},[77,78,79],"th",{},"Field",[77,81,82],{},"What it does",[84,85,86,101,118,128,138],"tbody",{},[74,87,88,98],{},[89,90,91,94,95],"td",{},[15,92,93],{},"Project",", ",[15,96,97],{},"Host",[89,99,100],{},"Where the workspace lives.",[74,102,103,108],{},[89,104,105],{},[15,106,107],{},"Isolation",[89,109,110,113,114,117],{},[15,111,112],{},"Local"," works in the project folder. ",[15,115,116],{},"New worktree"," creates a separate checkout on a new branch, so several agents can change the code at once without colliding.",[74,119,120,125],{},[89,121,122],{},[15,123,124],{},"Start from",[89,126,127],{},"The branch or pull request the new worktree starts from.",[74,129,130,135],{},[89,131,132],{},[15,133,134],{},"Title (optional)",[89,136,137],{},"The name shown in the sidebar.",[74,139,140,145],{},[89,141,142],{},[15,143,144],{},"What to launch",[89,146,147,150,151,154,155,158],{},[15,148,149],{},"Chat"," starts an agent, ",[15,152,153],{},"Terminal"," opens a shell. ",[15,156,157],{},"Manage profiles"," edits saved launch settings.",[11,160,30,161,164],{},[15,162,163],{},"Launch"," to create the workspace.",[11,166,167],{},"Zekoder workflow commands create their own worktrees for plans and coding tasks. You do not need to create them by hand.",[24,169,171],{"id":170},"organize-the-sidebar","Organize the sidebar",[11,173,174],{},"Open the sidebar's display preferences to change:",[176,177,178,194,200,206],"ul",{},[179,180,181,184,185,94,187,190,191,51],"li",{},[15,182,183],{},"Grouping",": by ",[15,186,93],{},[15,188,189],{},"Status",", or ",[15,192,193],{},"Labels",[179,195,196,199],{},[15,197,198],{},"Title",": show the workspace title or the branch name.",[179,201,202,205],{},[15,203,204],{},"Show",": which details appear on each row (branch, host, pull request, checks, diff stats, last activity, and more).",[179,207,208,211],{},[15,209,210],{},"Show background",": include workspaces that agents created in the background.",[11,213,214,215,94,218,94,221,94,224,227,228,51],{},"When grouped by status, workspaces sort into ",[15,216,217],{},"Needs input",[15,219,220],{},"Failed",[15,222,223],{},"Ready to review",[15,225,226],{},"Working",", and ",[15,229,230],{},"Done",[11,232,233,234,237,238,241,242,245],{},"Right-click a workspace, or open its menu, to copy its path or branch, rename it, or ",[15,235,236],{},"Pin to top",". Press ",[36,239,240],{},"Cmd+1"," to ",[36,243,244],{},"Cmd+9"," to jump between workspaces.",[24,247,249],{"id":248},"archive-a-workspace","Archive a workspace",[11,251,252,253,256],{},"When the work is merged, archive the workspace from its menu or with ",[36,254,255],{},"Cmd+Shift+Backspace",". Archiving a worktree that Zekoder created removes the worktree and closes its agents and terminals. If an agent is still running, Zekoder asks first.",[11,258,13,259,261,262,265],{},[15,260,112],{}," workspace is your project folder, so it cannot be archived. Use ",[15,263,264],{},"Hide from sidebar"," instead; nothing on disk changes.",[11,267,268,269,272],{},"Archived agents stay available under ",[15,270,271],{},"History"," in the sidebar.",{"title":274,"searchDepth":275,"depth":275,"links":276},"",2,[277,278,279,280],{"id":26,"depth":275,"text":27},{"id":54,"depth":275,"text":55},{"id":170,"depth":275,"text":171},{"id":248,"depth":275,"text":249},"Add projects, create workspaces on a branch or in a new worktree, and archive them when the work is done.","md",{},{"order":285},1,"\u002Fusing-zekoder\u002Fprojects-and-workspaces",{"title":6,"description":281},"using-zekoder\u002Fprojects-and-workspaces","HfuVro-VkMBgF9GFGrraaFm0OoEHXUexyaxoYXE3Sbk",false,[292,297,314,339,369],{"title":293,"path":294,"stem":295,"order":296},"Zekoder documentation","\u002F","index",-1,{"title":298,"path":299,"stem":300,"children":301,"page":290},"Getting started","\u002Fgetting-started","getting-started",[302,306,310],{"title":303,"path":304,"stem":305},"Install","\u002Fgetting-started\u002Finstall","getting-started\u002Finstall",{"title":307,"path":308,"stem":309,"order":285},"Quick start","\u002Fgetting-started\u002Fquick-start","getting-started\u002Fquick-start",{"title":311,"path":312,"stem":313,"order":275},"Connect a host","\u002Fgetting-started\u002Fconnect-a-host","getting-started\u002Fconnect-a-host",{"title":315,"path":316,"stem":317,"children":318,"page":290},"Using Zekoder","\u002Fusing-zekoder","using-zekoder",[319,320,324,329,334],{"title":6,"path":286,"stem":288,"order":285},{"title":321,"path":322,"stem":323,"order":275},"Agents and the composer","\u002Fusing-zekoder\u002Fagents","using-zekoder\u002Fagents",{"title":325,"path":326,"stem":327,"order":328},"Review changes","\u002Fusing-zekoder\u002Freview-changes","using-zekoder\u002Freview-changes",3,{"title":330,"path":331,"stem":332,"order":333},"Keyboard shortcuts","\u002Fusing-zekoder\u002Fkeyboard-shortcuts","using-zekoder\u002Fkeyboard-shortcuts",4,{"title":335,"path":336,"stem":337,"order":338},"Settings and updates","\u002Fusing-zekoder\u002Fsettings-and-updates","using-zekoder\u002Fsettings-and-updates",5,{"title":340,"path":341,"stem":342,"children":343,"page":290},"Zekoder workflow","\u002Fzekoder-workflow","zekoder-workflow",[344,348,352,356,360,364],{"title":345,"path":346,"stem":347,"order":285},"How the workflow works","\u002Fzekoder-workflow\u002Foverview","zekoder-workflow\u002Foverview",{"title":349,"path":350,"stem":351,"order":275},"Commands","\u002Fzekoder-workflow\u002Fcommands","zekoder-workflow\u002Fcommands",{"title":353,"path":354,"stem":355,"order":328},"The Issues screen","\u002Fzekoder-workflow\u002Fissues","zekoder-workflow\u002Fissues",{"title":357,"path":358,"stem":359,"order":333},"Project settings","\u002Fzekoder-workflow\u002Fproject-settings","zekoder-workflow\u002Fproject-settings",{"title":361,"path":362,"stem":363,"order":338},"Coding health reports","\u002Fzekoder-workflow\u002Freports","zekoder-workflow\u002Freports",{"title":365,"path":366,"stem":367,"order":368},"Versions and updates","\u002Fzekoder-workflow\u002Fversion","zekoder-workflow\u002Fversion",6,{"title":370,"path":371,"stem":372,"order":373},"What changed","\u002Fwhats-changed","whats-changed",99,[375,377],{"title":330,"path":331,"stem":332,"description":376,"order":333,"children":-1},"The default keyboard shortcuts in Zekoder Desktop.",{"title":325,"path":326,"stem":327,"description":378,"order":328,"children":-1},"Read an agent's diff, leave review comments, send them back as feedback, commit, and open a pull request.",1792573526857]