Deskhand

agent
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 42 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in apps/electron/package.json
  • process.env — Environment variable access in apps/electron/src/main/index.ts
  • process.env — Environment variable access in apps/electron/src/main/ipc.ts
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
An AI-powered desktop agent built on Electron, React, and Claude that reads local files and system context to perform tasks like disk cleanup, data analysis, document translation, and note classification for non-technical users.

Security Assessment
Overall risk: High. Because this is an autonomous desktop agent designed to read local context and invoke tools, it fundamentally requires broad access to the system. The codebase accesses environment variables (likely to retrieve API keys for Claude) and includes a recursive force deletion command (`rm -rf`). While the README claims that sensitive actions like disk cleanup require user confirmation, the underlying AI agent retains the capability to execute destructive shell commands and read local files. No hardcoded secrets were detected, and the project does not request dangerous OS-level permissions, but the inherent nature of an AI tool reading local data and executing system actions introduces significant risk.

Quality Assessment
The project is actively maintained, with its most recent push occurring today. It uses a standard, permissive MIT license and has garnered 42 GitHub stars, indicating a small but growing community interest. The tech stack is modern, utilizing TypeScript, React, and Electron.

Verdict
Use with caution — while actively maintained and transparently licensed, users should be highly aware that the tool has system-level access and can execute destructive commands.
SUMMARY

An AI desktop agent that reads local context and invokes tools to help non-technical users get things done.

README.md

Deskhand

An AI desktop agent that reads your local context and invokes tools
to help non-technical users — and everyone else — get things done.

License Electron React TypeScript Claude

Product Showcase · Builder's QA Column


What It Can Do

Scan disk usage, suggest cleanup targets, and execute only after your confirmation.


Find local data files, analyze them, and produce a structured Excel report.


Then turn that analysis into a visual HTML dashboard — in the same conversation.


Classify Apple Notes by topic and isolate entries containing sensitive information.


Read a local .docx file, translate it, and render the result with full formatting.


Features

Generative UI

AI-generated interactive components for structured input — Playground for style exploration with live preview, Tournament for preference discovery through binary choices, and Guided Form for step-by-step information collection.

Skill Insight

Analyzes your usage patterns, identifies friction points, and recommends skills to install — one click to activate.

Clipboard Intelligence

Background clipboard monitoring gives the AI awareness of your working context. Ask it to summarize your week and it already knows what you've been doing.

More

  • Permission System — Ask mode requires confirmation for file operations; Allow-All mode for trusted workflows
  • Session Management — Persistent conversations with lazy loading, rename, archive, delete
  • Artifact Panel — Preview HTML, Excel, Word, and code in a side panel
  • Activity Tree — Visual step-by-step display of tool execution progress

Architecture

Layer Technology
Runtime Electron 33, Node.js
UI React 18, TailwindCSS 4, Radix UI
State Jotai
AI Claude Agent SDK, Anthropic SDK, MCP SDK
Build Vite 6, esbuild, TypeScript 5
Storage JSONL (append-only)

Data Flow Architecture


Quick Start

Prerequisites: Git and Bun (v1.0+).

git clone https://github.com/YUHAO-corn/Deskhand.git
cd Deskhand
bun install
cp .env.example .env

Add your API key to .env:

ANTHROPIC_API_KEY=sk-ant-xxx   # Get one at https://console.anthropic.com/

Then start the app:

bun run electron:dev
Optional configuration
Variable Description
ANTHROPIC_BASE_URL Custom API endpoint (e.g. OpenRouter)
ANTHROPIC_MODEL Override the default model

Contributing

Contributions are welcome. Feel free to open an issue or submit a pull request.

License

MIT

Acknowledgments

Built with Claude Agent SDK and Anthropic SDK.

Reviews (0)

No results found