Install the TUI
The TUI is the full agent inside your terminal, distributed as a single binary called imaginne. The installation doesn't require sudo.
You need an account in your organization. See Identity & login. The TUI requires an interactive terminal (with a TTY) — it doesn't work in pipes or logs without a terminal.
Install
Run the official installer. It downloads the binary and places it in ~/.imaginne/bin (it doesn't use sudo):
curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh | bash
Reopen your terminal (or reload your PATH) so the imaginne command becomes available. The installer adds ~/.imaginne/bin to your PATH automatically; if you'd rather handle that yourself, see the IMAGINNE_SKIP_PATH_SETUP variable below.
Confirm the installation:
imaginne version
First run
Start the agent:
imaginne
There's no setup wizard. On first run, the TUI opens the login in your browser automatically; complete the login and return to the terminal. From there, the chat screen appears — type a message and press Enter. See Use the TUI.
Channels: PROD and DEV
The TUI has two channels, which coexist side by side because they use different configuration folders:
| Channel | Command | Config folder | Points to |
|---|---|---|---|
| PROD (default) | imaginne | ~/.imaginne/ | ai.nnumbers.com.br |
| DEV | imaginne-dev | ~/.imaginne-dev/ | your organization's validation environment |
Use the DEV channel only if your organization tells you to. See channels.
Subcommands
Running imaginne with no arguments opens the chat. The subcommands cover maintenance and your login session:
| Command | What it does |
|---|---|
imaginne (or imaginne chat) | Opens the interactive chat. |
imaginne version | Shows the installed version. |
imaginne update | Updates the binary to the channel's latest version. |
imaginne config init | Creates/initializes ~/.imaginne/config.yaml. |
imaginne login | Logs in through the browser. |
imaginne logout | Ends the local session. |
imaginne whoami | Shows your identity (without exposing the token). |
imaginne serve | Starts integration mode (used by the VS Code extension). |
imaginne password-login | Legacy password login. Prefer login. |
Root flags
| Flag | Effect |
|---|---|
--config <path> | Uses a specific configuration file. |
--dangerous-bypass | Starts in permissive execution mode (see Autonomy). |
-v, --version | Prints the version. |
--dangerous-bypass requires intentPermissive mode is only available when you start the binary with this flag — you can't enable it through configuration alone. Even then, the workspace boundaries and auditing still apply. See Autonomy & permissions.
Voice
Voice in the TUI depends on a build with the voice tag. Today, only the darwin-arm64 release (macOS with Apple silicon) ships this capability; on other platforms voice may not be available. When present, trigger it with Ctrl+G or F2: the transcription is appended to your message (it doesn't send on its own) and Esc cancels. Details in Voice.
Installer variables
You can tune the installation by exporting variables before running install.sh:
| Variable | What for |
|---|---|
IMAGINNE_BASE_URL | Overrides the download/environment base URL. |
IMAGINNE_CHANNEL | Chooses the channel to install (e.g., dev). |
IMAGINNE_INSTALL_ROOT | Changes the installation folder (default ~/.imaginne). |
IMAGINNE_SKIP_PATH_SETUP=1 | Doesn't touch the PATH — you adjust it manually. |
Example, installing the DEV channel in a custom directory:
IMAGINNE_CHANNEL=dev IMAGINNE_INSTALL_ROOT="$HOME/.imaginne-dev" \
bash -c "$(curl -fsSL https://ai.nnumbers.com.br/downloads/install.sh)"
The variables above belong to the installer. There are also environment variables that affect the TUI at runtime (IMAGINNE_DEBUG, IMAGINNE_DANGEROUS_BYPASS, voice vars, among others) — see Environment variables.
See also
Was this page helpful?
Report a problem on this pageDo not send passwords, keys, tokens, or customer data.