Create one issue, run an agent in an isolated worktree, review the result, and close the work.
This tutorial takes one small change through Podium’s complete stable loop. You will create an issue, start an agent, inspect its evidence, and close the issue.
Before you start
You need a configured Podium instance, a registered Git repository, and one installed and authenticated harness. Finish installation and setup before continuing.Run these checks from the repository you want the agent to change:
podium statuspodium machine list
The status output should show a running server and daemon. The machine output should show the repository and at least one logged-in harness.
1
Create bounded work
Give the issue one result that you can verify. This example asks for a documentation-only change:
podium issue create \ --title "README setup note" \ --description "Add a setup note to the README and keep the existing style."
Copy the issue reference from the output. The examples below use your_issue_ref as that value.
2
Start an agent
Start the issue with an installed harness:
podium issue start your_issue_ref --agent codex
Podium claims the issue, creates its branch and worktree, and starts the agent there. Open the issue in the web app to follow the session.
The Podium web issue board inside a decorative macOS-style frame.
3
Follow the result
Read the issue and session state without scraping the full transcript:
podium issue show your_issue_refpodium session status your_issue_ref
If the agent asks a question, answer in the session panel. A browser disconnect does not stop the underlying terminal process.
4
Review the evidence
Inspect the changed files, diff, checks, and issue artifacts. An artifact is a server-side copy, so it remains available after the source worktree changes.Do not accept work because the session is hibernated. Confirm the requested change exists and the relevant check passed. See review agent work for the full review path.
5
Finish the issue
If you accept the result without using Podium’s merge action, close the issue:
podium issue close your_issue_ref --reason done
A successful podium issue action your_issue_ref merge closes the issue automatically. A failed merge leaves it open.The issue should now appear in the done stage with its session and review history intact.
podium issue start creates an isolated worktree for issue-backed work. A direct session can use the repository’s current checkout instead, so choose the issue path when concurrent work could overlap.
Continue from here
Use the same issue loop as you add more agents and machines:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Podium ADE","description":"Get started with Podium ADE. Explore guides for coordinating coding agents, managing tasks, shaping workflows, and running agents on your own VPS.","colors":{"primary":"#14222E","light":"#D5F36B","dark":"#14222E"},"logo":{"light":"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=dcf3138d694db2bbff745fe4993c735d","dark":"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/logo-dark.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=fd381d430739d8f0509f1be391285e07","href":"https://podium.do"},"favicon":"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/favicon.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=6a0cbef28ea17fcc5a8c24f51bf0af7a","appearance":{"default":"system","strict":false},"background":{"color":{"light":"#F7F3EA","dark":"#14222E"}},"navbar":{"links":[{"href":"https://podium.do","label":"Website"},{"href":"https://github.com/madeinorbit/podium","type":"github"}]},"footer":{"socials":{"x":"https://x.com/podium_ade","github":"https://github.com/madeinorbit/podium","website":"https://podium.do"},"links":[{"header":"Documentation","items":[{"label":"First issue","href":"/docs/quickstart"},{"label":"CLI reference","href":"/docs/reference/cli"},{"label":"Troubleshooting","href":"/docs/troubleshooting"},{"label":"Contribute","href":"/docs/guides/local-development"}]},{"header":"Podium","items":[{"label":"Website","href":"https://podium.do"},{"label":"X","href":"https://x.com/podium_ade"},{"label":"GitHub","href":"https://github.com/madeinorbit/podium"}]}]},"fonts":{"family":"DM Sans"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-K1H7ZVMS51"}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or has not been written yet. Use the navigation to keep exploring."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"navigation":{"global":{"tabs":[{"tab":"Docs","href":"/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"podium-420ab911","hasAudioNarration":false,"actualSubdomain":"podium-420ab911","customDomains":["podium.do"],"gitSource":{"type":"github","owner":"madeinorbit","repo":"podium-cloud","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aee4ecf6e4c119f8a1c3dba","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Understand Podium","count":4},{"language":"default","tag":"Operate Podium","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Work in Podium","count":3},{"language":"default","tag":"Coordinate agents","count":2},{"language":"default","tag":"Contribute","count":2},{"language":"default","tag":"Reference","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":true},"customCss":[{"filePath":"style.css","content":".light #search-bar-entry,.light .breadcrumb-item,.light #header button,.light button .space-x-3>span,.light #footer a{color:#626363}.dark,.dark body{background-color:#14222e}.dark #footer a{color:#a8a8a8}.code-block code{display:block;max-width:100%;overflow-wrap:anywhere;white-space:pre-wrap}"}],"page":{"pagePath":"quickstart","slug":"/quickstart","pageMetadata":{"title":"Complete your first issue","description":"Create one issue, run an agent in an isolated worktree, review the result, and close the work.","contentType":"Tutorial","href":"/quickstart"},"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: \"Create one issue, run an agent in an isolated worktree, review the result, and close the work.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,Info,OptimizedImage,Step,Steps}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`This tutorial takes one small change through Podium’s complete stable loop. You will create an issue, start an agent, inspect its evidence, and close the issue.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.p,{children:[`You need a configured Podium instance, a registered Git repository, and one installed and authenticated harness. Finish `,_jsx(_components.a,{href:`/getting-started/install`,children:`installation and setup`}),` before continuing.`]}),`\n`,_jsx(_components.p,{children:`Run these checks from the repository you want the agent to change:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` machine`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The status output should show a running server and daemon. The machine output should show the repository and at least one logged-in harness.`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create bounded work`,children:[_jsx(_components.p,{children:`Give the issue one result that you can verify. This example asks for a documentation-only change:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --title`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"README setup note\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --description`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Add a setup note to the README and keep the existing style.\"`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Copy the issue reference from the output. The examples below use `,_jsx(_components.code,{children:`your_issue_ref`}),` as that value.`]})]}),_jsxs(Step,{title:`Start an agent`,children:[_jsx(_components.p,{children:`Start the issue with an installed harness:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your_issue_ref`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` codex`})]}),`\n`]})})}),_jsx(_components.p,{children:`Podium claims the issue, creates its branch and worktree, and starts the agent there. Open the issue in the web app to follow the session.`}),_jsx(Frame,{caption:`The Podium web issue board inside a decorative macOS-style frame.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=8a81d62dde64cfe9d28961be9dfc38f4`,alt:`Podium web inside a decorative macOS-style frame, showing an issue in the Backlog column of the issue board.`,\"data-og-width\":`1230`,width:`1230`,\"data-og-height\":`440`,height:`440`,\"data-path\":`images/issue-board.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?w=280\u0026fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=0d813ae84ef00a88039c3bcb90c13e2b 280w, https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?w=560\u0026fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=2459acf20f4af894e5b5a1067da44f59 560w, https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?w=840\u0026fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=de25516961e646ecef7749636b30a29d 840w, https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=c647cec0c2f732d9c7557e62f6868f3d 1100w, https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=4861eb52e75303f2f87bc270e6b5883d 1650w, https://mintcdn.com/podium-420ab911/2s5JLbtgPIHQF79c/images/issue-board.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2s5JLbtgPIHQF79c\u0026q=85\u0026s=0ea85a97ea8ea84db44945730d171210 2500w`})})]}),_jsxs(Step,{title:`Follow the result`,children:[_jsx(_components.p,{children:`Read the issue and session state without scraping the full transcript:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` show`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your_issue_ref`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` session`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your_issue_ref`})]}),`\n`]})})}),_jsx(_components.p,{children:`If the agent asks a question, answer in the session panel. A browser disconnect does not stop the underlying terminal process.`})]}),_jsxs(Step,{title:`Review the evidence`,children:[_jsx(_components.p,{children:`Inspect the changed files, diff, checks, and issue artifacts. An artifact is a server-side copy, so it remains available after the source worktree changes.`}),_jsxs(_components.p,{children:[`Do not accept work because the session is hibernated. Confirm the requested change exists and the relevant check passed. See `,_jsx(_components.a,{href:`/guides/review-work`,children:`review agent work`}),` for the full review path.`]})]}),_jsxs(Step,{title:`Finish the issue`,children:[_jsx(_components.p,{children:`If you accept the result without using Podium’s merge action, close the issue:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` close`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your_issue_ref`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --reason`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` done`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`A successful `,_jsx(_components.code,{children:`podium issue action your_issue_ref merge`}),` closes the issue automatically. A failed merge leaves it open.`]}),_jsx(_components.p,{children:`The issue should now appear in the done stage with its session and review history intact.`})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`podium issue start`}),` creates an isolated worktree for issue-backed work. A direct session can use the repository’s current checkout instead, so choose the issue path when concurrent work could overlap.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`continue-from-here`,children:`Continue from here`}),`\n`,_jsx(_components.p,{children:`Use the same issue loop as you add more agents and machines:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Learn the `,_jsx(_components.a,{href:`/concepts/agents`,children:`issue, session, agent, and harness model`})]}),`\n`,_jsxs(_components.li,{children:[`Add progress and review context with `,_jsx(_components.a,{href:`/guides/create-track-issues`,children:`issue state, todos, and artifacts`})]}),`\n`,_jsxs(_components.li,{children:[`Split independent work with `,_jsx(_components.a,{href:`/guides/delegate-agents`,children:`agent delegation`})]}),`\n`]})]})}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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Complete your first issue","description":"Create one issue, run an agent in an isolated worktree, review the result, and close the work.","contentType":"Tutorial","href":"/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Continue from here","slug":"continue-from-here","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/podium-420ab911/07c52c163b7febf9/accessibility.js"],"subdomain":"podium-420ab911","siteName":"Podium ADE","title":"Complete your first issue - Podium ADE","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-18T14:45:08.273Z","gitLastModified":"2026-09-16T23:38:39.000Z","originalFileLocation":"quickstart.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=\"Create one issue, run an agent in an isolated worktree, review the result, and close the work.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Podium ADE\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Complete your first issue - Podium ADE\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create one issue, run an agent in an isolated worktree, review the result, and close the work.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Podium ADE\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://podium.do/docs/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://podium-420ab911.mintlify.site/docs/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Complete+your+first+issue\u0026amp;description=Create+one+issue%2C+run+an+agent+in+an+isolated+worktree%2C+review+the+result%2C+and+close+the+work.\u0026amp;theme=0b194e13f127fe4eafb1cad0\u0026amp;signature=9d73132fb49e1cafa6aaaad6548d40dbaa023207b7202a8c05bc010afc5b64e6\">\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=\"Complete your first issue - Podium ADE\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create one issue, run an agent in an isolated worktree, review the result, and close the work.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://podium-420ab911.mintlify.site/docs/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Complete+your+first+issue\u0026amp;description=Create+one+issue%2C+run+an+agent+in+an+isolated+worktree%2C+review+the+result%2C+and+close+the+work.\u0026amp;theme=0b194e13f127fe4eafb1cad0\u0026amp;signature=9d73132fb49e1cafa6aaaad6548d40dbaa023207b7202a8c05bc010afc5b64e6\">\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=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Podium ADE\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#14222E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://podium.do/docs/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/quickstart.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://podium.do/#organization\",\"name\":\"Podium ADE\",\"url\":\"https://podium.do\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=dcf3138d694db2bbff745fe4993c735d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://podium.do/docs#website\",\"name\":\"Podium ADE\",\"url\":\"https://podium.do/docs\",\"publisher\":{\"@id\":\"https://podium.do/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://podium.do/docs/quickstart#webpage\",\"url\":\"https://podium.do/docs/quickstart\",\"name\":\"Complete your first issue\",\"description\":\"Create one issue, run an agent in an isolated worktree, review the result, and close the work.\",\"dateModified\":\"2026-09-16T23:38:39.000Z\",\"isPartOf\":{\"@id\":\"https://podium.do/docs#website\"},\"breadcrumb\":{\"@id\":\"https://podium.do/docs/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://podium.do/docs/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://podium.do/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Complete your first issue\",\"item\":\"https://podium.do/docs/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://podium.do/docs/quickstart#article\",\"headline\":\"Complete your first issue\",\"name\":\"Complete your first issue\",\"description\":\"Create one issue, run an agent in an isolated worktree, review the result, and close the work.\",\"url\":\"https://podium.do/docs/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://podium.do/docs/quickstart#webpage\"},\"dateModified\":\"2026-09-16T23:38:39.000Z\",\"publisher\":{\"@id\":\"https://podium.do/#organization\"},\"isPartOf\":{\"@id\":\"https://podium.do/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Podium ADE\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Podium ADE\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/quickstart.md","siteName":"Podium ADE","nav":{"global":{"tabs":[{"tab":"Docs","href":"/"}]},"groups":[{"group":"Get started","pages":[{"title":"Run coding agents with Podium","href":"/index"},{"title":"Install and set up Podium","description":"Choose a supported deployment, finish first-run setup, and verify one harness.","href":"/getting-started/install"},{"title":"Complete your first issue","href":"/quickstart"}]},{"group":"Understand Podium","pages":[{"title":"Understand how Podium runs agents","description":"Learn the server, daemon, client, and harness boundaries behind every session.","href":"/concepts/how-podium-works"},{"title":"Understand issues, sessions, agents, and harnesses","href":"/concepts/agents"},{"title":"Understand repositories, worktrees, and machines","href":"/concepts/workspaces"},{"title":"Check feature availability","href":"/reference/feature-availability"}]},{"group":"Work in Podium","pages":[{"title":"Create and track issue work","href":"/guides/create-track-issues"},{"title":"Supervise a running agent session","href":"/guides/supervise-sessions"},{"title":"Review and accept agent work","href":"/guides/review-work"}]},{"group":"Coordinate agents","pages":[{"title":"Delegate work to other agents","href":"/guides/delegate-agents"},{"title":"Add a remote machine","href":"/guides/add-machine"}]},{"group":"Operate Podium","pages":[{"title":"Configure a Podium installation","href":"/reference/configuration"},{"title":"Update and back up Podium","href":"/guides/update-backup"},{"title":"Protect Podium data and credentials","href":"/security/privacy"},{"title":"Troubleshoot Podium by layer","href":"/troubleshooting"}]},{"group":"Reference","pages":[{"title":"Use the Podium CLI","href":"/reference/cli"},{"title":"Reference issue and session states","href":"/reference/lifecycle"}]},{"group":"Contribute","pages":[{"title":"Develop the documentation","href":"/guides/local-development"},{"title":"Deploy the documentation","href":"/guides/deployment"}]}]},"basePath":"","title":"Complete your first issue - Podium ADE","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-0domioUa.js","DynamicMarkdown-BcGRTrw6.js","zoom-image-lightbox-DsiWwPWR.js","lightbox-handle-r17bVUz3.js"]}