[{"data":1,"prerenderedAt":634},["ShallowReactive",2],{"doc:en:\u002Fzekoder-workflow\u002Fproject-settings":3,"navigation:en":547,"surround:en:\u002Fzekoder-workflow\u002Fproject-settings":629},{"page":4,"fallback":546},{"id":5,"title":6,"body":7,"description":537,"extension":538,"meta":539,"navigation":540,"path":542,"seo":543,"stem":544,"__hash__":545},"docs_en\u002Fzekoder-workflow\u002Fproject-settings.md","Project settings",{"type":8,"value":9,"toc":518},"minimark",[10,14,45,53,59,64,69,88,92,181,187,191,264,268,272,275,333,357,361,367,371,387,409,429,439,443,457,461,464,479,495,498,502],[11,12,13],"p",{},"Zekoder settings come in two scopes:",[15,16,17,32],"ul",{},[18,19,20,23,24,27,28,31],"li",{},[21,22,6],"strong",{}," apply to one repository. Open a workspace, select ",[21,25,26],{},"+"," → ",[21,29,30],{},"Zekoder settings",".",[18,33,34,37,38,41,42,31],{},[21,35,36],{},"Machine defaults"," apply to every repository on the host. Select ",[21,39,40],{},"Zekoder"," in the sidebar → ",[21,43,44],{},"Defaults",[11,46,47,48,52],{},"Project settings are stored in the repository's ",[49,50,51],"code",{},".zekoder\u002Fconfig.json",", which is not committed, so each developer keeps their own. Every control saves as soon as you change it. A field you leave unset shows the value Zekoder uses instead, with \"Not set — using default\".",[11,54,55,56,31],{},"You can also change every setting from the chat with ",[49,57,58],{},"\u002Fzekoder-config",[60,61,63],"h2",{"id":62},"basic","Basic",[65,66,68],"h3",{"id":67},"default-branch","Default branch",[11,70,71,72,75,76,79,80,83,84,87],{},"The branch plans and implemented work land on. Leave it empty to auto-detect: the remote's default branch, then ",[49,73,74],{},"main"," or ",[49,77,78],{},"master",". Select ",[21,81,82],{},"Save"," to set it or ",[21,85,86],{},"Clear (auto-detect)"," to reset it. The branch must exist locally.",[65,89,91],{"id":90},"merge","Merge",[93,94,95,111],"table",{},[96,97,98],"thead",{},[99,100,101,105,108],"tr",{},[102,103,104],"th",{},"Setting",[102,106,107],{},"Options",[102,109,110],{},"Meaning",[112,113,114,143,163],"tbody",{},[99,115,116,122,134],{},[117,118,119],"td",{},[21,120,121],{},"Default merge mode",[117,123,124,127,128,127,131],{},[21,125,126],{},"Open a PR",", ",[21,129,130],{},"Merge locally",[21,132,133],{},"Ask each time",[117,135,136,137,139,140,142],{},"How finished work lands. ",[21,138,126],{}," opens one pull request for you to review and merge. ",[21,141,130],{}," merges into the default branch without a pull request and pushes nothing.",[99,144,145,150,160],{},[117,146,147],{},[21,148,149],{},"Worktree cleanup",[117,151,152,127,155,127,158],{},[21,153,154],{},"Always",[21,156,157],{},"Never",[21,159,133],{},[117,161,162],{},"Whether task worktrees are removed after they merge.",[99,164,165,170,178],{},[117,166,167],{},[21,168,169],{},"Branch deletion",[117,171,172,127,174,127,176],{},[21,173,154],{},[21,175,157],{},[21,177,133],{},[117,179,180],{},"Whether task branches are deleted after they merge. A branch is kept while its worktree is.",[11,182,183,184,186],{},"The same merge mode decides how an approved plan lands. If your main checkout is not on the default branch, only ",[21,185,126],{}," works.",[60,188,190],{"id":189},"planning","Planning",[93,192,193,203],{},[96,194,195],{},[99,196,197,199,201],{},[102,198,104],{},[102,200,107],{},[102,202,110],{},[112,204,205,228,251],{},[99,206,207,212,220],{},[117,208,209],{},[21,210,211],{},"Planning tier",[117,213,214,127,217],{},[21,215,216],{},"Auto",[21,218,219],{},"Always full",[117,221,222,224,225,227],{},[21,223,216],{}," lets the planner offer a light plan for small changes. ",[21,226,219],{}," plans everything in full.",[99,229,230,235,243],{},[117,231,232],{},[21,233,234],{},"Reviewer policy",[117,236,237,127,240],{},[21,238,239],{},"Tiered",[21,241,242],{},"Always Opus",[117,244,245,247,248,250],{},[21,246,239],{}," reviews light plans with the shorter checklist. ",[21,249,242],{}," uses the full checklist for every plan. Both use the session's model.",[99,252,253,258,261],{},[117,254,255],{},[21,256,257],{},"Max packages per feature",[117,259,260],{},"a number",[117,262,263],{},"The most packages a full feature may split into. Empty means no limit.",[60,265,267],{"id":266},"coding","Coding",[65,269,271],{"id":270},"simplify","Simplify",[11,273,274],{},"After each task merges, a simplify pass can clean up the merged code. A failed pass never blocks the merge.",[93,276,277,289],{},[96,278,279],{},[99,280,281,286],{},[102,282,283],{},[21,284,285],{},"Simplify mode",[102,287,288],{},"When the pass runs",[112,290,291,300,310,320],{},[99,292,293,297],{},[117,294,295],{},[21,296,216],{},[117,298,299],{},"When a task's files overlap another task's in the same run (the default).",[99,301,302,307],{},[117,303,304],{},[21,305,306],{},"Always required",[117,308,309],{},"After every task. Slower: one more agent and another round of checks.",[99,311,312,317],{},[117,313,314],{},[21,315,316],{},"Never required",[117,318,319],{},"Never.",[99,321,322,327],{},[117,323,324],{},[21,325,326],{},"Smart (thresholds below)",[117,328,329,330,332],{},"Like ",[21,331,216],{},", plus when a task crosses one of the thresholds.",[11,334,335,336,339,340,343,344,127,347,127,350,353,354,31],{},"With ",[21,337,338],{},"Smart",", set the thresholds: ",[21,341,342],{},"Max judgment passes"," (0 turns them off), ",[21,345,346],{},"Min fix-forwards",[21,348,349],{},"Min new files",[21,351,352],{},"Min changed lines",", and ",[21,355,356],{},"Min gate retries",[60,358,360],{"id":359},"prompts","Prompts",[11,362,363,366],{},[21,364,365],{},"Custom prompt"," adds up to 2,000 characters of extra instructions to every planning and coding prompt in this repository, for example your team's commit message style.",[60,368,370],{"id":369},"agent-defaults","Agent defaults",[11,372,373,374,377,378,380,381,377,384,386],{},"The ",[21,375,376],{},"Planning session"," (on the ",[21,379,190],{}," tab) and ",[21,382,383],{},"Coding session",[21,385,267],{}," tab) sections choose what agents start with:",[15,388,389,402],{},[18,390,391,393,394,397,398,401],{},[21,392,190],{}," applies to ",[21,395,396],{},"Promote"," and ",[21,399,400],{},"Migrate"," on the Issues screen.",[18,403,404,393,406,31],{},[21,405,267],{},[21,407,408],{},"Implement",[11,410,411,412,127,415,127,418,353,421,424,425,428],{},"Each has ",[21,413,414],{},"Provider",[21,416,417],{},"Model",[21,419,420],{},"Effort",[21,422,423],{},"Access mode",". Leave a field at ",[21,426,427],{},"Provider default"," to use the provider's own default. Changing the provider clears the model, effort, and mode for that session.",[11,430,431,432,75,435,438],{},"A model can be a family name such as ",[49,433,434],{},"opus",[49,436,437],{},"sonnet"," on Claude Code. Zekoder starts the newest model in that family at launch.",[65,440,442],{"id":441},"role-defaults","Role defaults",[11,444,445,446,448,449,452,453,456],{},"Under ",[21,447,442],{}," you can set the model and effort for each Zekoder agent role, such as the planner, the plan reviewer, the supervisor, and the coding agent, per provider. ",[21,450,451],{},"Agent default (unset)"," uses the role's own default. ",[21,454,455],{},"Inherit session model"," keeps the model of the session that starts the role. Models are checked when the role starts.",[65,458,460],{"id":459},"which-value-wins","Which value wins",[11,462,463],{},"Values resolve field by field, highest first:",[465,466,467,470,473,476],"ol",{},[18,468,469],{},"The active execution profile, if you use one.",[18,471,472],{},"The project setting.",[18,474,475],{},"The machine default.",[18,477,478],{},"The provider's own default.",[11,480,481,482,75,485,79,488,75,491,494],{},"Each value shows where it comes from, such as ",[49,483,484],{},"opus · repo",[49,486,487],{},"opus · machine",[21,489,490],{},"Reset planning defaults",[21,492,493],{},"Reset coding defaults"," to clear the project's values so the machine defaults show through.",[11,496,497],{},"If a model, effort, or mode set at the project level is not offered by the provider, the launch stops with an error naming the setting. A value inherited from a lower level is dropped instead, and the provider default is used.",[60,499,501],{"id":500},"telemetry","Telemetry",[11,503,504,505,507,508,510,511,75,514,517],{},"On the ",[21,506,40],{}," page → ",[21,509,501],{},", choose ",[21,512,513],{},"Opt in",[21,515,516],{},"Opt out"," of anonymous usage events. The choice applies to every repository on this machine.",{"title":519,"searchDepth":520,"depth":520,"links":521},"",2,[522,527,528,531,532,536],{"id":62,"depth":520,"text":63,"children":523},[524,526],{"id":67,"depth":525,"text":68},3,{"id":90,"depth":525,"text":91},{"id":189,"depth":520,"text":190},{"id":266,"depth":520,"text":267,"children":529},[530],{"id":270,"depth":525,"text":271},{"id":359,"depth":520,"text":360},{"id":369,"depth":520,"text":370,"children":533},[534,535],{"id":441,"depth":525,"text":442},{"id":459,"depth":525,"text":460},{"id":500,"depth":520,"text":501},"Configure merge mode, planning, simplify, custom prompts, and the providers and models Zekoder agents start with.","md",{},{"order":541},4,"\u002Fzekoder-workflow\u002Fproject-settings",{"title":6,"description":537},"zekoder-workflow\u002Fproject-settings","iyLTa_gRqxZC2UQdEwk1UrqOLW76b6k-OiZBLjlNa_Y",false,[548,553,571,597,624],{"title":549,"path":550,"stem":551,"order":552},"Zekoder documentation","\u002F","index",-1,{"title":554,"path":555,"stem":556,"children":557,"page":546},"Getting started","\u002Fgetting-started","getting-started",[558,562,567],{"title":559,"path":560,"stem":561},"Install","\u002Fgetting-started\u002Finstall","getting-started\u002Finstall",{"title":563,"path":564,"stem":565,"order":566},"Quick start","\u002Fgetting-started\u002Fquick-start","getting-started\u002Fquick-start",1,{"title":568,"path":569,"stem":570,"order":520},"Connect a host","\u002Fgetting-started\u002Fconnect-a-host","getting-started\u002Fconnect-a-host",{"title":572,"path":573,"stem":574,"children":575,"page":546},"Using Zekoder","\u002Fusing-zekoder","using-zekoder",[576,580,584,588,592],{"title":577,"path":578,"stem":579,"order":566},"Projects and workspaces","\u002Fusing-zekoder\u002Fprojects-and-workspaces","using-zekoder\u002Fprojects-and-workspaces",{"title":581,"path":582,"stem":583,"order":520},"Agents and the composer","\u002Fusing-zekoder\u002Fagents","using-zekoder\u002Fagents",{"title":585,"path":586,"stem":587,"order":525},"Review changes","\u002Fusing-zekoder\u002Freview-changes","using-zekoder\u002Freview-changes",{"title":589,"path":590,"stem":591,"order":541},"Keyboard shortcuts","\u002Fusing-zekoder\u002Fkeyboard-shortcuts","using-zekoder\u002Fkeyboard-shortcuts",{"title":593,"path":594,"stem":595,"order":596},"Settings and updates","\u002Fusing-zekoder\u002Fsettings-and-updates","using-zekoder\u002Fsettings-and-updates",5,{"title":598,"path":599,"stem":600,"children":601,"page":546},"Zekoder workflow","\u002Fzekoder-workflow","zekoder-workflow",[602,606,610,614,615,619],{"title":603,"path":604,"stem":605,"order":566},"How the workflow works","\u002Fzekoder-workflow\u002Foverview","zekoder-workflow\u002Foverview",{"title":607,"path":608,"stem":609,"order":520},"Commands","\u002Fzekoder-workflow\u002Fcommands","zekoder-workflow\u002Fcommands",{"title":611,"path":612,"stem":613,"order":525},"The Issues screen","\u002Fzekoder-workflow\u002Fissues","zekoder-workflow\u002Fissues",{"title":6,"path":542,"stem":544,"order":541},{"title":616,"path":617,"stem":618,"order":596},"Coding health reports","\u002Fzekoder-workflow\u002Freports","zekoder-workflow\u002Freports",{"title":620,"path":621,"stem":622,"order":623},"Versions and updates","\u002Fzekoder-workflow\u002Fversion","zekoder-workflow\u002Fversion",6,{"title":625,"path":626,"stem":627,"order":628},"What changed","\u002Fwhats-changed","whats-changed",99,[630,632],{"title":603,"path":604,"stem":605,"description":631,"order":566,"children":-1},"Work items, plans, the .zekoder folder, and the path an item takes from idea to merged code.",{"title":616,"path":617,"stem":618,"description":633,"order":596,"children":-1},"See commits, lines changed, and pull requests per contributor and repository for a GitHub organization.",1792573527040]