Install Raw
Requirements
Section titled “Requirements”- Node.js 22.13 or later.
- Bash. Raw’s
bashtool runs commands through Bash.
Raw is published on npm as @tlelabs/raw. The installed command is raw.
Choose an install method
Section titled “Choose an install method”Install the latest release globally:
npm install -g @tlelabs/rawRun the CLI once through npx:
npx @tlelabs/raw --helpInstall the current default branch. This runs the package’s prepare build, so it downloads build tooling and takes longer than an npm install.
npm install -g github:lploc94/raw-cliBuild from source when you want to work on Raw itself. npm ci also builds the project.
git clone https://github.com/lploc94/raw-cli.gitcd raw-clinpm cinpm install -g .Create the starter configuration
Section titled “Create the starter configuration”Run the configuration initializer once:
raw config initThis creates ~/.config/raw/config.json, or $XDG_CONFIG_HOME/raw/config.json when XDG_CONFIG_HOME is set. The file is created with owner-only permissions (mode 0600). The initializer does not overwrite an existing file.
The starter file defines:
- a default agent named
raw, and - a model alias
localthat points to an Ollama-compatible endpoint athttp://127.0.0.1:11434/v1, with the placeholder model IDYOUR_INSTALLED_MODEL.
Before your first task, replace the placeholder model ID with a model you have installed. The Quickstart shows how.
Check the installation
Section titled “Check the installation”raw --helpraw config listraw config list reports each agent’s model, endpoint and tool selection. It does not print credentials.
Where Raw stores files
Section titled “Where Raw stores files”| Data | Location |
|---|---|
| Configuration | ~/.config/raw/config.json (or $XDG_CONFIG_HOME/raw/) |
| Saved sessions | ~/.local/state/raw/sessions.sqlite (or $XDG_STATE_HOME/raw/), with payload files beside it |
Update or uninstall
Section titled “Update or uninstall”To update to the latest release, run:
npm install -g @tlelabs/raw@latestCheck the installed version with raw --version. Release notes are on GitHub releases.
To uninstall the command, run:
npm uninstall -g @tlelabs/rawThis removes the installed package. It does not remove your configuration or saved sessions. Delete ~/.config/raw/ and ~/.local/state/raw/ yourself if you no longer need them. Back up the state directory first if you want to keep any session history.