The attune command-line interface and its natural-language router
Failure modes
| Symptom | Cause | Fix | Severity |
|---|---|---|---|
attune: command not found |
console script not on PATH | reinstall, or use python -m attune.cli_minimal |
medium |
RuntimeWarning: coroutine 'route_user_input' was never awaited |
called route_user_input without await |
it is async — await it / asyncio.run |
high |
| A subcommand errors on args | wrong subcommand or arguments | attune <group> --help |
low |
attune doctor reports problems |
environment/config issue | follow its diagnostics | medium |
Risk areas
route_user_inputis async.is_slash_commandandSmartRouter.list_workflowsare sync;routeis async (route_syncis the sync variant).- Console script vs module. If
attuneisn't on PATH,python -m attune.cli_minimalalways works.
Diagnosis order
attune --help— is the CLI reachable?attune doctor— environment check.attune <group> --help— subcommand usage.- For routing in Python, remember
route_user_inputis async.