CLI 0.6.0 / Bridge 0.5.0: HTTP and portable skill

ValheimCli bridge 0.5.0 adds a local HTTP/JSON interface for agents using existing shell or HTTP tools. The native Rust CLI is optional, needs no Node.js, and retains its tested TCP connection to the same bridge.

• The Thunderstore ZIP and all four CLI ZIPs include skills/valheim-control/SKILL.md.
• Install the skill with npx skills add swear01/valheim-cli --skill valheim-control, or copy the included skill folder to your agent. The skills installer uses Node.js; playing through the mod or native CLI does not.
• Windows CLI opens no console window. Agent startup uses an isolated Windows desktop.
• CI passed on Windows, Linux, macOS ARM64 and macOS x64. Real Valheim 1.0.17 on Windows passed native menu/world selection, movement/look, inventory gates, direct console execution, stop, pause/resume, HTTP/TCP replay rejection, 100 sequential reads and eight concurrent reads. No foreground, cursor-clip or visible console changes were detected during the observed run.

Experimental: multiplayer, long sessions and full gameplay are not verified. During world loading, read requests can expire; wait for readiness. Never blindly retry an uncertain write. Keep the local token private.

Assets: ValheimCli-0.5.0.zip is the Thunderstore mod. valheim-0.6.0-<platform>.zip is the optional native CLI, which embeds the same bridge for its installer. CLI and bridge version numbers are independent.

CLI 0.5.1: Windows console window fix

Windows hotfix: background CLI calls no longer create a console window. Existing-terminal and piped JSON output are preserved. Also fixes launch-agent mistaking the native CLI for a running game.

Download the ZIP for your platform and replace your CLI executable. No Node.js, Bun, Rust or separate .NET installation is required. The game bridge DLL is unchanged; existing bridge installations can be reused.

Experimental prerelease. The Windows desktop check uses a private fixture profile, not a real game session.

Windows automation should call the executable directly and wait for its process; interactive shells and cmd wrappers may return early.

ValheimCli 0.5.0: native Rust CLI

ValheimCli 0.5.0 replaces the JavaScript CLI with standalone Rust executables. No Node.js, Bun, Rust or separately installed .NET runtime is required to use the CLI.

Download the ZIP matching your computer, extract it, and run valheim.exe on Windows or ./valheim on Linux/macOS. Add its folder to PATH if desired. See the README for setup and permissions.

• Windows x64: 572 KiB executable; Windows system DLLs only.
• Linux x64: static musl build.
• macOS: separate Intel and Apple Silicon builds.
• All existing commands, JSON output, token authentication and confirmation requirements remain supported.
• The CLI embeds the unchanged, hash-verified 0.4.0 bridge and Windows Agent startup script. Existing matching bridge installations are reused. The Thunderstore mod does not need a new DLL for this migration.

Validation: all four platform CI jobs passed formatting, lint, Rust tests, C# fixture checks, Rust/C# protocol integration, release builds and packaging. ZIP checksums and dependency notices were checked after download. These checks do not establish live gameplay or isolated-desktop startup reliability for the new native CLI; multiplayer and long sessions remain unverified.

Experimental pre-release. No AI model is bundled. Keep the local token private and inspect state before retrying an action that timed out.

ValheimCli 0.4.0 — native agent controls (experimental)

ValheimCli 0.4.0 experimental release.

• Native character controls, GUI target discovery/activation, game screenshots and opt-in Console.
• Windows Agent mode runs on an isolated desktop without simulated keyboard/mouse input.
• Independent of mod managers; preserves config and refuses duplicate/mismatched bridges.
• Control and Console permissions default off. Local loopback and token authentication.

Install the Thunderstore ZIP through your mod manager, then install the CLI tarball with Node.js 22+: npm install -g ./valheim-agent-cli-0.4.0.tgz. Never install two bridge DLL copies or share the generated token.

Short native Windows gameplay checks used the same bridge source in a separate build. The release DLL passed CI and isolated Windows installation/transport fixtures. Multiplayer, multi-hour endurance and a full playthrough are unverified.

ValheimCli 0.1.0 — experimental

ValheimCli 0.1.0 — experimental local Valheim CLI and BepInEx bridge. Public package name and artwork updated; DLL and gameplay behavior unchanged.

• ValheimCli-0.1.0-Thunderstore.zip: current community package, published as ValheimCli on Thunderstore, dependency string swear01-ValheimCli-0.1.0. Includes original Nordic fantasy artwork and the same tested bridge DLL.
• ValheimCli-artwork.png and ValheimCli-icon-256.png: full artwork and the 256×256 community icon.
• The earlier ValheimCliBridge listing is deprecated. Uninstall that package before installing ValheimCli; do not install both copies of the same plugin. Its original ZIP is retained here for history.
• valheim-agent-cli-0.1.0.tgz: the Node.js CLI. Requires Node.js 22+ on the same computer as the game. Download it and run npm install -g ./valheim-agent-cli-0.1.0.tgz; an npm registry release is not claimed.

The bridge provides JSON status, currently loaded players and opt-in local-host self-teleport. Teleport is disabled by default. It has no bundled AI model, general gameplay automation, arbitrary console/shell execution or remote endpoint. Do not distribute the generated token.

Windows Valheim 1.0.17 / Gale 1.23.1 was smoke-tested in an isolated copied profile and a new singleplayer world on 2026-10-10: 138 successful status reads, including 8 concurrent requests per round; players; invalid-auth/unsupported-operation/default-denied recovery; one approximately 3 m teleport with confirmed arrival; duplicate-write rejection; logout/re-entry and local saving. Automated C# protocol/dispatcher checks and all 5 Node tests pass; GitHub CI passed on Windows and Linux for the reviewed source.

These are finite smoke tests. Multiplayer, remote clients, distant/unknown terrain and long-duration endurance remain unverified. The CLI tarball preserves the original build-time README/metadata, which predate these game tests; the community ZIP README and these release notes state the updated verification scope.

SHA-256:

Current ValheimCli package: dd1dbddc0ff0702cb0fdc465578c24fcf0617847aa17c394274cd37e4c66318d.

Original CLI and legacy package:

valheim-agent-cli-0.1.0.tgz
b257e5948a51b7650f98f38ed76cf6d54daec55ed1f9f96ed513fc36256e3c7f

ValheimCliBridge-0.1.0-Thunderstore.zip
0ac0c34a15a7fe4c32a3972b58bf498ba8978a3d0830d1192511414bf65a26e2

ValheimCliBridge.dll
859297b57d1566c5d3802d68c8154653523b8d59118331fa7b9d44e65c7ae552

Source and issues: https://github.com/swear01/valheim-cli