Files
wehub-resource-sync f99010fae1
CI / lint (push) Failing after 1s
CI / frontend (push) Failing after 1s
CI / scripts (push) Failing after 1s
CI / Go Test (ubuntu-latest) (push) Failing after 0s
CI / frontend-node-25 (push) Failing after 1s
CI / docs (push) Failing after 0s
CI / coverage (push) Failing after 0s
CI / e2e (push) Failing after 0s
Docker / build-and-push (push) Failing after 1s
CI / integration (push) Failing after 4m43s
CI / Go Test (windows-latest) (push) Has been cancelled
CI / Desktop Unit Tests (Windows) (push) Has been cancelled
Desktop Artifacts / Desktop Build (Linux (arm64)) (push) Has been cancelled
Desktop Artifacts / Desktop Build (Linux) (push) Has been cancelled
Desktop Artifacts / Desktop Build (Windows) (push) Has been cancelled
Desktop Artifacts (macOS) / Desktop Build (macOS (aarch64)) (push) Has been cancelled
Desktop Artifacts (macOS) / Desktop Build (macOS (x86_64)) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:30:36 +08:00

53 lines
1.7 KiB
Markdown

# 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.
1. Packages it as a Tauri sidecar.
1. Starts it with `serve --no-browser` on a local port.
1. 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
```bash
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`.