The top-level fields of a project’s config and what they control.
A project’s config is validated by projectConfigSchema in packages/contracts/src/projects.ts. You normally edit it in the web project editor. Over MCP, use the project config tools.
The schema still carries fields from earlier designs, such as instance, studio and hardening settings. This page lists the fields that matter for the local runner. For the full shape, read the schema.
Top-level fields
Field
What it controls
repos
At least one repository, with at least one enabled. Keys, directory names and aliases must be unique
git
Ticket branch base, whether to create a ticket branch on launch, protected branches, commit author name and email
naming
Instance prefix, project tag, unit prefix
ticketProvider, asana
Asana is the only provider. Needs the Asana workspace and project ids
Transport is stdio, http or sse. Header and env values may be ${...} placeholders. Over MCP, secret values are masked on read and the placeholder round-trips safely on write.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Code-it","description":"Onboarding and reference for Code-it AI delivery: Kiro agents that run on your own laptop.","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"navbar":{"primary":{"type":"button","label":"Open Code-it","href":"https://app.aiml-code-it.automat-it.io"}},"footer":{"socials":{"github":"https://github.com/automat-it/ait-ai-delivery-code-it"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vlad-1b5af8b0","hasAudioNarration":false,"actualSubdomain":"vlad-1b5af8b0","customDomains":[],"gitSource":{"type":"github","owner":"automat-it","repo":"ait-ai-delivery-code-it","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":"","_id":"6afaea9dd57358ecbcc0d070"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afaeb0ed57358ecbcc0dbbc","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Concepts","count":8},{"language":"default","tag":"Use from elsewhere","count":4},{"language":"default","tag":"Reference","count":3},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Help","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/project-config","slug":"/reference/project-config","pageMetadata":{"title":"Project config","description":"The top-level fields of a project's config and what they control.","href":"/reference/project-config"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"The top-level fields of a project’s config and what they control.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A project’s config is validated by `,_jsx(_components.code,{children:`projectConfigSchema`}),` in `,_jsx(_components.code,{children:`packages/contracts/src/projects.ts`}),`. You normally edit it in the web project editor. Over MCP, use the project config tools.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The schema still carries fields from earlier designs, such as instance, studio and hardening settings. This page lists the fields that matter for the local runner. For the full shape, read the schema.`})}),`\n`,_jsx(Heading,{level:`2`,id:`top-level-fields`,children:`Top-level fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`What it controls`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`repos`})}),_jsx(_components.td,{children:`At least one repository, with at least one enabled. Keys, directory names and aliases must be unique`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`git`})}),_jsx(_components.td,{children:`Ticket branch base, whether to create a ticket branch on launch, protected branches, commit author name and email`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`naming`})}),_jsx(_components.td,{children:`Instance prefix, project tag, unit prefix`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ticketProvider`}),`, `,_jsx(_components.code,{children:`asana`})]}),_jsx(_components.td,{children:`Asana is the only provider. Needs the Asana workspace and project ids`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`kiroCli`})}),_jsx(_components.td,{children:`Everything about the Kiro agent. See below`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`triggers`})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/scheduled-starts`,children:`Scheduled starts`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pullRequests`})}),_jsx(_components.td,{children:`PR hook, “how to test” document and quality gate`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`documentSources`})}),_jsx(_components.td,{children:`Drive folders and Notion databases the agent may read`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pocRepo`})}),_jsx(_components.td,{children:`Optionally create a new GitHub repo per POC ticket. Off by default`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`secrets`})}),_jsx(_components.td,{children:`Secret name prefix and the keys for SSH, deploy key and npmrc`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tooling`})}),_jsx(_components.td,{children:`Pinned tools such as Terraform, tflint, checkov, CDK`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`creditToUsdFactor`})}),_jsx(_components.td,{children:`Credit to USD factor for reporting. Null means no tracking`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`teardownCommand`})}),_jsx(_components.td,{children:`Command run before an agent is terminated. Best effort`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`defaults`})}),_jsx(_components.td,{children:`Whether to auto-start the agent, and the default first prompt`})]})]})]}),`\n`,_jsxs(Heading,{level:`2`,id:`repository-repos`,children:[`Repository (`,_jsx(_components.code,{children:`repos[]`}),`)`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`key`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`aliases`}),`, `,_jsx(_components.code,{children:`gitUrl`}),`, `,_jsx(_components.code,{children:`defaultBranch`}),`, `,_jsx(_components.code,{children:`enabled`}),`, `,_jsx(_components.code,{children:`runtime`}),` (node or python), `,_jsx(_components.code,{children:`installCommand`}),`, `,_jsx(_components.code,{children:`prepareCommands`}),`, `,_jsx(_components.code,{children:`devCommand`}),`, `,_jsx(_components.code,{children:`port`}),`, `,_jsx(_components.code,{children:`needsDatabase`}),`, `,_jsx(_components.code,{children:`env`}),` and more.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`kiro-agent-kirocli`,children:[`Kiro agent (`,_jsx(_components.code,{children:`kiroCli`}),`)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`version`})}),_jsxs(_components.td,{children:[`Pinned `,_jsx(_components.code,{children:`kiro-cli`}),` version. Empty means the default`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`acpEngine`})}),_jsxs(_components.td,{children:[`ACP generation. Default `,_jsx(_components.code,{children:`v3`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agentName`})}),_jsx(_components.td,{children:`Agent profile id. Empty uses the CLI default`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`model`}),`, `,_jsx(_components.code,{children:`effort`})]}),_jsx(_components.td,{children:`Default model and effort`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`trustTools`})}),_jsx(_components.td,{children:`Exact tool ids the agent trusts`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`deniedPaths`})}),_jsx(_components.td,{children:`Paths the agent is kept out of`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`steering`})}),_jsx(_components.td,{children:`Steering markdown globs staged for the agent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`powers`})}),_jsxs(_components.td,{children:[`Powers the project consents to. See `,_jsx(_components.a,{href:`/concepts/powers`,children:`Powers`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`mcpServers`})}),_jsx(_components.td,{children:`MCP servers wired into the agent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hooks`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`stopInBackground`}),` and `,_jsx(_components.code,{children:`preToolUseDenyGuard`}),`, both on by default`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sandbox`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`enabled`}),` (default on) and `,_jsx(_components.code,{children:`required`}),` (default off)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`aidlc`})}),_jsx(_components.td,{children:`AI-DLC pack settings. Off by default`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`workProfiles`}),`, `,_jsx(_components.code,{children:`layeredRules`}),`, `,_jsx(_components.code,{children:`sensors`})]}),_jsxs(_components.td,{children:[`See `,_jsx(_components.a,{href:`/guides/work-profiles`,children:`Work profiles`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`mcp-server-entry`,children:`MCP server entry`}),`\n`,_jsxs(_components.p,{children:[`Transport is `,_jsx(_components.code,{children:`stdio`}),`, `,_jsx(_components.code,{children:`http`}),` or `,_jsx(_components.code,{children:`sse`}),`. Header and env values may be `,_jsx(_components.code,{children:\"${...}\"}),` placeholders. Over MCP, secret values are masked on read and the placeholder round-trips safely on write.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Project config","description":"The top-level fields of a project's config and what they control.","href":"/reference/project-config"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Top-level fields","slug":"top-level-fields","depth":2,"children":[]},{"title":"Repository (repos[])","slug":"repository-repos","depth":2,"children":[]},{"title":"Kiro agent (kiroCli)","slug":"kiro-agent-kirocli","depth":2,"children":[]},{"title":"MCP server entry","slug":"mcp-server-entry","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"vlad-1b5af8b0","siteName":"Code-it","title":"Project config - Code-it","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T11:38:03.843Z","originalFileLocation":"reference/project-config.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"The top-level fields of a project\u0026#x27;s config and what they control.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Code-it\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/vlad-1b5af8b0/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/vlad-1b5af8b0/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/vlad-1b5af8b0/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/vlad-1b5af8b0/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Project config - Code-it\">\u003cmeta data-mint-head property=\"og:description\" content=\"The top-level fields of a project\u0026#x27;s config and what they control.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Code-it\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://vlad-1b5af8b0.mintlify.app/reference/project-config\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vlad-1b5af8b0.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=Project+config\u0026amp;description=The+top-level+fields+of+a+project%27s+config+and+what+they+control.\u0026amp;theme=c6b247f82d0b28602e760c10\u0026amp;signature=159fb734420a82028ef3c18e6dc5efd16c11912599430f407bba93e34bc29f7b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Project config - Code-it\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The top-level fields of a project\u0026#x27;s config and what they control.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vlad-1b5af8b0.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=Project+config\u0026amp;description=The+top-level+fields+of+a+project%27s+config+and+what+they+control.\u0026amp;theme=c6b247f82d0b28602e760c10\u0026amp;signature=159fb734420a82028ef3c18e6dc5efd16c11912599430f407bba93e34bc29f7b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/vlad-1b5af8b0/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Code-it\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://vlad-1b5af8b0.mintlify.app/reference/project-config\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/project-config.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://vlad-1b5af8b0.mintlify.app/#organization\",\"name\":\"Code-it\",\"url\":\"https://vlad-1b5af8b0.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://vlad-1b5af8b0.mintlify.app#website\",\"name\":\"Code-it\",\"url\":\"https://vlad-1b5af8b0.mintlify.app\",\"publisher\":{\"@id\":\"https://vlad-1b5af8b0.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config#webpage\",\"url\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config\",\"name\":\"Project config\",\"description\":\"The top-level fields of a project's config and what they control.\",\"dateModified\":\"2026-11-16T11:38:03.843Z\",\"isPartOf\":{\"@id\":\"https://vlad-1b5af8b0.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://vlad-1b5af8b0.mintlify.app/reference/runner-cli\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Project config\",\"item\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config#article\",\"headline\":\"Project config\",\"name\":\"Project config\",\"description\":\"The top-level fields of a project's config and what they control.\",\"url\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config\",\"mainEntityOfPage\":{\"@id\":\"https://vlad-1b5af8b0.mintlify.app/reference/project-config#webpage\"},\"dateModified\":\"2026-11-16T11:38:03.843Z\",\"publisher\":{\"@id\":\"https://vlad-1b5af8b0.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://vlad-1b5af8b0.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Code-it\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Code-it\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/project-config.md","siteName":"Code-it","nav":{"global":null,"groups":[{"group":"Get started","pages":[{"title":"What is Code-it","href":"/index"},{"title":"Quickstart","href":"/quickstart"}]},{"group":"Concepts","pages":[{"title":"Projects","href":"/concepts/projects"},{"title":"Agents","href":"/concepts/agents"},{"title":"The runner","href":"/concepts/runner"},{"title":"Skills","href":"/concepts/skills"},{"title":"MCP servers","href":"/concepts/mcp-servers"},{"title":"Lessons","href":"/concepts/lessons"},{"title":"Work profiles","href":"/concepts/work-profiles"},{"title":"Powers","href":"/concepts/powers"}]},{"group":"Guides","pages":[{"title":"Install and troubleshoot the runner","href":"/guides/runner"},{"title":"Choose repos, MCP servers and skills per agent","href":"/guides/agent-selection"},{"title":"Chat features","href":"/guides/chat"},{"title":"Lessons and keep-this","href":"/guides/lessons"},{"title":"Scheduled starts","href":"/guides/scheduled-starts"},{"title":"Work profiles and sensors","href":"/guides/work-profiles"},{"title":"Usage and compliance","href":"/guides/usage-compliance"},{"title":"Cost, velocity, DORA and KPIs","href":"/guides/cost-and-metrics"},{"title":"Memory","href":"/guides/memory"}]},{"group":"Use from elsewhere","pages":[{"title":"Code-it MCP","href":"/use-from/mcp"},{"title":"VS Code extension","href":"/use-from/vscode"},{"title":"Chrome extension","href":"/use-from/chrome"},{"title":"iOS and desktop apps","href":"/use-from/mobile-desktop"}]},{"group":"Reference","pages":[{"title":"Runner CLI","href":"/reference/runner-cli"},{"title":"Code-it MCP tools","description":"Every tool the Code-it MCP server serves, by access group.","href":"/reference/mcp-tools"},{"title":"Project config","href":"/reference/project-config"}]},{"group":"Help","pages":[{"title":"FAQ and troubleshooting","description":"Short answers to common problems.","href":"/faq"}]}]},"basePath":"","title":"Project config - Code-it","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}