[{"data":1,"prerenderedAt":385},["ShallowReactive",2],{"doc:en:\u002Fgetting-started\u002Fquick-start":3,"navigation:en":307,"surround:en:\u002Fgetting-started\u002Fquick-start":380},{"page":4,"fallback":306},{"id":5,"title":6,"body":7,"description":297,"extension":298,"meta":299,"navigation":300,"path":302,"seo":303,"stem":304,"__hash__":305},"docs_en\u002Fgetting-started\u002Fquick-start.md","Quick start",{"type":8,"value":9,"toc":287},"minimark",[10,20,25,48,51,55,66,86,90,93,117,123,127,137,173,176,180,183,194,204,218,222,250,262,266],[11,12,13,14,19],"p",{},"This guide takes about fifteen minutes. You need Zekoder Desktop ",[15,16,18],"a",{"href":17},"\u002Fgetting-started\u002Finstall","installed"," and Claude Code or Codex signed in on your computer.",[21,22,24],"h2",{"id":23},"_1-add-a-project","1. Add a project",[26,27,28,41],"ol",{},[29,30,31,32,36,37,40],"li",{},"On the home screen, select ",[33,34,35],"strong",{},"Add a project",", or ",[33,38,39],{},"Add project"," at the bottom of the sidebar.",[29,42,43,44,47],{},"Type a path or select ",[33,45,46],{},"Browse…",", pick the folder of a git repository, and confirm.",[11,49,50],{},"The project appears in the sidebar with one workspace: your folder as it is on disk.",[21,52,54],{"id":53},"_2-start-an-agent","2. Start an agent",[26,56,57,60,63],{},[29,58,59],{},"Select the workspace. A new agent tab opens with the composer focused.",[29,61,62],{},"Pick the provider and model in the composer toolbar.",[29,64,65],{},"Describe a small task, for example \"Explain how this project is built and tested\", and press Enter.",[11,67,68,69,72,73,76,77,80,81,85],{},"The agent works in the project folder. If it asks for permission to run a command or edit a file, a ",[33,70,71],{},"Permission Required"," card appears: choose ",[33,74,75],{},"Accept"," or ",[33,78,79],{},"Deny",". See ",[15,82,84],{"href":83},"\u002Fusing-zekoder\u002Fagents","Agents and the composer"," for modes, queued messages, and attachments.",[21,87,89],{"id":88},"_3-install-the-zekoder-skills","3. Install the Zekoder skills",[11,91,92],{},"The Zekoder workflow needs its skills, agents, and MCP server installed for your user on this computer. The app does this automatically after it starts and before each new agent. To check:",[26,94,95,106],{},[29,96,97,98,101,102,105],{},"Select ",[33,99,100],{},"Zekoder"," in the sidebar and open the ",[33,103,104],{},"Version"," tab.",[29,107,108,109,112,113,116],{},"The ",[33,110,111],{},"Skills and agents"," row shows the installed version. If it says it is not installed, select ",[33,114,115],{},"Install",".",[11,118,119,120,116],{},"Agents that were already running when the skills were installed need a reload: open the agent tab's menu and select ",[33,121,122],{},"Reload agent",[21,124,126],{"id":125},"_4-choose-your-planning-and-coding-providers","4. Choose your planning and coding providers",[11,128,129,130,132,133,136],{},"On the ",[33,131,100],{}," page, a ",[33,134,135],{},"Set up providers"," banner appears until you pick them.",[26,138,139,145,167],{},[29,140,141,142,105],{},"Open the ",[33,143,144],{},"Defaults",[29,146,147,148,151,152,155,156,159,160,159,163,166],{},"Under ",[33,149,150],{},"Planning",", set ",[33,153,154],{},"Provider"," (and optionally ",[33,157,158],{},"Model",", ",[33,161,162],{},"Effort",[33,164,165],{},"Access mode",").",[29,168,169,170,116],{},"Do the same under ",[33,171,172],{},"Coding",[11,174,175],{},"Planning agents write and review plans. Coding agents implement them.",[21,177,179],{"id":178},"_5-plan-your-first-change","5. Plan your first change",[11,181,182],{},"In an agent tab on your project, run:",[184,185,191],"pre",{"className":186,"code":188,"language":189,"meta":190},[187],"language-text","\u002Fzekoder-plan Add a --version flag to the CLI\n","text","",[192,193,188],"code",{"__ignoreMap":190},[11,195,196,197,200,201,116],{},"On Codex, type ",[192,198,199],{},"$zekoder-plan"," instead of ",[192,202,203],{},"\u002Fzekoder-plan",[11,205,206,207,210,211,116],{},"The first time you plan in a repository, Zekoder offers to set it up: it creates the ",[192,208,209],{},".zekoder\u002F"," folder, writes a short description of the repository, and asks a few one-time questions (merge mode, simplify mode, package limit). Approve each step. Then the planner asks clarifying questions, writes the plan, has it reviewed, and asks you to approve it before committing. See ",[15,212,214,215,217],{"href":213},"\u002Fzekoder-workflow\u002Fcommands#what-zekoder-plan-does","what ",[192,216,203],{}," does",[21,219,221],{"id":220},"_6-implement-it","6. Implement it",[26,223,224,237,240],{},[29,225,97,226,229,230,233,234,116],{},[33,227,228],{},"Issues"," in the sidebar. Your new item shows under the ",[33,231,232],{},"Open"," filter with status ",[192,235,236],{},"open",[29,238,239],{},"Select the item to open its details.",[29,241,97,242,245,246,249],{},[33,243,244],{},"Implement",". Zekoder starts a coding agent that runs ",[192,247,248],{},"\u002Fzekoder-implement \u003Cid>"," and takes you to it.",[11,251,252,253,80,256,116],{},"The coding agent confirms the merge mode, splits the work into tasks, runs each in its own git worktree, reviews and checks the result, and merges it, either through a pull request or locally. When it finishes, the item moves to ",[33,254,255],{},"Done",[15,257,214,259,217],{"href":258},"\u002Fzekoder-workflow\u002Fcommands#what-zekoder-implement-does",[192,260,261],{},"\u002Fzekoder-implement",[21,263,265],{"id":264},"next-steps","Next steps",[267,268,269,275,281],"ul",{},[29,270,271],{},[15,272,274],{"href":273},"\u002Fzekoder-workflow\u002Foverview","How the workflow works",[29,276,277],{},[15,278,280],{"href":279},"\u002Fzekoder-workflow\u002Fissues","The Issues screen",[29,282,283],{},[15,284,286],{"href":285},"\u002Fzekoder-workflow\u002Fproject-settings","Project settings",{"title":190,"searchDepth":288,"depth":288,"links":289},2,[290,291,292,293,294,295,296],{"id":23,"depth":288,"text":24},{"id":53,"depth":288,"text":54},{"id":88,"depth":288,"text":89},{"id":125,"depth":288,"text":126},{"id":178,"depth":288,"text":179},{"id":220,"depth":288,"text":221},{"id":264,"depth":288,"text":265},"Go from a fresh install to a running agent, then to your first planned and implemented change.","md",{},{"order":301},1,"\u002Fgetting-started\u002Fquick-start",{"title":6,"description":297},"getting-started\u002Fquick-start","aaZChMRsAitiVOeD7xsaOg14yHW3XaNcsIN2uVd2ZrY",false,[308,313,325,351,375],{"title":309,"path":310,"stem":311,"order":312},"Zekoder documentation","\u002F","index",-1,{"title":314,"path":315,"stem":316,"children":317,"page":306},"Getting started","\u002Fgetting-started","getting-started",[318,320,321],{"title":115,"path":17,"stem":319},"getting-started\u002Finstall",{"title":6,"path":302,"stem":304,"order":301},{"title":322,"path":323,"stem":324,"order":288},"Connect a host","\u002Fgetting-started\u002Fconnect-a-host","getting-started\u002Fconnect-a-host",{"title":326,"path":327,"stem":328,"children":329,"page":306},"Using Zekoder","\u002Fusing-zekoder","using-zekoder",[330,334,336,341,346],{"title":331,"path":332,"stem":333,"order":301},"Projects and workspaces","\u002Fusing-zekoder\u002Fprojects-and-workspaces","using-zekoder\u002Fprojects-and-workspaces",{"title":84,"path":83,"stem":335,"order":288},"using-zekoder\u002Fagents",{"title":337,"path":338,"stem":339,"order":340},"Review changes","\u002Fusing-zekoder\u002Freview-changes","using-zekoder\u002Freview-changes",3,{"title":342,"path":343,"stem":344,"order":345},"Keyboard shortcuts","\u002Fusing-zekoder\u002Fkeyboard-shortcuts","using-zekoder\u002Fkeyboard-shortcuts",4,{"title":347,"path":348,"stem":349,"order":350},"Settings and updates","\u002Fusing-zekoder\u002Fsettings-and-updates","using-zekoder\u002Fsettings-and-updates",5,{"title":352,"path":353,"stem":354,"children":355,"page":306},"Zekoder workflow","\u002Fzekoder-workflow","zekoder-workflow",[356,358,362,364,366,370],{"title":274,"path":273,"stem":357,"order":301},"zekoder-workflow\u002Foverview",{"title":359,"path":360,"stem":361,"order":288},"Commands","\u002Fzekoder-workflow\u002Fcommands","zekoder-workflow\u002Fcommands",{"title":280,"path":279,"stem":363,"order":340},"zekoder-workflow\u002Fissues",{"title":286,"path":285,"stem":365,"order":345},"zekoder-workflow\u002Fproject-settings",{"title":367,"path":368,"stem":369,"order":350},"Coding health reports","\u002Fzekoder-workflow\u002Freports","zekoder-workflow\u002Freports",{"title":371,"path":372,"stem":373,"order":374},"Versions and updates","\u002Fzekoder-workflow\u002Fversion","zekoder-workflow\u002Fversion",6,{"title":376,"path":377,"stem":378,"order":379},"What changed","\u002Fwhats-changed","whats-changed",99,[381,383],{"title":115,"path":17,"stem":319,"description":382,"children":-1},"Install Zekoder Desktop on macOS, Windows, or Linux and open it for the first time.",{"title":309,"path":310,"stem":311,"description":384,"order":312,"children":-1},"Install Zekoder Desktop, run coding agents on your projects, and drive planned work from idea to merge.",1792573526856]