CommandsService
city task
Task service actions (list/create/run/update/status)
city task
Task system command group.
Usage
city task <subcommand> [options]Subcommands
listcreaterun <title>update <title>delete <title>status <title> <enabled|paused|disabled>enable <title>disable <title>
create key options
--title <title>(required)--description <description>(required)--session-id <sessionId>(required)--when <when>(default@manual, supports cron andtime:ISO8601)--kind <agent|script>--status <enabled|paused|disabled>or--activate(new tasks default toenabled)--body <body>--overwrite
Cron uses the local timezone of the runtime process. For example, when the runtime timezone is Asia/Shanghai, 0 13 * * * means 13
time:... values must include an explicit offset such as +08:00 or Z.
Create dedup now uses exact title only.
update common options
--title <title>/--description <description>--when <when>/--clear-when--kind <agent|script>--session-id <sessionId>--status <status>/--activate--body <body>/--clear-body
run return contract
run is async-accepted and immediately returns:
accepted=truemessageexecutionId
message tells the caller that the task has started, the result will be sent to the user automatically when it finishes, and the agent can continue immediately without waiting for task completion.
After accepted=true, the caller should not manually forward the task output again or proactively read run artifacts for polling. Only inspect run files when the user explicitly asks for debugging or execution details.
Examples
city task list
city task create --title "Daily check" --description "Run tests" --session-id telegram-chat-123 --when "0 10 * * 1-5" --activate
city task run daily-check
city task update daily-check --when "@manual"
city task disable daily-check