{"id":"325857d1-7fbd-4649-929f-f4b449fd4bf4","slug":"wesight","kind":"skill","name":"wesight","summary":"Open-source desktop AI agent workspace with one-click Claude Code, Codex, OpenClaw, Hermes Agent setup and custom LLM model routing.","owner":"freestylefly","repoUrl":"https://github.com/freestylefly/wesight","license":"MIT","licenseTier":"permissive","trust":"community","stars":948,"match":null,"fewStars":false,"format":"skill","createdAt":null,"addedAt":"2026-10-14T06:02:14.881Z","logoUrl":"https://avatars.githubusercontent.com/u/43960064?u=3f0d393870149e009bddc35d16ad46c18310813c&v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["developer-tools"],"tags":["agent-workspace","ai-agent","claude-code","codex","desktop-app","electron","hermes-agent","llm"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-14T06:03:32.569Z","sample":false,"url":"https://conduits.dev/tools/wesight","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"# WeSight\n\n

\n \"WeSight\n

\n\n

\n Desktop AI Agent Workspace for Local Coding Agents\n

\n\n

\n \"GitHub\n \"GitHub\n \"Latest\n \"MIT\n \"macOS\n \"Windows\n

\n\n

\n English | 简体中文\n

\n\nWeSight is an open-source desktop control console for local AI agents. It helps you install or reuse Claude Code, Codex, Kimi Code, OpenClaw, Hermes Agent, OpenCode, Qwen Code, DeepSeek-TUI, and the built-in agent runtime, then gives them a visual workspace for chat, tools, files, IM channels, skills, model providers, runtime metrics, and desktop companion workflows.\n\n> Public releases ship signed and notarized macOS builds for Apple Silicon and Intel, plus a Windows x64 installer. If WeSight helps your agent workflow, a Star makes the project easier for more builders to discover.\n\n## Quick Links\n\n- Website: [wesight.ai](https://wesight.ai/)\n- Latest release: [github.com/freestylefly/wesight/releases/latest](https://github.com/freestylefly/wesight/releases/latest)\n- Screenshots: [Screenshots](#screenshots)\n- Core features: [Core Features](#core-features)\n- Agent engines: [Agent Engines](#agent-engines)\n- Product roadmap: [Product Roadmap](https://github.com/users/freestylefly/projects/1)\n- Development: [Quick Start](#quick-start)\n\n## Why WeSight\n\nTerminal-native coding agents are powerful, while their setup, model routing, permissions, IM entry points, file changes, and runtime metrics often live in separate places. WeSight turns those moving pieces into one desktop workspace:\n\n- Install, detect, and reuse local agent CLIs from a beginner-friendly UI.\n- Run coding agents through a visual chat with tool panels, slash commands, file diffs, and permission prompts.\n- Connect agent tasks to IM channels such as Feishu, with per-engine configuration.\n- Track every task with engine, model, token usage, TTFT, TPS, tool latency, steps, status, and duration.\n- Extend workflows through SkillHub skills, built-in skills, scheduled tasks, memory, and a desktop pet that follows active work.\n\n## Screenshots\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
\n \"WeSight\n \n \"WeSight\n
Cowork Chat
Run local coding agents as a desktop chat with engine and model controls.		Agent Engines
Configure Claude Code, Codex, Kimi Code, OpenClaw, Hermes Agent, OpenCode, Qwen Code, DeepSeek-TUI, and the built-in runtime.
\n \"WeSight\n \n \"WeSight\n
AI Runtime Dashboard
Inspect engine, model, tokens, TTFT, output-phase TPS, estimated model TPS, cost, and status.		Live Workspace
Watch file writes, code changes, tool activity, and generated artifacts while the agent works.
\n \"WeSight\n \n \"WeSight\n
Skills Marketplace
Browse SkillHub categories, install skills locally, and manage installed skills from WeSight.		Studio & Pet
Use a visual office-style workspace and desktop companion to follow active agent tasks.
\n\n## Core Features\n\n- **Agent Engines** - Run Claude Code, Codex, Kimi Code, OpenClaw, Hermes Agent, OpenCode, Qwen Code, DeepSeek-TUI, or the built-in runtime from the same workspace.\n- **One-click setup** - On macOS, WeSight can install supported local CLIs or detect the ones already present on the machine.\n- **Unified model providers** - Configure official OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Qwen, Moonshot, Ollama, OpenRouter, GitHub Copilot, and custom OpenAI-compatible endpoints.\n- **Local CLI configuration** - Use existing Claude Code, Codex, Kimi Code, OpenClaw, Hermes Agent, OpenCode, Qwen Code, or DeepSeek-TUI accounts and config when you already have a working terminal setup.\n- **Graphical tool execution** - View commands, files, permissions, slash commands, outputs, generated images, and tool results inside the chat flow.\n- **IM Agent Hub** - Route Feishu messages into OpenClaw, Hermes Agent, Claude Code, or Codex, with per-engine bot profiles.\n- **AI Runtime Dashboard** - Measure calls by engine, model, source, status, tokens, completion time, TTFT, output-phase TPS, estimated model TPS, tool latency, and agent steps.\n- **Live Workspace** - Open a right-side workspace for live code writing, static diffs, runtime monitoring, task todos, skills, and artifacts.\n- **SkillHub Marketplace** - Discover, categorize, install, enable, disable, update, and remove local WeSight skills.\n- **Scheduled Tasks** - Create recurring agent jobs for research, reports, monitoring, inbox cleanup, and reminders.\n- **Memory and personalization** - Extract useful preferences from conversations and reuse them across future sessions.\n- **Desktop pet and studio** - Keep a lightweight desktop companion and a pixel-style studio view for active tasks.\n\n## ❤️ Sponsors\n\n> [Want to appear here?](public/readme/community/wechat-personal.jpg) Add me on WeChat and include your product name plus a short project sponsorship note in the friend request.\n\n| Sponsor | Description |\n| ------- | ----------- |\n| \"PPToken\" | Project sponsor. PPToken provides API relay and key distribution for ChatGPT, Claude, Gemini and other mainstream AI models, with low latency, high availability, pay-as-you-go billing, and flexible subscription plans. |\n| \"Ciyuan | Project sponsor. Ciyuan API aims to become a one-stop AI interface platform for developers, providing stable, low-latency, and highly available large model API services to make AI application development simpler. |\n\n## Agent Engines\n\n| Engine | Best For | Setup Path |\n| ---------------- | ----------------------------------------------------------- | ----------------------------------------------- |\n| Built-in runtime | General desktop cowork sessions and skills | Included in WeSight |\n| Claude Code | Claude Code workflows with a graphical chat surface | One-click install or existing local CLI config |\n| Codex | Codex CLI workflows, local task execution, and IM control | One-click install or existing local CLI config |\n| Kimi Code | Kimi Code workflows with local login, Skills, and MCP | Official installer or existing local CLI config |\n| OpenClaw | Runtime gateway, IM channels, sandbox-style agent work | Local runtime/CLI reuse or WeSight setup flow |\n| Hermes Agent | Local Hermes Agent gateway and IM-style runtime experiments | Official installer or existing local CLI config |\n| OpenCode | OpenCode terminal agent workflows | One-click install or existing local CLI config |\n| Qwen Code | Qwen-friendly coding workflows and DashScope setups | One-click install or existing local CLI config |\n| DeepSeek-TUI | DeepSeek-TUI HTTP/SSE runtime and tool streaming | One-click install or existing local CLI config |\n\n## Model Providers\n\nWeSight keeps model setup in one place, then maps it into the selected engine when that engine follows WeSight settings.\n\n- Add multiple providers and models.\n- Use official OpenAI, Anthropic Claude, and Google Gemini providers.\n- Add OpenAI-compatible providers for DeepSeek, Qwen, Moonshot, Ollama, OpenRouter, GitHub Copilot, local gateways, or private endpoints.\n- Switch between WeSight-managed model settings and existing local CLI configuration.\n- Import or sync local engine configuration when you want WeSight to manage it.\n\n## Download\n\nPublic desktop builds are published through GitHub Releases:\n\n- Website: [wesight.ai](https://wesight.ai/)\n- Latest release: [github.com/freestylefly/wesight/releases/latest](https://github.com/freestylefly/wesight/releases/latest)\n\nEach stable release includes signed and notarized macOS Apple Silicon and Intel builds, a Windows x64 installer, update metadata, and SHA256 checksums. The Windows installer is currently unsigned and may trigger Microsoft Defender SmartScreen. CI artifacts are short-lived build outputs for maintainers to test before a release is published.\n\n## Download And Install\n\n### macOS\n\nDownload the matching DMG from the [latest release](https://github.com/freestylefly/wesight/releases/latest): `WeSight..mac.arm64.dmg` for Apple Silicon or `WeSight..mac.x64.dmg` for Intel. The release workflow signs, notarizes, and staples both packages. Open the DMG and drag `WeSight.app` into the `Applications` folder.\n\n

\n \"WeSight\n

\n\n### Windows\n\nDownload `WeSight.Setup..exe` from the same release. The current Windows x64 installer has no code-signing certificate, so SmartScreen may show an unrecognized app warning. Check the file against `SHASUMS256.txt` before continuing.\n\n## Quick Start\n\n### Requirements\n\n- Node.js `>=24 <25`\n- npm\n\n### Development\n\n```bash\ngit clone https://github.com/freestylefly/wesight.git\ncd wesight\nnpm install\nnpm run electron:dev\n```\n\nThe Vite dev server runs at `http://localhost:5175`.\n\n### Website Development\n\nThe public website lives in `website/` with its own dependencies and lock file. Install and run it independently from the Electron application:\n\n```bash\nnpm ci --prefix website\nnpm run website:dev\n```\n\nThe website development server runs at `http://127.0.0.1:5173`. Production build and preview commands are available from the repository root:\n\n```bash\nnpm run website:build\nnpm run website:preview\n```\n\nThe existing `wesight-portal` Vercel project uses `website` as its Root Directory, Vite as its framework, Node.js 24.x, and `main` as its Production Branch. Pull requests create Preview Deployments and pushes to `main` create Production Deployments. For a manual preview from an authenticated maintainer machine:\n\n```bash\ncd website\nvercel link --project wesight-portal --scope canghes-projects\nvercel deploy\n```\n\nWebsite download buttons use `website/api/download.js` to resolve the matching macOS DMG or Windows x64 EXE from the latest public GitHub Release. Keep the `arm64` and `x64` DMG assets plus `WeSight.Setup..exe` attached to each production release.\n\nKeep `.vercel/`, local environment files, `node_modules/`, and `dist/` out of Git. The `website/design-reference/` directory contains source concepts for design reference and is excluded from production static assets.\n\n### Development With Agent Runtimes\n\n```bash\n# Start WeSight and detect supported local agent CLIs from Settings\nnpm run electron:dev\n\n# Convenience aliases currently point to the same development entry\nnpm run electron:dev:openclaw\nnpm run electron:dev:hermes\n```\n\nUseful OpenClaw development variables:\n\n```bash\n# Override OpenClaw source location\nOPENCLAW_SRC=/path/to/openclaw npm run electron:dev:openclaw\n\n# Force OpenClaw runtime rebuild\nOPENCLAW_FORCE_BUILD=1 npm run electron:dev:openclaw\n\n# Skip OpenClaw version checkout for local OpenClaw development\nOPENCLAW_SKIP_ENSURE=1 npm run electron:dev:openclaw\n```\n\n## Build\n\n```bash\n# TypeScript + Vite\nnpm run build\n\n# Electron main process\nnpm run compile:electron\n\n# ESLint\nnpm run lint\n\n# Public website\nnpm run website:build\n```\n\n## Packaging\n\n```bash\n# macOS\nnpm run dist:mac\n\n# macOS single-architecture packages\nnpm run dist:mac:x64\nnpm run dist:mac:arm64\n\n# Do not use npm run dist:mac:universal until native modules have an\n# explicit merge strategy for both macOS architectures.\n\n# Windows\nnpm run dist:win\n\n# Linux\nnpm run dist:linux\n```\n\nManaged runtime metadata is declared in `package.json`. Generated runtime folders, build artifacts, local secrets, and packaged release output are ignored by Git.\n\n## Automated Releases\n\nThe `Build Platforms` GitHub Actions workflow builds macOS Apple Silicon, macOS Intel, and Windows x64 in parallel. A manual workflow run performs build-only validation and uploads three Actions Artifacts. A `v*` tag run publishes a GitHub Release after every platform succeeds.\n\nRelease versions use SemVer. Update the root `package.json` version through a normal pull request before creating the tag. From a clean, synchronized `main` branch, validate and publish the tag with:\n\n```bash\nnpm run release:tag -- 1.0.1 --dry-run\nnpm run release:tag -- 1.0.1\n```\n\nThe command verifies the branch, working tree, `origin/main`, package version, and local and remote tags. It then creates an annotated `v1.0.1` tag and pushes only that tag. Prerelease versions such as `1.1.0-rc.1` are published as GitHub prereleases; stable versions become the Latest release.\n\nmacOS signing and notarization use these GitHub Actions secrets:\n\n- `APPLE_ID`\n- `APPLE_APP_PWD`\n- `APPLE_TEAM_ID`\n- `MACOS_CERTIFICATE`\n- `MACOS_CERTIFICATE_PWD`\n\nDo not put certificate contents or passwords in repository files or workflow logs. Windows signing remains disabled until a Windows code-signing certificate is configured.\n\nIf a platform job fails, rerun the failed GitHub Actions jobs for the same commit or tag. The release job waits for all three platforms and uses asset replacement when the release already exists, so a safe rerun updates the existing assets without creating a duplicate release.\n\n## Architecture\n\nWeSight uses Electron process isolation. The renderer never directly accesses Node.js APIs; privileged operations go through a typed preload bridge and IPC handlers in the main process.\n\n

\n \"WeSight\n

\n\n### Main Process\n\n- Window lifecycle, tray behavior, desktop pet windows, and deep links\n- SQLite persistence for settings, sessions, messages, runtime calls, skills, and auth tokens\n- Agent engine routing and external CLI adapters\n- OpenClaw and Hermes gateway lifecycle helpers\n- IM gateway integrations and native Feishu routing\n- Skill management, scheduled tasks, file activity tracking, and runtime telemetry\n\n### Renderer\n\n- React + Redux Toolkit + Tailwind CSS\n- Cowork chat UI, studio view, live workspace, runtime dashboard, and artifacts\n- Engine selector, model selector, settings, skills, MCP, agents, IM, memory, and appearance UI\n- Stream rendering for messages, tool calls, command output, slash command panels, files, images, and permission prompts\n\n### Key Directories\n\n```text\nsrc/main/\n main.ts Electron entry and IPC handlers\n preload.ts Safe renderer bridge\n sqliteStore.ts Local persistence\n coworkStore.ts Session and message storage\n libs/agentEngine/ Engine adapters and router\n libs/externalAgent*.ts External CLI setup and config helpers\n im/ IM gateway integrations\n\nsrc/renderer/\n App.tsx App shell\n components/cowork/ Chat, studio, activity workspace, engine UI\n components/Settings.tsx Model, engine, IM, skills, memory, and app settings\n components/pet/ Desktop companion UI\n services/ IPC wrappers and app services\n store/slices/ Redux state\n\nSKILLs/ Built-in skills\nscripts/ Runtime, packaging, and setup scripts\nsrc/shared/ Shared constants and types\n```\n\n## Built-in Skills\n\nWeSight includes a broad skills library for day-to-day agent work and connects to SkillHub for marketplace installation.\n\n| Area | Examples |\n| -------------- | ------------------------------------------------------------------------- |\n| Research | web search, tech news, stock research, film/music search |\n| Documents | DOCX, XLSX, PPTX, PDF processing |\n| Automation | Playwright, local tools, scheduled tasks |\n| Creative | Remotion video, frontend design, canvas design, image and video workflows |\n| Communication | IMAP/SMTP email and IM channels |\n| Agent building | skill creator, skill vetting, custom planning |\n\nSkills can be installed, enabled, disabled, deleted, and routed from the desktop UI.\n\n## Security Model\n\n- Context isolation is enabled.\n- Node integration is disabled in the renderer.\n- Sensitive operations run through main-process IPC.\n- Tool execution can surface permission requests before running.\n- Local data is stored in SQLite under the app data directory.\n- Runtime folders, build artifacts, generated assets, and local secrets are ignored by Git.\n\n## Product Roadmap\n\nCheck out the [WeSight Product Roadmap](https://github.com/users/freestylefly/projects/1) for current priorities, planned features, and larger product directions. Feel free to [open an issue](https://github.com/freestylefly/wesight/issues) if there is something you want to see.\n\n## Community WeChat Group\n\nScan the QR code below to join the WeSight WeChat group and talk with other builders. The QR code is valid until June 13, 2026; if it expires, follow the official account below to get the latest invite.\n\n

\n \"WeSight\n

\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=freestylefly/wesight&type=Date)](https://star-history.com/#freestylefly/wesight&Date)\n\n## WeChat Official Account\n\nSearch **苍何** on WeChat or scan the QR code below to follow Canghe's original WeChat official account. Reply with **AI** to get more AI prompt and agent workflow resources.\n\n

\n \"Canghe\n

\n\n## Acknowledgements\n\nWeSight is shaped by many excellent open-source projects and agent community practices. Special thanks to:\n\n- [LobsterAI](https://github.com/netease-youdao/LobsterAI) for inspiration around desktop personal assistant agents, README structure, and open-source launch practice.\n- [OpenClaw](https://github.com/openclaw/openclaw) for exploring local agent runtimes, gateways, and IM agent capabilities.\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) for local agent runtime, gateway, and model configuration ideas.\n- [Star-Office-UI](https://github.com/ringhyacinth/Star-Office-UI) for the pixel-style AI studio inspiration.\n- [SkillHub](https://skillhub.lol/skills) for ideas around skill discovery, installation, and marketplace flows.\n- The terminal-agent ecosystem around Claude Code, Codex, Kimi Code, OpenCode, Qwen Code, DeepSeek-TUI, and the builders pushing local AI agent workflows forward.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n\n## Thank You to Our Contributors\n\nThanks to everyone who has contributed PRs to WeSight. This wall updates automatically from GitHub contributors data after new contributions are merged.\n\n
\n\n[![WeSight Contributors](https://contrib.rocks/image?repo=freestylefly/wesight)](https://github.com/freestylefly/wesight/graphs/contributors)\n\n
\n"}