Install

Newen is built and tested on Linux. Every release also carries a Windows build; macOS builds exist but are not released yet. See Platforms.

What you need

• At least one agent CLI, installed and signed in. Newen offers the ones it finds on your PATH:

  Agent	Program	Install
  Claude Code	claude	curl -fsSL https://claude.ai/install.sh | bash (Windows: irm https://claude.ai/install.ps1 | iex)
  Codex	codex	npm install -g @openai/codex
  OpenCode	opencode	see its site
  Hermes Agent	hermes	see its site

  With none installed, Newen opens on No agent installed, with each command and a Copy command button, and Check again once you have one.

• git, for the changes pane and the snapshots behind undo.

• Optional: the GitHub CLI gh, for your GitHub account and pull requests (Newen can install it for you from Settings › Accounts); on Linux, a Secret Service keyring to keep connector secrets.

Download

Every release carries Newen and the Chromium it uses for the browser pane.

Linux

1. Download newen-x86_64-linux.tar.gz.

2. Unpack it and install it for your user:

   mkdir newen && tar -xzf newen-x86_64-linux.tar.gz -C newen && ./newen/newen --install

   It prints where it went: ~/.local/share/newen/app, with each version in versions/ and current pointing at the one that starts.

3. Optional: a menu entry and icon. From a checkout of Newen, scripts/install-desktop.sh writes ~/.local/share/applications/newen.desktop; --install does not.

On Ubuntu 23.10 and later, where AppArmor restricts user namespaces, the browser’s pages run without Chromium’s sandbox; Newen says so in its log.

Windows

1. Download newen-x86_64-windows.zip and unzip it into any folder.

2. Run newen.exe --install from that folder. Newen goes to %LOCALAPPDATA%\Programs\newen.

Caution

The Windows build is not signed: SmartScreen warns on the first download. It is built and checked on every release, but has been tried far less than Linux; no Start menu entry is made yet.

A copy that was not installed with --install runs fine but does not update itself: Settings says Run newen –install to keep it up to date.

Updates

Once installed, Newen updates itself from signed releases: each manifest is signed with Ed25519, every download is checked against its SHA-256 and size, and Newen never downgrades. Installing always waits for you to restart. See Updates.

Uninstall

There is no uninstall command yet. Quit Newen and delete:

• the installation: ~/.local/share/newen/app on Linux, %LOCALAPPDATA%\Programs\newen on Windows;
• your data and settings, if you want them gone too: see Your data for every folder;
• on Linux, ~/.local/share/applications/newen.desktop and ~/.config/autostart/newen.desktop if you made them.

Your projects, and the agents’ own files and sign-ins, are not Newen’s and stay.

Build from source

You need Rust 1.95 and a checkout of limn next to Newen’s, on the branch Newen builds against. The first build downloads the Chromium Embedded Framework unless CEF_PATH points at one.

git clone https://github.com/Niiihuel/newen
git clone -b quill/integration https://github.com/Niiihuel/limn limn-quill-integration
cd newen
cargo run --release -p newen

A build run from a target folder treats itself as built from source: it never checks for updates (Built from source — update with git pull).