kenn-io--agentsview/desktop

AgentsView Desktop (Tauri)

This directory contains an experimental Tauri desktop wrapper for AgentsView.

The wrapper does not reimplement the web app. Instead, it:

1. Builds the existing Go agentsview binary.
2. Packages it as a Tauri sidecar.
3. Starts it with serve --no-browser on a local port.
4. Loads the local URL in a native webview.

Requirements

• Rust toolchain (rustc, cargo)
• Node.js and npm
• Go (with CGO enabled; same requirements as the main project)

Usage

npm ci
npm run tauri:dev
npm run tauri:build
npm run tauri:build:macos-app
npm run tauri:build:windows

The prepare-sidecar step runs automatically for tauri:dev and tauri:build. It builds agentsview and copies it to src-tauri/binaries/agentsview-<target-triple>.

Environment Notes (Desktop)

When launched from Finder/Explorer, desktop apps usually do not inherit your shell profile (.zshrc, .bashrc), which can hide CLIs like claude, codex, and gemini from PATH.

On macOS/Linux, the Tauri wrapper loads login-shell env ($SHELL -lic 'env -0') for the sidecar (with a short timeout to avoid startup hangs). On Windows this probing is skipped by default.

Optional escape hatch:

• Add overrides in ~/.agentsview/desktop.env:
  • Example: PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin
  • Example: ANTHROPIC_API_KEY=...
• Windows WSL bridge example:
  • CODEX_SESSIONS_DIR=wsl:Ubuntu:/home/me/.codex/sessions (becomes \\wsl.localhost\Ubuntu\home\me\.codex\sessions in desktop wrapper env)
• On Windows, this file resolves to %USERPROFILE%\\.agentsview\\desktop.env.
• Force a custom PATH with AGENTSVIEW_DESKTOP_PATH.
• Skip login-shell env loading with AGENTSVIEW_DESKTOP_SKIP_LOGIN_SHELL_ENV=1.