Personal AI agent for macOS, Windows, Linux, Android & iOS. Set a goal, it works alone: coding (Skales Code), desktop + browser automation, autonomous scheduled Tasks. Teams of agents and humans across paired desktops. Agent2Agent, MCP, computer use, voice, local LLMs (Ollama), Agent Skills (SKILL.md). 26 AI providers, BYOK. No Docker, no terminal.
HTML agentic-aiai-agentai-assistantandroidautomationautonomous-agentdesktop-appelectronioslinuxllmlocal-ailocal-firstmacosmcpollamaprivacyreact-nativetypescriptwindows
12.9.0 Fable: changelog, guide and the version badge
Mario Simicd3c7d87f1229
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 72283fb..792667c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,186 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).+## v12.9.0 - Fable++### Added++- **Skales tells you when it healed itself.** If the background engine dies,+ every open window now shows what happened and why while it restarts, and+ confirms when it is back - including windows that never noticed a thing.+- **New installations start on Claude Sonnet 5.** Existing settings are+ untouched - whatever model you chose stays chosen.+- **The setup now ends with fifteen seconds of Skales, not an empty chat.**+ Pressing the last button plays four full-bleed cards: what Studio makes and+ that it can go into the Discover feed, an agent ticking a goal off by+ itself, Iris listening and answering, and the Guide as the door to+ everything else. One press skips it from any card, it is never shown unasked+ a second time, and with reduced motion switched on the cards stand still and+ you press Next. Guide has a "Watch the intro" line to play it again.++- **Two cards that appear where they are an answer.** The first Skales Visual+ you finish offers to put it in the Discover feed, and a run longer than two+ minutes that finishes while you are somewhere else offers to tell you next+ time - the second one only while notifications are actually off. Each is+ offered once, both can be closed without being asked again, and both stay+ quiet while notifications are muted or during quiet hours.++- **A switch for staying awake in the background.** Settings > Desktop App+ now carries "Stay Awake in the Background". On, which is the default and+ what every release so far has done, Skales keeps the system from parking it+ so reminders, scheduled tasks and autonomous work keep running while the+ window is not in front. Off arms that only while a job is actually in+ flight, which is the setting for a laptop on battery. The change takes+ effect immediately, with no restart.++- **Memory can be searched.** The Memory page opens with a search box over+ everything stored - topic names and the text inside them, across the index,+ the topic files and the saved short-term, long-term and episodic records -+ with hits highlighted and a Meaning toggle that appears only when an+ embedding provider is configured. Skales itself gained the same search as a+ tool, so it can find a note it wrote months ago without guessing the topic+ name, and asking for a topic that does not exist now answers with the+ closest ones that do.++- **The first run now asks who you are before it asks for keys.** A new+ question near the top - newcomer or AI-head - reshapes the whole setup:+ newcomers get plain-language explanations under every technical term and a+ guided provider choice, experienced users get dense screens and can skip+ whole blocks. The answer is remembered and keeps shaping recommendations+ after setup.+- **Setup covers the everyday now.** Theme with live previews, light/dark/+ system, accent tone, your city, weather, notifications, a voice you can+ hear before choosing, safety mode and telemetry are all settled during the+ first run - writing the same settings the Settings page writes, so nothing+ exists twice. Feature cards with small live animations introduce AIPointer,+ the desktop buddy, Iris and Studio, and switch them on right there. A QR+ card pairs your phone without leaving setup, including the allow/deny+ confirmation, and the whole run works offline: every card degrades to a+ named fallback and Continue always stays reachable. Progress survives a+ restart and resumes exactly where you stopped.+- **Docs became Guide.** One page with two entrances: "I want to..." paths+ sorted by how much setup they need, and a catalogue of what is actually+ possible - each line showing live whether your machine is ready, with a+ real example prompt that lands editable in the composer. Settings open as+ a popup on top of the page, and the bundled handbook stays available+ offline. Setup ends on a card that shows how much of Skales is already+ set up.+- **Your experience level reaches a connected phone instantly.** Answering+ the newcomer question on the desktop no longer waits for the next+ reconnect - a paired phone learns it the moment you answer.+- **Setup can be replayed without losing anything.** Guide and Settings >+ General offer "run onboarding again": every answer arrives prefilled with+ the current state, and finishing merges only what you changed - identity,+ sessions and history stay untouched.++### Changed++- **An idle window is idle again.** Around sixty background timers kept+ running at full rate on a window nobody was looking at - the dashboard's+ own CPU readout polled twice a second, the Discover network graph redrew+ its physics sixty times a second, Iris kept a WebGL scene painting behind+ whatever was in front of it, and Studio, Flow, Playground, Playbooks,+ Teams, Logs, the Code window and the Autopilot and Organization panels each+ kept their own. Every one of them now pauses while the window is hidden+ **or** unfocused (only checking "hidden" misses a covered window on Windows+ entirely) and refreshes the instant it comes back, so nothing reads stale;+ clocks read their start stamp rather than counting ticks, so they are right+ on the first tick back rather than behind by however long you were away.+ What genuinely has to run while you are away still does - completed runs,+ renders, recordings, calls, the presentation clock, the buddy, OS+ notifications - and pays with a backoff instead: the notification drain+ went from every two seconds to every ten, stretching to thirty while there+ is nothing to deliver. This cannot quietly grow back, and every case that+ genuinely has to keep running while you are away still does.+- **Flat got flatter.** The Flat sidebar is a menu now, not a row of buttons:+ 13px entries, tight rows, no pill on the active item - a soft tint and a+ 2px accent edge carry the position instead. Header, status card, switcher+ and foot bar slimmed down to match. Skales X and Classic are untouched,+ and a test walks every Flat rule to keep it that way.+- **Templates is back in the sidebar.** The templates page never left - only+ its door did. It now sits in the System group right under Custom Widgets,+ and every card still lands its prompt editable in the composer.+- **Three themes instead of six.** Obsidian, Snowfield and Neon are retired;+ anyone using them lands on Classic once, with a short notice. Slate is now+ Flat and means it: grey and white, lime as the only colour, a text-only+ sidebar, tighter lines, emojis in greyscale - the logo and the buddy keep+ their colours. Preset accent tones now also work on Flat.++### Fixed++- **The Autopilot cockpit is current the moment you come back.** Returning to+ the window refreshes status, tasks, logs and goals immediately instead of+ showing up to eight seconds of old state.+- **A renamed chat carries its new name into a second window.** Renaming, and+ the automatic title, now reach every surface instead of only the one you+ were looking at.+- **Background notification delivery cannot lose itself anymore.** A wake+ during a running delivery pass no longer forks the schedule, and a single+ failed server answer no longer silently ends it.+- **The token wall now says that it is one.** Changing the remote-access+ token also locks out the Skales window on a paired phone; that refusal was+ indistinguishable from a working page. It now names itself in the reply,+ and nothing changes for older devices.+- **Studio gallery cards keep the shape their media was made in.** A 9:16+ visual is tall in the gallery, the same way it is tall everywhere else -+ instead of being cropped into a square.+- **Reopened conversations show the team pill again.** A turn that fanned+ out to sub-agents records how many worked on it, so the badge survives a+ restart instead of appearing only while you watched.+- **More of Skales' tools name the capability they belong to.** Skales can+ now say what it has instead of only having it, and reports this completely.+- **A slow image no longer dies at an invisible deadline.** The vision path+ now honours the request-timeout setting and grants extra time by+ attachment size, a transport failure ends the turn with a named card and+ a Retry button instead of a raw exception leaking into the answer, and+ the model is finally told that images arrive through vision - it will+ not try to read a JPEG as text any more.+- **A failed send no longer eats your message.** Attachments return to the+ composer when a run is not accepted, and a run that dies before+ answering says so with a Retry instead of silence.+- **One picture, once.** An attached image rendered up to three times -+ live and as a ghost after reload. One layer now wins, and old sessions+ are repaired on display.+- **Chat titles hold still.** No renaming mid-stream, and an automatic+ title no longer reorders your history.+- **Google Drive and Docs actually work.** Creating a document hit a+ broken API path and always failed; downloading a Google Doc or Sheet+ tried to fetch bytes that do not exist and answered 403. Documents+ create properly now (with optional initial text), Workspace files export+ to a readable format, real binaries arrive undamaged as files, and+ errors name their true cause - including a missing permission.+- **The local speech engine names the right gap.** A build missing its+ platform package claimed "not a missing download" - the diagnosis now+ names both possible build gaps honestly.+- **The connection card no longer says "connected" in red.** Its colour was+ chosen separately from its words, and a keyless runtime like Skales Local+ did not count as connected at all. One tone now derives from the same+ state as the label, using theme tokens instead of hard-coded colours.++- **A shared 3D visual draws in the feed instead of showing a black box.** A+ moving visual shared to Discover used to render on the phone and nowhere else+ - the desktop feed and the moderation view showed an empty frame.+ Both now draw the same visual the phone does, and a simpler design still looks+ exactly as it did before.+- **Sharing a visual no longer cuts it in half.** A large shared visual could be+ silently trimmed, which broke it and left a black frame with nothing saying+ why. A share now sends exactly what was made, and one that is genuinely too+ large is refused clearly, up front, with the reason in the sentence.+- **The setup keeps one face from start to finish.** From the feature cards+ onward the wizard's header swapped the Skales mark for the buddy skin you had+ just picked. The mark is now the same on every screen of the run, and the+ buddy is shown where it is chosen.+- **Setup screens are readable immediately.** The feature previews stopped+ animating when they scrolled out of view, but they stopped on whichever frame+ they were standing on - and several of those frames are deliberately faint,+ which left cards permanently half-drawn. A stopped preview now simply rests.+ The step text also fades in twice as fast and can no longer be caught between+ two overlapping fades.+- **Leaving the provider screen without choosing asks first.** Pressing+ Continue with no card selected walked straight past the one question the+ defaults cannot answer. It now asks, in your language, and says what the+ machine will actually use if you go on. Going on still changes nothing.+## v12.8.5 - Mirror### Fixeddiff --git a/README.md b/README.mdindex b311303..8f4b130 100644--- a/README.md+++ b/README.md@@ -8,7 +8,7 @@ The private AI that lives on your computer and does real work, not just chat.<img width="960" height="580" alt="Dashboard" src="https://github.com/user-attachments/assets/bba3411e-85eb-44e8-ab58-be2a5a88a650" /></p><p>- <a href="https://github.com/skalesapp/skales/releases/latest"><img src="https://img.shields.io/badge/version-12.8.5-10b981?style=flat-square" alt="Version 12.8.5" /></a>+ <a href="https://github.com/skalesapp/skales/releases/latest"><img src="https://img.shields.io/badge/version-12.9.0-10b981?style=flat-square" alt="Version 12.9.0" /></a><a href="https://skales.app"><img src="https://img.shields.io/badge/license-BSL_1.1-10b981?style=flat-square" alt="License" /></a><a href="https://skales.app"><img src="https://img.shields.io/badge/Windows_+_macOS_+_Linux_+_Android_+_iOS-10b981?style=flat-square&logo=windows&logoColor=white" alt="Platform" /></a><a href="https://github.com/skalesapp/skales/stargazers"><img src="https://img.shields.io/github/stars/skalesapp/skales?style=flat-square&color=10b981" alt="Stars" /></a>diff --git a/docs/skales-guide.html b/docs/skales-guide.htmlindex 00dff58..172c597 100644--- a/docs/skales-guide.html+++ b/docs/skales-guide.html@@ -744,7 +744,7 @@<div class="logo-mark">S</div><div><div class="logo-text">Skales</div>- <div class="logo-version">v<span data-skales-version>12.8.5</span> User Guide</div>+ <div class="logo-version">v<span data-skales-version>12.9.0</span> User Guide</div></div></a>@@ -915,7 +915,7 @@<!-- Hero: the front page only --><div class="hero">- <div class="hero-badge">📖 Official Documentation · v<span data-skales-version>12.8.5</span></div>+ <div class="hero-badge">📖 Official Documentation · v<span data-skales-version>12.9.0</span></div><h1>Skales <span>User Guide</span></h1><p>Your personal AI operating system. Set a goal, automate, create, all running locally on your machine.</p></div>@@ -1085,7 +1085,23 @@<section id="onboarding"><h2><span class="icon">🚀</span> First Launch</h2>- <p>The <strong>onboarding wizard</strong> guides you through setup on first launch:</p>+ <p>The <strong>onboarding wizard</strong> guides you through setup on first+ launch. It starts with one question that shapes everything after it -+ whether you are new to AI or already at home with it. Newcomers get every+ technical term explained in place and a guided provider choice;+ experienced users get dense screens and can skip whole blocks.</p>+ <p>The run then settles the everyday in small steps, each with a live+ preview: theme (Skales X, Classic or Flat), light/dark/system, accent+ tone, your city and weather, notifications, a voice you can listen to+ before choosing, safety mode and telemetry. Feature cards introduce+ AIPointer, the desktop buddy, Iris and Studio and switch them on right+ there, and a QR card pairs your phone without leaving setup - the+ allow/deny confirmation appears inside the wizard. The whole run works+ offline, survives a restart exactly where you stopped, and ends on a+ card that shows how much of Skales is already set up. You can replay it+ any time from <strong>Guide</strong> or Settings > General - answers+ arrive prefilled, and finishing changes only what you actually edited.</p>+ <p>The classic steps are still part of the run:</p><ol style="margin: 1rem 0 1rem 1.5rem; color: var(--muted); font-size: 0.875rem;"><li style="margin-bottom: 0.5rem;"><strong style="color:var(--text)">Language</strong> — Choose from 12 supported languages (EN, DE, ES, FR, RU, ZH, JA, KO, PT, VI, HR, TR)</li><li style="margin-bottom: 0.5rem;"><strong style="color:var(--text)">Provider</strong> — Select your AI provider (OpenRouter recommended)</li>@@ -1093,7 +1109,26 @@<li style="margin-bottom: 0.5rem;"><strong style="color:var(--text)">Model</strong> — Pick a default model. You can switch anytime in Settings or via <code>/model</code> in chat.</li><li style="margin-bottom: 0.5rem;"><strong style="color:var(--text)">What Skales should do for you</strong> — Five kinds of work: Generative AI, Audio AI, Coding AI, Business agent, Personal agent. Picking one switches on the add-ons that belong to it, and you can change any individual switch on the same screen. The sidebar and the Settings page are then built from that answer, so you see what you chose and not the rest.</li></ol>- <p>After onboarding you land directly in <strong>Chat</strong> — ready to go.</p>+ <h3>The intro, and the two moments</h3>+ <p>Pressing the last button of the setup does not drop you straight into an+ empty chat. Four short cards play first — what Studio makes and where it can+ go, agents ticking a goal off by themselves, Iris listening and answering,+ and the Guide as the door to everything else. It lasts about fifteen+ seconds, one press skips it from any card, and it is never shown a second+ time by itself. With <em>reduced motion</em> switched on in your system, the+ cards stand still and you press <strong>Next</strong> instead. To watch it+ again, open <strong>Guide</strong> and use <strong>Watch the intro</strong>.</p>+ <p>Two more cards appear once each, and only at the moment they are an+ answer rather than a tour: when your first Skales Visual is finished, Skales+ offers to put it in the Discover feed; and when a run that took longer than+ two minutes finishes while you are somewhere else, it offers to tell you+ next time. Both can be closed without being asked again, both stay quiet+ while notifications are muted or in your quiet hours, and the second one is+ only offered while notifications are actually switched off.</p>+ <p>After onboarding you land directly in <strong>Chat</strong> — ready to go.+ The former <strong>Docs</strong> entry in the sidebar is now+ <strong>Guide</strong>: the same handbook plus "I want to..." paths that+ show live whether your machine is ready for each of them.</p><p>Nothing in that last step is final, and nothing is lost by it. Chat, memory, the planner, tasks, schedule and Discover are always there and are not on the list, because they are not a choice. Everything else is one switch on the <strong>Add-Ons</strong> page, and the <strong>Advanced</strong> view of Settings always shows every setting there is. An existing installation is offered the same screen once, with everything it already had left switched on.</p><h3>Permissions your system may ask for</h3>@@ -1385,6 +1420,9 @@<p>Manage memories in <strong>Settings → Memory</strong>. You can view, edit, or delete individual entries. Up to 5 relevant memories are automatically recalled per conversation.</p>+ <h3>Searching your memory</h3>+ <p>The Memory page opens with a <strong>search box over everything stored</strong> — topic names and the text inside them, across the index, the topic files and the saved short-term, long-term and episodic records, with the matches highlighted. A <strong>Meaning</strong> toggle appears when you have an embedding provider configured, so you can search by what you meant rather than the exact words. Skales itself can search its memory the same way, so it can find a note it wrote months ago without you naming the topic, and asking for a topic that does not exist answers with the closest ones that do.</p>+<h3>Adapts to how you work</h3><p>Over time Skales builds a quiet sense of how you like to work and folds it into memory, and it distills the approaches that carried past goals to a finish into reusable plans. Now and then it surfaces one short question to understand you better, never while it is busy and never often, with a quiet notification and a dot next to Chat so it is not missed. You can set your agent's character outright when you join Discover, and clear everything Skales has picked up about you at any time, from Settings or right in the chat.</p>@@ -1527,6 +1565,7 @@<h2><span class="icon">🤖</span> Agents</h2><p>Create custom AI personas with their own name, personality, system prompt, and model selection. Agents appear in the chat persona picker and each maintain a separate conversation history.</p><p>Built-in personas include: <strong>Default</strong>, <strong>Entrepreneur</strong>, <strong>Coder</strong>, <strong>Family</strong>, and <strong>Student</strong>.</p>+ <p>Skales also ships with ready-made specialist agents you can put on a roster or hand a task to — a code assistant, a writer, a data analyst, a strategic planner, a researcher, a project manager, CEO and CTO seats, and <strong>Fable</strong>, the disciplined builder that takes stock before it builds, works in seams, and finishes what it starts rather than ending on a plan. Every one of them runs on whatever model and provider you have selected; none is tied to a particular vendor.</p><h3>Asking several agents at once</h3><p>The button beside the composer’s mode strip says how many agents your next message goes to. One is off and means what it always meant: the agent picked for this chat answers, alone. Every click counts up to six and back to one.</p>@@ -3202,6 +3241,7 @@<h3>The access token</h3><p>Opening Skales from a browser on another device needs the token, and the URL on the Settings page already carries it: open it once on the other device and it is stored there and survives restarts. There is a QR of the same URL for scanning it onto a phone.</p><p><strong>Regenerate</strong> issues a new token. Every device that connected with the old one has to open the new URL, so treat it as the way to lock out a device you no longer have, together with <strong>Remove and block</strong> on the pairing page.</p>+ <div class="tip"><strong>Changing the token locks out a paired phone until it reconnects.</strong> When you regenerate the token, a phone that was open on the Skales window is locked out until it opens the new URL — and that refusal now says so on the phone, in plain words, instead of looking like a page that simply stopped working. Older devices are unaffected.</div><div class="warn"><strong>The microphone will not work over a plain address.</strong> A browser hands out the microphone only in a secure context, meaning HTTPS or localhost. Over <code>http://100.x.x.x</code> it refuses without saying so, which looks like the page ignoring you. Voice surfaces still draw and still answer typed messages. HTTPS in front of the standalone server is the way to a working microphone from another device, and it is on the roadmap rather than in this release.</div>@@ -3941,32 +3981,12 @@</section><footer>- <span>Skales v<span data-skales-version>12.8.5</span> · © 2024-2026 Mario Simic · BSL 1.1</span>+ <span>Skales v<span data-skales-version>12.9.0</span> · © 2024-2026 Mario Simic · BSL 1.1</span><a href="https://skales.app">skales.app</a></footer></main></div>- <script>- // Live version from skales.app/latest.json; the markup keeps the built-in- // value if the fetch fails, which is also what happens with no network.- (function() {- fetch('https://skales.app/latest.json', { cache: 'no-store' })- .then(function(r) { return r.ok ? r.json() : null; })- .then(function(data) {- if (!data || !data.version) return;- document.querySelectorAll('[data-skales-version]').forEach(function(el) {- el.textContent = data.version;- });- if (data.changelog) {- document.querySelectorAll('[data-skales-changelog]').forEach(function(el) {- el.textContent = data.changelog;- });- }- })- .catch(function() { /* silent, fallback stays */ });- })();- </script><script>// Screenshot slots. A figure starts as "pending" and only loses that class// once its image has actually decoded, so a missing file degrades to a quiet