> ## Documentation Index > Fetch the complete documentation index at: https://docs.fased.ai/llms.txt > Use this file to discover all available pages before exploring further. # task # `fased task` Use `fased task` to manage Agent-owned scheduled work from the terminal. Browser equivalent: **Agent > Tasks** for the selected Agent. Related: * [Scheduled Tasks](/automation/cron-jobs) * [Agents, Sessions, And Tasks](/concepts/agents-sessions-tasks) * [Task Operating Layer](/concepts/task-operating-layer) Run `fased task --help` for the full command surface. ## Common flow Create a recurring isolated task: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task add \ --agent ops \ --session-key "agent:ops:webchat:direct:health-review" \ --name "Service health review" \ --every 1h \ --session isolated \ --message "Check service health and report here." \ --announce \ --channel telegram \ --to "123456789" ``` Choose exactly one schedule flag: `--at`, `--every`, or `--cron`. Isolated tasks use `--message`. Main-session tasks use `--system-event`. Operate the task: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task list fased task run fased task run --due fased task edit --every 30m fased task disable fased task enable fased task rm ``` Inspect runs: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task runs --id --limit 50 fased task last fased task run-show ``` ## Run control Use run-id commands when a specific queued or leased run is stuck, failed, or needs retry: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task status fased task cancel-run fased task retry-run fased task clear-stale ``` These operate on run ids, not task ids. ## Repair and sources When a task stops because access, source quality, or evidence is missing, use: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task repair configure fased task repair add-source "https://example.com/source" fased task repair retry fased task repair stop-source ``` Trusted source memory: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task sources list fased task sources add "https://example.com/source" fased task sources show fased task sources enable fased task sources disable fased task sources forget ``` ## Workflows and graphs Inspect workflow runs: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task flow list --agent research fased task flow show fased task flow cancel --reason "operator stop" ``` Preview or run graph JSON: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task workflow preview --file ./release-workflow.json fased task workflow run --file ./release-workflow.json --agent research ``` ## Ask Agents Tasks can store coordination intent for local Agent review: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task ask --agent research fased task approve ``` The run detail shows helper Agent evidence under the same run-history chain. ## Workers Run an external task worker: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task worker fased task worker --once fased task worker --worker-id worker-a --max-runs 2 --poll-ms 500 ``` Install a supervised worker: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task worker install fased task worker status fased task worker restart ``` The gateway schedules runs. Workers lease queued steps and write results back to the same local task store. ## Smoke checks ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} fased task smoke fased task smoke --channel telegram --to "123456789" fased task smoke --skill wallet --input '{"action":"balance"}' fased task smoke --model openrouter/provider-model fased task smoke --repair ``` Use `--keep` when you want to retain temporary smoke tasks for inspection. ## Channel commands Connected command surfaces can create and edit tasks with natural text: ```text theme={"theme":{"light":"min-light","dark":"min-dark"}} /task new remind me every hour to stand up /task new check provider health hourly /task edit every 30m /task edit send here /task edit use no model /task edit stop after success ``` Tasks created from Chat, Telegram, Discord, Slack, or another channel are still owned by an Agent and Session and appear in **Agent > Tasks**. ## Compatibility The internal RPC/storage names still use `cron.*` and `~/.fased/cron/...`. Prefer `fased task ...` in user docs and normal operator instructions.