| name | ngat-cli |
| description | Operate and extend the Typer CLI entrypoints in cli/main.py for engine start/stop and timeframe worker execution. Use when adding commands, wiring new modules into runtime startup, or debugging startup/config/env failures. |
Ngat Cli
Overview
Control process startup and command semantics for the trading engine. Use this skill when command UX, startup order, and runtime wiring need edits.
Submodules
start: load config, login, build feed/broker/storage/strategies, create Engine, run forever.stop: placeholder command; does not terminate remote workers.generate-timeframe: start TimeframeGeneratorWorker through Ray.
Pros
- Keep runtime composition in one entrypoint.
- Keep environment substitution logic close to command parsing.
Cons
- Mix command setup and domain wiring in one file.
- Duplicate login calls and partial unused variables.
Caveats
yaml.SafeLoader hook overrides all strings to run env substitution; treat as fragile.start enters infinite loop after engine.start(); Ctrl+C is only local exit path.stop is informational only; do not rely on it for process control.
Forward Features
- Add explicit lifecycle commands (
status, shutdown, restart-worker).
- Add config validation command before startup.
- Add dry-run smoke test command that checks Redis and broker connectivity only.
