skales

Name: skales
Author: skalesapp

Warning

Personal AI desktop agent for Windows, macOS, Linux, Android & iOS. Set a goal, it works on its own. Teams (pair two desktops, agents + humans), Agent2Agent, Workflows, Codework, multi-agent orgs, desktop + browser automation. 15+ AI providers, BYOK. No Docker, no terminal. Agent Skills (SKILL.md). Migration importer. Recurring autonomous tasks.

1,289stars

191forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/skalesapp/skales

Getting Started

Guides for using ai agents skills like skales.

Security ReportWarning

Last scanned: 5/3/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@tootallnate/once: @tootallnate/once vulnerable to Incorrect Control Flow Scoping",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "@xmldom/xmldom: xmldom: Uncontrolled recursion in XML serialization leads to DoS",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "app-builder-lib: Vulnerability found",
      "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": "builder-util: Vulnerability found",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "dmg-builder: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "electron: Electron has ASAR Integrity Bypass via resource modification",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "electron-builder: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "electron-builder-squirrel-windows: Vulnerability found",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "electron-publish: Vulnerability found",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "esbuild: esbuild enables any website to send any requests to the development server and read the response",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "http-proxy-agent: Vulnerability found",
      "severity": "low"
    },
    {
      "type": "npm-audit",
      "message": "lodash: lodash vulnerable to Code Injection via `_.template` imports key names",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "tar: node-tar Vulnerable to Arbitrary File Creation/Overwrite via Hardlink Path Traversal",
      "severity": "high"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-05-03T06:27:44.543Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is skales?

skales is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by skalesapp. Personal AI desktop agent for Windows, macOS, Linux, Android & iOS. Set a goal, it works on its own. Teams (pair two desktops, agents + humans), Agent2Agent, Workflows, Codework, multi-agent orgs, desktop + browser automation. 15+ AI providers, BYOK. No Docker, no terminal. Agent Skills (SKILL.md). Migration importer. Recurring autonomous tasks. It has 1,289 GitHub stars.

Is skales safe to use?

skales returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install skales?

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

What programming language is skales written in?

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

Are there alternatives to skales?

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 skales 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

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

236,865

getspecstory nocturne_memory

The private AI that lives on your computer and does real work, not just chat.

In 30 seconds

What it is — an AI agent that runs on your own computer, with access to your files, browser, calendar and email, and does multi-step work on its own.

What makes it different — it installs like any normal app (no Docker, no terminal, ~30 seconds), it runs on your machine instead of someone's cloud, and it is built to be usable by people who are not developers.

What it costs — nothing to start. Skales IQ is a free built-in trial that needs no API key. After that, bring your own key from 15+ providers, or run fully offline with Ollama and pay nobody.

Three things people use it for most

🎯 Hand it a goal and close the lid. /goal build me a trading bot runs in the background across many steps and picks up where it left off.
💻 Point it at a folder and let it code. /code binds a folder to any chat, with inline diffs and one-click undo.
📱 Reach it from your phone. Pair via QR and your phone drives this desktop's full tool set — or run the phone standalone.

⬇ Download · 📖 Docs · 🎬 Demo

About this repository. This is where Skales is distributed: releases, the changelog, install guides and the issue tracker. Skales itself is closed source under BSL 1.1, and the product is the signed application you download from skales.app. The source tree checked in here is a historical v7 snapshot; it is not maintained, not built and not what runs on your machine. Reporting a security issue? Please read SECURITY.md first. It says what is in scope, and it will save you a lot of time.

Demo
⚡ Why Skales?
🚀 What Skales Can Do
🔌 Integrations
🧠 15+ AI Providers
🌍 Discover
📊 Skales Wrapped
🛡️ Privacy and Security
📦 Installation
🏗️ Architecture
🤝 Community
📜 License
🆓 Try Skales Free

Demo

⚡ Why Skales?

Skales is an AI agent that lives on your desktop. Not in a browser tab, not behind a restrictive API, not in a complex Docker container. It sits on your machine, has access to your files, your browser, your calendar, your email, and it does real work.

	Typical AI Agents	Skales 🦎
Setup	Docker, Terminal, Python CLI	Download EXE/DMG/AppImage, double-click
RAM Usage	1.5GB - 3GB+	~300MB
OS Support	Linux / Docker required	Windows + macOS + Linux native
Time to first task	Hours to days	30 seconds
Privacy	Cloud only	Local-first, BYOK, Offline capable
Updates	Manual Git pull and rebuild	One-click auto-updater
Security	Unsigned scripts	Apple Developer ID signed (Windows signing coming)
Emoji	Platform-dependent	Consistent Noto emojis + animated brand emojis
Migration	Start from scratch	Import from ChatGPT, Claude, OpenClaw, Hermes

A 6-year-old built a game with it. A grandmother approved the setup.

🚀 What Skales Can Do

🎯 Background Goals

Type /goal and what you want — /goal build me a trading bot — and Skales takes it on as ongoing work instead of a single reply. It plans the steps and runs the whole task on its own, in the background, with the chat closed.

It does not ask you to continue. It stops when the task is done, when it genuinely needs your decision, or before a consequential action like sending an email — where it asks once, with a one-tap always-allow.
It survives you closing the app. Reopen and it picks up where it left off. A goal that parked at its limit resumes itself while you are idle.
It starts on its own when it should. A long chat that grows into a real multi-step task is carried on as a goal, and Skales can recognize a goal from how you ask.
Run several at once, or put one on a repeating schedule.
The step limit in Settings is a safety ceiling against a runaway task (0 = run to completion), not a check-in.
Every finished goal folds what it learned back into Memory, so the next one starts ahead.

🖥️ Skales Code - a coding window of its own

Click Code in the sidebar and Skales opens a separate window built for working on a repository, built for that job rather than for a conversation: a full-width session log instead of bubbles, with every step on its own line - Read, Grep, Edit, Bash, the file or command beside it, and how many lines it added and removed. An edit shows its diff inline, red and green with real line numbers; a command shows its output in a terminal block; the checklist it works through updates in place. Point it at a folder, clone a repo by URL or SSH, and pick how it works: Ask reads and answers without touching anything, Code makes the change, Plan proposes first, Auto runs through. A review panel beside the transcript shows each changed file three ways (preview, diff,