Complete reference for all remoteagent CLI commands.
RemoteAgent.CHAT runs as a background process on your machine, listening for Telegram commands and forwarding them to your AI runner. All configuration is stored locally in ~/.remoteagent/ — nothing is ever sent to the RemoteAgent.CHAT servers except the relay messages.
Commands
remoteagent init
Set up a new agent and pair it with your Telegram bot.
remoteagent start # start the only configured agentremoteagent start my-project # start a specific agent by project nameremoteagent start -f # run in foreground (keep terminal open)remoteagent start -v # run in foreground with verbose logs
Flag
Description
-f
Foreground mode — process stays attached to the terminal
-v
Verbose mode — implies -f, shows detailed logs
remoteagent stop [name]
Stop a running background agent.
remoteagent stopremoteagent stop my-project
remoteagent logs [name]
Tail the log file of a background agent in real time.
remoteagent logsremoteagent logs my-project
Logs are stored in ~/.remoteagent/agents/{agentId}.log.
remoteagent config
Interactively update settings: API key, preferred language, and per-agent project path or name.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"RemoteAgent.CHAT","colors":{"primary":"#1B84FF","light":"#60AEFF","dark":"#0D5ECC"},"logo":{"light":"https://mintcdn.com/remoteagentchat/px6-PCumF-TyyIWF/logo/light.svg?fit=max\u0026auto=format\u0026n=px6-PCumF-TyyIWF\u0026q=85\u0026s=73d901cf8b03ed547c879ca4b742ae75","dark":"https://mintcdn.com/remoteagentchat/px6-PCumF-TyyIWF/logo/dark.svg?fit=max\u0026auto=format\u0026n=px6-PCumF-TyyIWF\u0026q=85\u0026s=d14b2e8d649edd085e6725a3bf57b7c1"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/remoteagentchat/favicon.svg","navbar":{"links":[{"href":"https://remoteagent.chat","label":"remoteagent.chat"}],"primary":{"type":"button","label":"Get started free","href":"https://remoteagent.chat/signup"}},"footer":{"socials":{"github":"https://github.com/ggiacomo/docs"}},"seo":{},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"remoteagent.chat","icon":"house","href":"https://remoteagent.chat"},{"anchor":"Telegram bot","icon":"paper-plane","href":"https://t.me/remoteagent_bot"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"remoteagentchat","hasAudioNarration":false,"actualSubdomain":"remoteagentchat","customDomains":["docs.remoteagent.chat"],"gitSource":{"type":"github","owner":"ggiacomo","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae94a1e2537587934550871:success","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Documentation","count":23},{"language":"default","tag":"Runners","count":9},{"language":"default","tag":"Using the Bot","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Under the Hood","count":3},{"language":"default","tag":"Platform","count":2},{"language":"default","tag":"Reference","count":1},{"language":"default","tag":"Support","count":1},{"language":"default","tag":"Overview","count":1}]},"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"cli-reference","slug":"/cli-reference","pageMetadata":{"title":"CLI reference","description":"Complete reference for all remoteagent CLI commands.","href":"/cli-reference"},"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: \"Complete reference for all remoteagent CLI commands.\"\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`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`RemoteAgent.CHAT runs as a background process on your machine, listening for Telegram commands and forwarding them to your AI runner. All configuration is stored locally in `,_jsx(_components.code,{children:`~/.remoteagent/`}),` — nothing is ever sent to the RemoteAgent.CHAT servers except the relay messages.`]}),`\n`,_jsx(Heading,{level:`2`,id:`commands`,children:`Commands`}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-init`,children:_jsx(_components.code,{children:`remoteagent init`})}),`\n`,_jsx(_components.p,{children:`Set up a new agent and pair it with your Telegram bot.`}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Launches an interactive wizard that asks for:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Runner`}),` — which AI engine to use (see `,_jsx(_components.a,{href:`/runners/overview`,children:`Runners`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Authentication`}),` — API key or OAuth token, depending on the runner`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pairing code`}),` — generated from the `,_jsx(_components.a,{href:`https://remoteagent.chat/dashboard`,children:`dashboard`})]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Flags:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--runner \u003ctype>`})}),_jsxs(_components.td,{children:[`Skip runner selection. Options: `,_jsx(_components.code,{children:`opencode`}),`, `,_jsx(_components.code,{children:`claude-sdk`}),`, `,_jsx(_components.code,{children:`claude-code`}),`, `,_jsx(_components.code,{children:`gemini`}),`, `,_jsx(_components.code,{children:`codex`}),`, `,_jsx(_components.code,{children:`aider`}),`, `,_jsx(_components.code,{children:`openclaw`}),`, `,_jsx(_components.code,{children:`custom`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--runner-bin \u003cpath>`})}),_jsxs(_components.td,{children:[`Binary path — required when `,_jsx(_components.code,{children:`--runner custom`}),` is used`]})]})]})]}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --runner`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` opencode`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --runner`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` claude-code`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --runner`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` custom`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --runner-bin`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /usr/local/bin/my-ai-tool`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-start-name--f--v`,children:_jsx(_components.code,{children:`remoteagent start [name] [-f] [-v]`})}),`\n`,_jsx(_components.p,{children:`Start an agent. Runs in background by default.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # start the only configured agent`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-project`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # start a specific agent by project name`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -f`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # run in foreground (keep terminal open)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` start`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -v`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # run in foreground with verbose logs`})]}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`-f`})}),_jsx(_components.td,{children:`Foreground mode — process stays attached to the terminal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`-v`})}),_jsxs(_components.td,{children:[`Verbose mode — implies `,_jsx(_components.code,{children:`-f`}),`, shows detailed logs`]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-stop-name`,children:_jsx(_components.code,{children:`remoteagent stop [name]`})}),`\n`,_jsx(_components.p,{children:`Stop a running background agent.`}),`\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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` stop`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` stop`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-project`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-logs-name`,children:_jsx(_components.code,{children:`remoteagent logs [name]`})}),`\n`,_jsx(_components.p,{children:`Tail the log file of a background agent in real time.`}),`\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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` logs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-project`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Logs are stored in `,_jsx(_components.code,{children:`~/.remoteagent/agents/{agentId}.log`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-config`,children:_jsx(_components.code,{children:`remoteagent config`})}),`\n`,_jsx(_components.p,{children:`Interactively update settings: API key, preferred language, and per-agent project path or name.`}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`You can also pass flags directly:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,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:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --api-key`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sk-ant-...`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --language`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Italian`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`agentI`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --path`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /new/path/to/project`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`agentI`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` new-project-name`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-set-path-name`,children:_jsx(_components.code,{children:`remoteagent set-path [name]`})}),`\n`,_jsxs(_components.p,{children:[`Shortcut to update the project directory for an agent without going through the full `,_jsx(_components.code,{children:`config`}),` menu.`]}),`\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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` set-path`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` set-path`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-project`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-remove-name`,children:_jsx(_components.code,{children:`remoteagent remove [name]`})}),`\n`,_jsx(_components.p,{children:`Remove an agent: stops it, deletes its local config, and unregisters it from the server.`}),`\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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` remove`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` remove`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-project`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`This action is irreversible. The agent will need to be re-paired from scratch\nif you want to use it again.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-startall`,children:_jsx(_components.code,{children:`remoteagent startall`})}),`\n`,_jsxs(_components.p,{children:[`Start (or restart) all configured agents in background. Useful for reboots or after `,_jsx(_components.code,{children:`reinstall`}),`.`]}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` startall`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-reinstall`,children:_jsx(_components.code,{children:`remoteagent reinstall`})}),`\n`,_jsx(_components.p,{children:`Download and install the latest version of RemoteAgent.CHAT, then restart all running agents.`}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` reinstall`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-list`,children:_jsx(_components.code,{children:`remoteagent list`})}),`\n`,_jsx(_components.p,{children:`Show all configured agents and their current status (online / offline).`}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`3`,id:`remoteagent-help`,children:_jsx(_components.code,{children:`remoteagent help`})}),`\n`,_jsx(_components.p,{children:`Show the built-in help message with all available commands.`}),`\n`,_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:`remoteagent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` help`})]}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`configuration-files`,children:`Configuration files`}),`\n`,_jsx(_components.p,{children:`All config is stored locally. Nothing is transmitted to RemoteAgent.CHAT servers except relay messages.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`File`}),_jsx(_components.th,{children:`Contents`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`~/.remoteagent/config.json`})}),_jsx(_components.td,{children:`Global settings: API key, preferred language`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`~/.remoteagent/agents/{agentId}.json`})}),_jsx(_components.td,{children:`Per-agent: credentials, project path, runner choice`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`~/.remoteagent/agents/{agentId}.log`})}),_jsx(_components.td,{children:`Runtime logs for each agent`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`~/.remoteagent/agents/{agentId}.pid`})}),_jsx(_components.td,{children:`PID file for background process detection`})]})]})]})]})}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":"CLI reference","description":"Complete reference for all remoteagent CLI commands.","href":"/cli-reference"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Commands","slug":"commands","depth":2,"children":[{"title":"remoteagent init","slug":"remoteagent-init","depth":3,"children":[]},{"title":"remoteagent start [name] [-f] [-v]","slug":"remoteagent-start-name--f--v","depth":3,"children":[]},{"title":"remoteagent stop [name]","slug":"remoteagent-stop-name","depth":3,"children":[]},{"title":"remoteagent logs [name]","slug":"remoteagent-logs-name","depth":3,"children":[]},{"title":"remoteagent config","slug":"remoteagent-config","depth":3,"children":[]},{"title":"remoteagent set-path [name]","slug":"remoteagent-set-path-name","depth":3,"children":[]},{"title":"remoteagent remove [name]","slug":"remoteagent-remove-name","depth":3,"children":[]},{"title":"remoteagent startall","slug":"remoteagent-startall","depth":3,"children":[]},{"title":"remoteagent reinstall","slug":"remoteagent-reinstall","depth":3,"children":[]},{"title":"remoteagent list","slug":"remoteagent-list","depth":3,"children":[]},{"title":"remoteagent help","slug":"remoteagent-help","depth":3,"children":[]}]},{"title":"Configuration files","slug":"configuration-files","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"remoteagentchat","siteName":"RemoteAgent.CHAT","title":"CLI reference - RemoteAgent.CHAT","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-14T14:01:24.173Z","originalFileLocation":"cli-reference.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=\"Complete reference for all remoteagent CLI commands.\">\u003cmeta data-mint-head name=\"application-name\" content=\"RemoteAgent.CHAT\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_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/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"CLI reference - RemoteAgent.CHAT\">\u003cmeta data-mint-head property=\"og:description\" content=\"Complete reference for all remoteagent CLI commands.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"RemoteAgent.CHAT\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.remoteagent.chat/cli-reference\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://remoteagentchat.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=CLI+reference\u0026amp;description=Complete+reference+for+all+remoteagent+CLI+commands.\u0026amp;theme=bfb3e23b8019de3f9df06c5e\u0026amp;signature=7d33faef7e23cbaafd31dfb262225892cde41f32f885cb81433d551be1ce7b0e\">\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=\"CLI reference - RemoteAgent.CHAT\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Complete reference for all remoteagent CLI commands.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://remoteagentchat.mintlify.site/_mintlify/api/og/v2?division=Reference\u0026amp;title=CLI+reference\u0026amp;description=Complete+reference+for+all+remoteagent+CLI+commands.\u0026amp;theme=bfb3e23b8019de3f9df06c5e\u0026amp;signature=7d33faef7e23cbaafd31dfb262225892cde41f32f885cb81433d551be1ce7b0e\">\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/remoteagentchat/rKg0QyTCj8CadLFa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"RemoteAgent.CHAT\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1B84FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.remoteagent.chat/cli-reference\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cli-reference.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.remoteagent.chat/#organization\",\"name\":\"RemoteAgent.CHAT\",\"url\":\"https://docs.remoteagent.chat\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/remoteagentchat/px6-PCumF-TyyIWF/logo/light.svg?fit=max\u0026auto=format\u0026n=px6-PCumF-TyyIWF\u0026q=85\u0026s=73d901cf8b03ed547c879ca4b742ae75\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.remoteagent.chat#website\",\"name\":\"RemoteAgent.CHAT\",\"url\":\"https://docs.remoteagent.chat\",\"publisher\":{\"@id\":\"https://docs.remoteagent.chat/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.remoteagent.chat/cli-reference#webpage\",\"url\":\"https://docs.remoteagent.chat/cli-reference\",\"name\":\"CLI reference\",\"description\":\"Complete reference for all remoteagent CLI commands.\",\"dateModified\":\"2026-04-14T14:01:24.173Z\",\"isPartOf\":{\"@id\":\"https://docs.remoteagent.chat#website\"},\"breadcrumb\":{\"@id\":\"https://docs.remoteagent.chat/cli-reference#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.remoteagent.chat/cli-reference#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"RemoteAgent.CHAT\",\"item\":\"https://docs.remoteagent.chat\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CLI reference\",\"item\":\"https://docs.remoteagent.chat/cli-reference\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.remoteagent.chat/cli-reference#article\",\"headline\":\"CLI reference\",\"name\":\"CLI reference\",\"description\":\"Complete reference for all remoteagent CLI commands.\",\"url\":\"https://docs.remoteagent.chat/cli-reference\",\"mainEntityOfPage\":{\"@id\":\"https://docs.remoteagent.chat/cli-reference#webpage\"},\"dateModified\":\"2026-04-14T14:01:24.173Z\",\"publisher\":{\"@id\":\"https://docs.remoteagent.chat/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.remoteagent.chat#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"RemoteAgent.CHAT\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"RemoteAgent.CHAT\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/cli-reference.md","siteName":"RemoteAgent.CHAT","nav":{"global":{"anchors":[{"anchor":"remoteagent.chat","icon":"house","href":"https://remoteagent.chat"},{"anchor":"Telegram bot","icon":"paper-plane","href":"https://t.me/remoteagent_bot"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Overview","pages":[{"title":"What is RemoteAgent.CHAT?","href":"/introduction"}]},{"group":"Getting Started","pages":[{"title":"Quickstart","href":"/getting-started/quickstart"},{"title":"Pairing","href":"/getting-started/pairing"},{"title":"Best Practices","href":"/getting-started/best-practices"}]},{"group":"Runners","pages":[{"title":"Runners overview","href":"/runners/overview"},{"title":"claude-code","href":"/runners/claude-code"},{"title":"claude-sdk","href":"/runners/claude-sdk"},{"title":"opencode","href":"/runners/opencode"},{"title":"codex","href":"/runners/codex"},{"title":"gemini","href":"/runners/gemini"},{"title":"aider","href":"/runners/aider"},{"title":"openclaw","href":"/runners/openclaw"},{"title":"custom","href":"/runners/custom"}]},{"group":"Using the Bot","pages":[{"title":"Sending commands","href":"/bot/sending-commands"},{"title":"Multi-project","href":"/bot/multi-project"},{"title":"Offline alerts","href":"/bot/offline-alerts"}]},{"group":"Platform","pages":[{"title":"Dashboard","href":"/dashboard"},{"title":"Pricing","href":"/pricing"}]},{"group":"Under the Hood","pages":[{"title":"Architecture","href":"/under-the-hood/architecture"},{"title":"Services","href":"/under-the-hood/services"},{"title":"Security","description":"How RemoteAgent.CHAT protects your API keys, code, and credentials — and why the relay model is fundamentally private.","href":"/under-the-hood/security"}]},{"group":"Reference","pages":[{"title":"CLI reference","href":"/cli-reference"}]},{"group":"Support","pages":[{"title":"FAQ","description":"Answers to common questions about RemoteAgent.CHAT setup, security, billing, and usage.","href":"/faq"}]}]}]},"basePath":"","title":"CLI reference - RemoteAgent.CHAT","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":[],"chunks":[]}