Skip to main content
The Talos CLI scaffolds applications, modules, controllers, services, and other resources from code generation templates. It ships as a self-contained talos binary (aliased as oo) distributed through GitHub releases — there is no npm package to install.

​
Prerequisites

The scaffolding commands generate a project that runs on Bun, so install Bun before you start building:
Verify the installation:

​
Installation

Install the talos binary with the official installer for your platform. It downloads the latest release, places the binary in ~/.talos/bin, creates the oo alias, adds the directory to your PATH, and installs shell completions.
Restart your shell so the updated PATH takes effect, then confirm it is available:
Run any command by name, for example:

​
Custom install location or version

Both installers honour a couple of environment variables:
  • TALOS_INSTALL — install directory (default ~/.talos)
  • TALOS_VERSION — a specific release tag to install (default latest)

​
Upgrading

Once installed, upgrade the CLI to the latest release with the built-in upgrade command:
The command checks GitHub for the newest release and compares it with your installed version. If you are already on the latest version, it reports so and exits without making changes. Otherwise it re-runs the installer for you and confirms the new version once the upgrade completes. If the automatic upgrade fails, you can always upgrade manually by re-running the installer:

​
Uninstalling

Remove the CLI with the matching uninstall script:

​
Shell completions

The CLI ships context-aware completions for the talos and oo binaries, including per-command option suggestions and dynamic values such as module and package names. Completions are available for Zsh, Bash, and Fish — install the one for your shell.
This writes the completion files to ~/.zsh/_oo and ~/.zsh/_talos. Then add the following to your ~/.zshrc if it is not already present, so Zsh can find and load the completions:
Reload your shell or open a new terminal, then press Tab after a command to see available options: