aster run "task" runs one agent on one task with no terminal attached, and
aster cron install puts every schedule in aster.yaml into the OS scheduler.
Both resolve the same config as every other surface.
{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Aster","description":"Documentation for Aster, the terminal coding agent.","colors":{"primary":"#E8613C","light":"#E8613C","dark":"#f2764f"},"logo":{"light":"https://mintcdn.com/aster/3-B4TtB5O-MRurTI/logo/light.svg?fit=max\u0026auto=format\u0026n=3-B4TtB5O-MRurTI\u0026q=85\u0026s=c533d278c95c4d9a65dbadbddfadd27f","dark":"https://mintcdn.com/aster/3-B4TtB5O-MRurTI/logo/dark.svg?fit=max\u0026auto=format\u0026n=3-B4TtB5O-MRurTI\u0026q=85\u0026s=a0446fbd800b0aaff181a0852f7d25ea","href":"/"},"favicon":"https://mintcdn.com/aster/J6KROhKP58xv25-r/favicon.svg?fit=max\u0026auto=format\u0026n=J6KROhKP58xv25-r\u0026q=85\u0026s=aba5220ee8ee5581285a243c080a9686","contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","grok","aistudio","mcp","cursor","vscode"],"display":"toc"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"aster","hasAudioNarration":false,"actualSubdomain":"aster","customDomains":["docs.withaster.dev"],"gitSource":{"type":"github","owner":"zfinix","repo":"aster-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aabb05e22f30082ebbf2736","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Interfaces","count":8},{"language":"default","tag":"Using Aster","count":4},{"language":"default","tag":"Reference","count":4},{"language":"default","tag":"Extending","count":4},{"language":"default","tag":"Automation","count":3},{"language":"default","tag":"Workflows","count":2},{"language":"default","tag":"Start","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":false},"customCss":[],"page":{"pagePath":"headless","slug":"/headless","pageMetadata":{"title":"Headless and scheduled","description":"One agent on one task, no terminal attached.","href":"/headless"},"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: \"One agent on one task, no terminal attached.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[_jsx(_components.code,{children:`aster run \"task\"`}),` runs one agent on one task with no terminal attached, and\n`,_jsx(_components.code,{children:`aster cron install`}),` puts every schedule in `,_jsx(_components.code,{children:`aster.yaml`}),` into the OS scheduler.\nBoth resolve the same config as every other surface.`]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Headless and scheduled","description":"One agent on one task, no terminal attached.","href":"/headless"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/aster/4a492bd8150131eb/worker.js"],"subdomain":"aster","siteName":"Aster","title":"Headless and scheduled - Aster","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-17T09:16:43.534Z","originalFileLocation":"headless.md"},"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=\"One agent on one task, no terminal attached.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Aster\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_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=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Headless and scheduled - Aster\">\u003cmeta data-mint-head property=\"og:description\" content=\"One agent on one task, no terminal attached.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Aster\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.withaster.dev/headless\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://aster.mintlify.site/_mintlify/api/og/v2?division=Interfaces\u0026amp;title=Headless+and+scheduled\u0026amp;description=One+agent+on+one+task%2C+no+terminal+attached.\u0026amp;theme=82a8935816f2b3ffecdaecee\u0026amp;signature=bc8c819ba04abb0de97007fa75a5fbc5fe7d0fe5e6d90ecde3d2abb1d2d45181\">\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=\"Headless and scheduled - Aster\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"One agent on one task, no terminal attached.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://aster.mintlify.site/_mintlify/api/og/v2?division=Interfaces\u0026amp;title=Headless+and+scheduled\u0026amp;description=One+agent+on+one+task%2C+no+terminal+attached.\u0026amp;theme=82a8935816f2b3ffecdaecee\u0026amp;signature=bc8c819ba04abb0de97007fa75a5fbc5fe7d0fe5e6d90ecde3d2abb1d2d45181\">\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=\"/mintlify-assets/_mintlify/favicons/aster/7cuJ0WG96ii_kzRY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Aster\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#E8613C\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.withaster.dev/headless\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/headless.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.withaster.dev/#organization\",\"name\":\"Aster\",\"url\":\"https://docs.withaster.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/aster/3-B4TtB5O-MRurTI/logo/light.svg?fit=max\u0026auto=format\u0026n=3-B4TtB5O-MRurTI\u0026q=85\u0026s=c533d278c95c4d9a65dbadbddfadd27f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.withaster.dev#website\",\"name\":\"Aster\",\"url\":\"https://docs.withaster.dev\",\"publisher\":{\"@id\":\"https://docs.withaster.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.withaster.dev/headless#webpage\",\"url\":\"https://docs.withaster.dev/headless\",\"name\":\"Headless and scheduled\",\"description\":\"One agent on one task, no terminal attached.\",\"dateModified\":\"2026-09-17T09:16:43.534Z\",\"isPartOf\":{\"@id\":\"https://docs.withaster.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.withaster.dev/headless#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.withaster.dev/headless#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Interfaces\",\"item\":\"https://docs.withaster.dev/terminal-tui\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Headless and scheduled\",\"item\":\"https://docs.withaster.dev/headless\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.withaster.dev/headless#article\",\"headline\":\"Headless and scheduled\",\"name\":\"Headless and scheduled\",\"description\":\"One agent on one task, no terminal attached.\",\"url\":\"https://docs.withaster.dev/headless\",\"mainEntityOfPage\":{\"@id\":\"https://docs.withaster.dev/headless#webpage\"},\"dateModified\":\"2026-09-17T09:16:43.534Z\",\"publisher\":{\"@id\":\"https://docs.withaster.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.withaster.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Aster\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Aster\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/headless.md","siteName":"Aster","nav":{"global":null,"groups":[{"group":"Start","pages":[{"title":"Introduction","href":"/index"},{"title":"Getting started","href":"/getting-started"}]},{"group":"Interfaces","pages":[{"title":"Terminal TUI","href":"/terminal-tui"},{"title":"One-shot CLI","href":"/one-shot-cli"},{"title":"Browser","href":"/browser"},{"title":"VS Code and Cursor","href":"/vscode"},{"title":"Zed","href":"/zed"},{"title":"Desktop","href":"/desktop"},{"title":"Telegram, iMessage, Photon","description":"Set up each messaging channel and drive the agent from your phone.","href":"/messaging"},{"title":"Headless and scheduled","href":"/headless"}]},{"group":"Using Aster","pages":[{"title":"Chat","description":"The TUI, keys, slash commands, one-shot mode, and streaming.","href":"/chat"},{"title":"Sessions","href":"/sessions"},{"title":"Permissions","href":"/permissions"},{"title":"Memory","href":"/memory"}]},{"group":"Extending","pages":[{"title":"Skills","href":"/skills"},{"title":"Plugins","href":"/plugins"},{"title":"MCP servers","href":"/mcp"},{"title":"Web","href":"/web"}]},{"group":"Automation","pages":[{"title":"Sub-agents","href":"/agents"},{"title":"Schedules","href":"/schedules"},{"title":"Goals","href":"/goals"}]},{"group":"Workflows","pages":[{"title":"Review","href":"/review"},{"title":"Fix","href":"/fix"}]},{"group":"Reference","pages":[{"title":"Configuration","href":"/configuration"},{"title":"CLI commands","href":"/cli"},{"title":"Environment variables","href":"/env"},{"title":"Troubleshooting","href":"/troubleshooting"}]}]},"basePath":"","title":"Headless and scheduled - Aster","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}