kcron manages a local polling service and evaluates registered workspace
entries. It does not currently launch workspace agent tasks.
0.8 support status
The 0.8 binary supports service/catalog inspection on the same macOS arm64 and Linux x64 CLI line. Deferred execution remains a documented Beta limitation.
Implemented commands
kcron status
kcron run-once
kcron start
kcron stop
kcron install
kcron uninstall| Command | Current behavior |
|---|---|
status | Shows Local Core, daemon, and recorded workspace evaluation state |
run-once | Evaluates each registered workspace once and saves its status |
start | Acquires the Local Core lease and starts periodic evaluation |
stop | Stops the running local service |
install | Installs the managed local service |
uninstall | Removes the managed local service |
Deferred execution
For a workspace whose automationEnabled field is false, evaluation records
disabled. For an enabled and valid workspace, evaluation currently records:
lastOutcome: deferred
lastError: Workspace automation is deferred until the central scheduler model is implemented.run-once, start, and install therefore confirm service and catalog
behavior; they do not prove that a scheduled agent task ran or produced a
report. Do not depend on kcron for recurring execution until the command stops
returning the explicit deferred outcome.
See Workspace workflows for catalog discovery.
Schedule storage and ownership
Local Core owns the workspace catalog, automation flag, lease, evaluation time, and recorded outcome. kcron must not create a parallel schedule source.
Output and failure behavior
Status distinguishes disabled, deferred, service failure, invalid catalog entry, and lease conflict. A successful run-once means evaluation completed, not that an agent task ran.
Known limitations
There is no central scheduler or recurring workspace execution in 0.8. Do not advertise or operationally depend on completed scheduled work until the explicit deferred result is replaced by a released contract.