Skip to content

YUHAO-corn/Deskhand

Repository files navigation

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.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors