--- canonical: "https://agi-labo.com/tools/cockpit/docs/cockpit-cli/reference/autorun" title: "cockpit autorun" description: "cockpit autorunの構文、オプション、結果、制約をcockpit CLIの正本から自動生成したリファレンスです。" section: "リファレンス" order: 110 pageType: reference lastVerifiedVersion: 4.61.0 lastVerifiedAt: "2026-08-27" draft: false surfaces: - cli operatingSystems: - windows - macos - linux plans: - guest - member navigation: false --- このReference本文は、アプリが配布するcockpit CLIヘルプと同じ英語の正本から自動生成されています。日本語の概念説明と安全な使い方は[cockpit CLI](/tools/cockpit/docs/cockpit-cli)を参照してください。 Usage: `cockpit autorun [options] [--host ] [--port ] [--https true|false]` Manage scheduled automatic tasks. Autorun can create a task on each schedule or send an instruction to one existing task while preserving its conversation. Newly created tasks appear in `cockpit task list`. As with normal tasks, check `cockpit workspaces` and specify the directory with `--directory` — if omitted, a new task starts in the OS temporary folder. Autorun requires an AGI Labo membership. Cockpit verifies the signed-in member for CLI and API operations and again when a schedule executes. An expired or revoked sign-in session, an inactive membership, and a temporary verification failure return distinct errors. Temporary verification failures are not cached. At a scheduled run, a confirmed guest or inactive membership disables a one-time Autorun without starting it; recurring Autoruns remain enabled for their next schedule. A sign-in session that needs renewal or a temporary verification failure instead stores a retry one minute later and keeps the Autorun enabled, including a one-time Autorun. The scheduler remains active when all macOS windows are closed and re-arms every timer after system resume. When Cockpit restarts or resumes with an unhandled scheduled time, it runs one catch-up immediately if the scheduled time is no more than 24 hours old. Older occurrences are recorded as `missed` without starting stale work. Catch-up starts at most one task per Autorun. ```bash cockpit autorun list cockpit autorun get cockpit autorun create --name "Name" --instruction "Instruction" --directory /path/to/repo --type cron --expression "0 9 * * *" cockpit autorun create --name "Name" --instruction "Instruction" --directory /path/to/repo --type interval --minutes 30 cockpit autorun create --name "Auto account" --instruction "Instruction" --directory /path/to/repo --agent-type codex --account auto --type interval --minutes 30 cockpit autorun create --name "Profile task" --instruction "Instruction" --directory /path/to/repo --agent-type claude --claude-profile work --type interval --minutes 30 cockpit autorun create --name "Visual check" --instruction "Instruction" --directory /path/to/repo --agent-type codex --ui-mode visual --type interval --minutes 30 cockpit autorun create --name "Pinned runtime" --instruction "Instruction" --directory /path/to/repo --agent-type codex --ui-mode visual --model gpt-5.4 --effort high --service-tier fast --system-prompt codex-friendly --approval-mode accept-edits --type interval --minutes 30 cockpit autorun create --name "Qoder review" --instruction "Review the repository" --directory /path/to/repo --agent-type qoder --ui-mode visual --system-prompt cockpit --type interval --minutes 30 cockpit autorun create --name "Codex profile task" --instruction "Instruction" --directory /path/to/repo --agent-type codex --codex-profile work --type interval --minutes 30 cockpit autorun create --name "Work browser" --instruction "Check the dashboard" --directory /path/to/repo --browser-identity work --type interval --minutes 30 cockpit autorun create --name "One-time" --instruction "Instruction" --type once --at "2025-06-01T09:00:00" cockpit autorun create --name "Recurring monitor" --instruction "Check task status and report back" --master --type interval --minutes 60 cockpit autorun create --name "Continue review" --instruction "Check progress and continue" --execution-target existing-task --target-task --type interval --minutes 30 cockpit autorun update --name "New name" --enabled false cockpit autorun update --model gpt-5.4 --effort xhigh --service-tier standard --system-prompt cockpit cockpit autorun update --claude-profile default cockpit autorun update --codex-profile default cockpit autorun update --browser-identity default cockpit autorun delete cockpit autorun run # Run immediately cockpit autorun toggle # Toggle enabled/disabled ``` Create/Update options: | Option | Description | |---|---| | --name | Task name | | --instruction | Instruction | | --execution-target | `new-task` (default) or `existing-task` | | --target-task | Existing target task id. Implies `--execution-target existing-task`. `--target-task-id` is an alias | | --directory | Working directory. If omitted, uses a temporary folder. Use `master` for the Master Agent directory | | --agent-type | `claude`, `codex`, `antigravity`, `cursor`, `qoder`, `grok`, `terminal`, `cockpit`. Defaults to the `defaultAgent` setting | | --claude-profile | Claude account profile name or id from `cockpit accounts`; use `default` to select the default account. Claude agent only | | --codex-profile | Codex account profile name or id from `cockpit accounts --agent-type codex`; use `default` to select the default account. Codex agent only | | --account | `auto`, an account profile name or id, or `default` for Claude, Codex, Grok, Antigravity, Cursor, or Qoder. Defaults to `auto` | | --browser-identity | Browser Identity name or id; use `default` for the legacy browser profile. Available for every agent type | | --command | Command to run | | --ui-mode | `visual` or `terminal` when supported by the selected agent | | --model | Runtime model. Supported for visual Claude, Codex, Antigravity, Cursor, Qoder, Grok, and Cockpit Autoruns | | --effort | Reasoning level supported by the selected model | | --service-tier | Codex service tier: `standard` or `fast` | | --system-prompt | Built-in or custom system prompt for visual Claude, visual Codex, visual Qoder, or Cockpit. `--system-prompt-preset` is a compatibility alias | | --approval-mode | `supervised`, `accept-edits`, or `full-access`, when supported by the selected agent. Antigravity visual tasks cannot prompt for approval, so `supervised` denies every tool that needs permission; choose `accept-edits` or `full-access` for work that edits files or runs commands | | --type | `once`, `interval`, `cron` | | --at | ISO datetime for `once` | | --minutes | Interval in minutes for `interval` | | --expression | Cron expression for `cron` | | --enabled | `true` / `false`. Defaults to `true` | | --master | Run as Master Agent. The directory is set automatically | Create and update reject options that the selected agent, UI mode, or model does not support. Each Autorun stores a runtime snapshot, so changing global model, reasoning, service tier, system prompt, approval, account, or UI defaults does not change existing Autoruns. Auto is stored as the account selection mode rather than a concrete profile; Cockpit chooses the best available account independently for every execution and can switch again if that task reaches a usage limit. When an existing target is busy, Cockpit stores the instruction in a persistent main-process queue and delivers it after the task reaches `readyForNextPrompt`; there is no timeout. Completed and error tasks are resumed automatically. Usage-limited tasks stay queued until account recovery or reset. If the target is deleted, cannot be resumed, or is a Windows Terminal task whose foreground process cannot be verified, Cockpit records a failed delivery, disables the Autorun, and sets `needsAttention`. `list` and `get` return `lastRunStatus` (`created`, `queued`, `delivered`, `skipped-membership`, `skipped-lock`, `skipped-period`, `missed`, or `failed`), `lastRunScheduledAt`, `lastRunDetail`, and `lastTaskId` in addition to `lastRunAt`, `nextRunAt`, and `nextRunScheduledAt`. `skipped-lock` means another launch for the same Autorun was still starting; Cockpit never holds an occurrence back because a previously created task is unfinished. `nextRunAt` is the next attempt time, while `nextRunScheduledAt` preserves the original occurrence during retries. They also return `executionTarget` and `targetTaskId` plus `effectiveRuntimeSettings` for new-task Autoruns. If a saved fixed account profile is no longer available, another saved combination becomes invalid, or an existing target becomes unavailable, Cockpit disables the Autorun instead of silently switching settings and returns `needsAttention` with the affected field. Every created, queued, delivered, skipped, missed, or failed occurrence is appended as one JSON line to `data/cockpit/logs/autorun-executions.jsonl` under the AGI Tools data directory. A queued occurrence gets a later delivered or failed record when delivery finishes. Repeated retries of the same unchanged outcome are recorded once. Authentication or membership skips, missed runs, and failures surface an attention state and notification; overlap and period-dedup skips remain informational. The log rotates at 5 MB and keeps two archives. ## Remote Devices Configure aliases with `cockpit devices` first, then target a remote Cockpit with autorun commands, same as `cockpit task`. `--host` can be placed before or after the subcommand. ```bash cockpit autorun list --host studio cockpit autorun run --host studio ``` | Option | Description | Default | |---|---|---| | --host | Target remote device via sync server (host or alias) | - | | --port | Remote sync server port | 47280 | | --https | Use HTTPS for the remote sync server | true |