Installation

On Windows x64, install uuldana-cli from npm. On Linux and macOS, build it from source.

Install with npm (Windows x64)

You need Node.js 18 or newer. It only runs a small launcher; the program itself is a native binary.

npm install -g uuldana-cli
uuldana --version

The package is called uuldana-cli. The command it installs is uuldana. The newest version on npm is v0.1.0.

The binary is not code signed yet, so Windows SmartScreen may show a warning the first time you run it.

Build from source (any system)

You need a copy of the uuldana-cli source and a current stable Rust toolchain. See Requirements for platform-specific build tools. Open a terminal in the root of the checkout and run:

cargo build --release -p uuldana-cli

The completed build writes the binary to:

Copy the binary to a directory on your PATH, then check that your terminal can find it:

uuldana --version

The command prints the installed uuldana-cli version. If your terminal cannot find the command, check the directory you added to PATH and open a new terminal.

On Linux and macOS the test suite passes in CI, but a real agent has not been run through uuldana-cli there yet. See Current implementation status.

Check your agents

You also need at least one native coding agent installed and signed in, through its own tools. Then run:

uuldana providers

It lists the agents found on this machine and what was learned about them. The first run asks the programs on your search path for --help, which takes a while; after that it is immediate. See Known limitations for what that implies.

Next: configure your agents

Create your initial configuration to choose agents and their priority, then start your first session.

For building distributable archives and how the npm package is published, see Release information.