CLI
The installed udiot binary is preview tooling in this RC. Commands and templates
exist, but generated applications/provider paths are not all certified.
Review generated code and compile/test it before use.
Installation and help
npm install --save-exact @tagna/udiot@1.0.0-rc.1
npx --no-install udiot --help
npx --no-install udiot generate --help
npm ls @tagna/udiot
Use the project-local binary to avoid silently running another version.
npx --no-install udiot --version prints the installed package's version.
Commands
| Command | Purpose |
|---|---|
init |
Initialize configuration in the current project |
generate <type> <name> (g) |
Component, service, controller, event or handler scaffolding |
list |
List available generators |
create <description...> (c) |
Intent-driven scaffolding |
wizard <type> (w) |
Interactive component/service/feature wizard |
enhance <file> (e) |
Review code suggestions and optional fixes |
docs <type> |
Documentation/API artifact tooling |
config validate/diff/scaffold/trace |
Environment configuration tools |
api compare/migrate |
OpenAPI comparison and migration guidance |
sdk publish <outDir> |
Publish an application's generated SDK (--name, --package-version, --registry npm|github, --dry-run) |
telemetry setup/verify/observe |
Telemetry configuration and evaluation |
There are no top-level analyze, suggest, build or serve commands in
this CLI. Use the documented application build scripts and programmatic APIs.
Workflow
npx --no-install udiot init
npx --no-install udiot generate service Orders --dry-run
npx --no-install udiot generate service Orders --with-tests --yes
init and generation write project files. generate and create ask before
writing unless given --yes, and nothing is overwritten without --force.
Only use flags shown by that command's --help; flags are not universal.
For example, wizard has no --dry-run option.
The package runs compiled CLI code and bundled templates. Source ts-node
fallback and UDIOT_TS_NODE_MODE are contributor details, not consumer setup.
Guides
- Generation, intent-driven generation
- Wizards, enhancement
- Configuration commands, telemetry commands
- API artifacts, comparison, migration and SDK tooling
Keep provider keys in environment/secret configuration. Prompts and source submitted to configured AI services may leave your machine. Do not include secrets or private customer data. Dry-run is a file-write preview, not a guarantee of no provider calls or cost. SDK publishing changes an external registry; it is not the UDIOT framework release workflow.