Developer tools, documentation, and examples for building with Skales — the local-first AI desktop agent.
- API Reference — Full REST API for chat, tools, memory, sessions, and scheduling
- Agent Skills — Create and share SKILL.md files compatible with Claude Code, Codex, Copilot, and Cursor
- MCP Servers — Model Context Protocol setup and templates
- Provider Guides — Setup for 11+ AI providers (Ollama, LM Studio, OpenRouter, OpenAI, Anthropic, Google, and more)
- Integration Docs — Notion, Todoist, Spotify, GitHub, Google Drive, Home Assistant, Telegram, Discord, and more
- Migration Guide — Import from ChatGPT, Claude, Copilot, Gemini, Hermes, OpenClaw
- Example Skills — Ready-to-use SKILL.md templates
- Architecture Overview — How Skales works under the hood
- Download Skales
- Create a
devkit/folder in your Skales data directory (see below) - Restart Skales — under Settings → Skills, a DevKit toggle appears
- Enable it. The Developer section appears in the sidebar.
See the Getting Started Guide for detailed setup.
Create a devkit/ folder in your Skales data directory:
| Platform | Path |
|---|---|
| macOS / Linux | ~/.skales-data/devkit/ |
| Windows | %APPDATA%/skales/devkit/ |
Add a devkit.json configuration file:
{
"enabled": true,
"version": "0.1.0",
"api": {
"enabled": true,
"token": "your-secret-token"
},
"cli": {
"enabled": true
}
}Restart Skales. The Developer section appears in the sidebar.
The DevKit includes a standalone CLI for interacting with Skales from your terminal. Requires Node.js 18+ and zero npm dependencies.
cd cli/
node skales.js chat # Interactive chat
node skales.js chat "Hello" # One-shot message
node skales.js tools # List available tools
node skales.js model # Show current model
node skales.js status # System status
node skales.js memory # Browse memories
node skales.js sessions # List chat sessions
node skales.js migrate --from hermes # Import from HermesSkales supports the open SKILL.md format. Skills are portable text files that teach the AI agent how to perform specific tasks.
my-skill/
└── SKILL.md
---
name: My Custom Skill
description: What this skill does
version: 1.0.0
---
# Instructions
Your skill instructions here. The AI agent follows
these when the skill is active.Import in Skales: Settings → Agent Skills → Import → paste a GitHub URL or local folder path.
| Guide | Description |
|---|---|
| Getting Started | Enable DevKit and first steps |
| API Reference | REST API with curl examples |
| Agent Skills | Create, import, and share skills |
| MCP Servers | External tool integration |
| Providers | AI provider setup |
| Integrations | Third-party service setup |
| Migration | Import from other tools |
| Architecture | How Skales works internally |
BSL-1.1 (Business Source License) — Free for personal and educational use. See LICENSE for details.
Built by Mario Simic, Vienna.