LocalDesk

Name: LocalDesk
Author: vakovalskii

Issues

🤖 Desktop AI Assistant with Local Model Support - OpenAI SDK compatible agent with memory system, file operations, web search, and modern UI. Supports vLLM, Ollama, Qwen, Llama, and more.

186stars

35forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/vakovalskii/LocalDesk

Getting Started

Guides for using ai agents skills like LocalDesk.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportIssues

Last scanned: 5/30/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@chevrotain/cst-dts-gen: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "@chevrotain/gast: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "@xmldom/xmldom: xmldom: XML injection via unsafe CDATA serialization allows attacker-controlled markup insertion",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "axios: Axios has a NO_PROXY Hostname Normalization Bypass that Leads to SSRF",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "brace-expansion: brace-expansion: Zero-step sequence causes process hang and memory exhaustion",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "chevrotain: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "chevrotain-allstar: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "dompurify: DOMPurify contains a Cross-site Scripting vulnerability",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "flatted: flatted vulnerable to unbounded recursion DoS in parse() revive phase",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "follow-redirects: follow-redirects leaks Custom Authentication Headers to Cross-Domain Redirect Targets",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "langium: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "lodash-es: lodash vulnerable to Code Injection via `_.template` imports key names",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "mermaid: Mermaid Gantt Charts are vulnerable to an Infinite Loop DoS",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "picomatch: Picomatch: Method Injection in POSIX Character Classes causes incorrect Glob Matching",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "pkg: Pkg Local Privilege Escalation",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "tar: tar has Hardlink Path Traversal via Drive-Relative Linkpath",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "uuid: uuid: Missing buffer bounds check in v3/v5/v6 when buf is provided",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "vm2: vm2 has access to `VM2_INTERNAL_STATE_DO_NOT_USE_OR_PROGRAM_WILL_FAIL`",
      "severity": "critical"
    },
    {
      "type": "npm-audit",
      "message": "ws: ws: Uninitialized memory disclosure",
      "severity": "medium"
    }
  ],
  "status": "FAILED",
  "scannedAt": "2026-05-30T15:45:41.358Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is LocalDesk?

LocalDesk is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by vakovalskii. 🤖 Desktop AI Assistant with Local Model Support - OpenAI SDK compatible agent with memory system, file operations, web search, and modern UI. Supports vLLM, Ollama, Qwen, Llama, and more. It has 186 GitHub stars.

Is LocalDesk safe to use?

LocalDesk failed SkillsLLM's automated security scan, which flagged one or more high-severity issues. Review the Security Report section carefully before using it.

How do I install LocalDesk?

Clone the repository with "git clone https://github.com/vakovalskii/LocalDesk" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is LocalDesk written in?

LocalDesk is primarily written in TypeScript. It is open-source under vakovalskii on GitHub, so you can review or fork the full source.

Are there alternatives to LocalDesk?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh LocalDesk against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

Claude-Code-Swarm-Toolkit ratel

LocalDesk

Desktop AI Assistant with Local Model Support

https://github.com/user-attachments/assets/a8c54ce0-2fe0-40c3-8018-026cab9d7483

✨ Features

Core Capabilities

✅ Task Planning — visual todo panel with progress tracking, persisted per session
✅ Scheduled Tasks — create reminders and recurring tasks with auto-execution
✅ OpenAI SDK — full API control, compatible with any OpenAI-compatible endpoint
✅ Local Models — vLLM, Ollama, LM Studio support
✅ Code Sandboxes — JavaScript (Node.js vm) and Python (system subprocess) execution
✅ Document Support — PDF and DOCX text extraction (bundled, works out of the box)
✅ Web Search — Tavily and Z.AI integration for internet search
✅ Telegram Parsing — render t.me channels with reactions, views, auto-scroll for older posts
✅ Security — directory sandboxing for safe file operations
✅ Cross-platform — Windows, macOS, Linux with proper shell commands

UI/UX Features

✅ Modern Interface — React + Tauri with smooth auto-scroll and streaming
✅ Message Editing — edit and resend messages with history truncation
✅ Session Persistence — sessions survive app restart (SQLite backed)
✅ Session Management — pin important sessions, search through chat history
✅ Keyboard Shortcuts — Cmd+Enter/Ctrl+Enter to send messages
✅ Spell Check — built-in spell checking with context menu suggestions
✅ Permission System — ask/default modes for tool execution control

Advanced Features

✅ Memory System — persistent storage of user preferences in ~/.localdesk/memory.md
✅ Token Tracking — display input/output tokens and API duration
✅ Optimized Streaming — requestAnimationFrame-based UI updates (60fps)
✅ Stop Streaming — interrupt LLM responses at any time
✅ Loop Detection — automatic detection of stuck tool call loops (5+ sequential same-tool calls)
✅ Request Timeouts — 5-minute timeout with auto-retry for LLM requests
✅ Session Logging — full request/response JSON logs per iteration in ~/.localdesk/logs/sessions/

🤔 Why LocalDesk?

Open Architecture & Full Control

LocalDesk isn't just another AI assistant — it's a framework you own. Built with TypeScript and Electron, every component is transparent and modifiable:

Readable codebase — well-structured, documented code you can understand
Easy customization — add new tools, modify prompts, change UI without black boxes
Your rules — adjust behavior, safety limits, and workflows to match your needs
No vendor lock-in — works with any OpenAI-compatible API (vLLM, Ollama, LM Studio)

100% Local & Private

Everything runs on your machine:

Local inference — use Ollama, vLLM, or LM Studio for complete privacy
No data collection — your conversations never leave your computer
Offline capable — works without internet (except web search tools)
Sandboxed execution — secure JavaScript sandbox and file operation restrictions

Experiment & Iterate

Perfect for developers, researchers, and AI enthusiasts:

Test local models — compare Qwen, Llama, DeepSeek, and others
Debug API calls — full request/response logs for every interaction
Prototype tools — add custom functions in minutes
Monitor performance — track tokens, timing, and resource usage

Real Use Cases

# Run Ollama locally (free, 100% private)
ollama serve
# Configure LocalDesk: http://localhost:11434/v1

# Or use vLLM for faster inference
vllm serve Qwen/Qwen2.5-14B-Instruct --port 8000
# Configure LocalDesk: http://localhost:8000/v1

TL;DR: LocalDesk gives you the power of ChatGPT/Claude with the freedom of open source and privacy of local execution.

🚀 Quick Start

Prerequisites

Rust 1.74+ (install)
Node.js 20+
Python 3 (for execute_python tool)

Development (macOS/Linux)

# Clone and enter
git clone https://github.com/vakovalskii/LocalDesk.git
cd LocalDesk

# Install dependencies
npm install

# Run in development mode
make dev

Tests

npm run test

Build Standalone App

# Build DMG (macOS)
make bundle

# Output: LocalDesk-0.0.8.dmg

Manual Build Steps

# 1. Build sidecar binary
npm run build:sidecar

# 2. Build Tauri app
cd src-tauri && cargo build --release

# 3. Create DMG
hdiutil create -volname "LocalDesk" \
  -srcfolder src-tauri/target/release/bundle/macos/LocalDesk.app \
  -ov -format UDZO LocalDesk-0.0.8.dmg

Windows (coming soon)

Windows build requires cross-compilation setup. Check .github/workflows/ for CI builds.

Configuration

Click Settings (⚙️) in the app
Configure your API:
- API Key — your key (or dummy-key for local models)
- Base URL — API endpoint (must include /v1)
- Model Name — model identifier
- Temperature — 0.0-2.0 (default: 0.3)
Click Save Settings

Example Configurations

Local vLLM:

{
  "apiKey": "dummy-key",
  "baseUrl": "http://localhost:8000/v1",
  "model": "qwen3-30b-a3b-instruct-2507"
}

OpenAI:

{
  "apiKey": "sk-...",
  "baseUrl": "https://api.openai.com/v1",
  "model": "gpt-4"
}

🎯 Skills Marketplace

Browse and install verified skills for LocalDesk: Skills Marketplace

🛠️ Available Tools

All tools follow snake_case naming convention (verb_noun pattern):

File Operations

Tool	Description
`run_command`	Execute shell commands (PowerShell/bash)
`read_file`	Read text file contents
`write_file`	Create new files
`edit_file`	Modify files (search & replace)
`search_files`	Find files by glob pattern (`.pdf`, `src//.ts`)
`search_text`	Search text content in files (grep)
`read_document`	Extract text from PDF/DOCX (max 10MB)

Code Execution

Tool	Description
`execute_js`	Run JavaScript in secure Node.js vm sandbox
`execute_python`	Run Python code (system Python with pip packages)

Web Tools

Tool	Description
`search_web`	Search the internet (Tavily/Z.AI)
`extract_page`	Extract full page content (Tavily only)
`read_page`	Read web page content (Z.AI Reader)
`render_page`	Render JS-heavy pages via Chromium (Telegram, SPAs)

Task Management

photo_2026-01-19_00-55-13

Tool	Description
`manage_todos`	Create/update task plans with visual progress tracking

Scheduler

Tool	Description
`schedule_task`	Create, list, update, delete scheduled tasks

Features:

One-time reminders — "remind me in 30 minutes"
Recurring tasks — every minute, hour, day, week, month
Auto-execution — tasks with prompts automatically start new chat sessions
Native notifications — macOS system notifications
Default model — set preferred model for scheduled tasks

Memory

Tool	Description
`manage_memory`	Store/read persistent user preferences

Security: All file operations are sandboxed to the workspace folder only.

📦 Building

Windows

# Build executable and installer
npm run dist:win

# Output: dist/LocalDesk Setup 0.0.8.exe

macOS

# Build DMG (ARM64)
npm run dist:mac-arm64

# Build DMG (Intel x64)
npm run dist:mac-x64

Linux

# Build AppImage
npm run dist:linux

🔐 Data Storage

Application Data

Windows: C:\Users\YourName\AppData\Roaming\localdesk\
macOS: ~/Library/Application Support/localdesk/
Linux: ~/.config/localdesk/

Files:

sessions.db — SQLite database with chat history, todos, scheduled tasks, and settings
api-settings.json — API configuration
skills-settings.json — Skills marketplace configuration

Global Data

~/.localdesk/memory.md — persistent memory storage
~/.localdesk/logs/sessions/{session-id}/ — per-session API logs:
- turn-001-request.json — full request (model, messages, tools, temperature)
- turn-001-response.json — full response (usage, content, tool_calls)

🛠️ Contributing

See CURSOR.md for development guidelines and project architecture.

⭐ Star History

📄 License

LocalDesk Community License — free for individuals and companies with revenue under $1M/year. Commercial license required for larger organizations.

See LICENSE for full terms.

Made with ❤️ by Valerii Kovalskii