MarketDeck docs
jobs
Local registry and process control for long-running MarketDeck tasks.
marketdeck jobs tracks long-running work such as reports, backtests, sweeps, agent runs, exports, and diagnostics. Jobs have stable ids, status, optional PIDs, command argv, stdout/stderr log paths, and timestamps.
Usage#
marketdeck jobs <list|show|run|start|cancel|logs|record|remove|clear> [flags]| Subcommand | What it does |
|---|---|
list | Show recent registry entries. |
show <id> | Show one job with argv, cwd, PID, exit state, and log paths. |
run -- <argv...> | Run a command in the foreground and record stdout/stderr logs. |
start -- <argv...> | Start a background job and return immediately with the job id. |
cancel <id> | Send a signal to a running background job. |
logs <id> | Print stdout or stderr logs, optionally following new lines. |
record | Add an externally-managed job entry. |
remove <id> | Delete one registry entry. |
clear | Delete entries, optionally by status. |
| Flag | Applies to | What it does |
|---|---|---|
--name N | run, start, record | Human-readable job name. |
--type T | run, start, record | Job type such as report, backtest, or agent. |
--cwd PATH | run, start | Working directory for the process. |
--status S | list, record, clear | Filter or set job status. |
--limit N | list | Maximum rows to return. |
--signal SIGTERM | cancel | Signal sent to the job runner. |
--stderr | logs | Read stderr instead of stdout. |
--tail N | logs | Return the last N lines. |
--follow | logs | Keep streaming log output. |
Examples#
marketdeck jobs start --name daily-report --type report -- marketdeck reports daily --out daily.json
marketdeck jobs list --status running --format json
marketdeck jobs show job-abc123 --format json
marketdeck jobs logs job-abc123 --tail 100
marketdeck jobs logs job-abc123 --stderr --follow
marketdeck jobs cancel job-abc123Background jobs are supervised by a small CLI runner that records completion status and log sizes after the child process exits. This keeps the registry useful for terminal users, WebUI, GNOME, and automation without adding a daemon RPC surface.