Repository navigation
v0.1.3, Terax redesign
Muse Agent 0.1.3, Terax redesign
Local-first personal AI agent. Electron shell + Node agent harness + Python hands sidecar. No cloud relay, no telemetry, no account. Your key, your machine.
The Terax update
A ground-up visual and interaction rework, plus two correctness fixes that were breaking real sessions.
Design
- Terax design system: grayscale-inversion primary color, lime green kept as the brand accent only (emblem, pips, hero). Full radius, motion, and surface token scale, oklch syntax palette. Light and dark themes rebuilt on it.
- Ambient WebGL shaders: faithful ports of Paper Designs shaders. NeuroNoise as the animated background behind frosted-glass panes, and a SmokeRing smoke effect on the hero emblem. Zero dependencies, no CSP relaxation, respects
prefers-reduced-motion. - Frosted-glass panes with a live opacity slider in Settings, Appearance. Drag to tune how much of the shader reads through the glass.
- Typography: Inter Variable + JetBrains Mono, bundled as woff2. No more system-serif fallbacks.
- Resizable sidebar: drag the handle (180 to 480px), double-click to reset. Spacious session/project sidebar with clear selection highlights.
Fixes
- Multi-turn 400 error fixed: project memory was spliced into the conversation as a second system-role message. Providers that require system messages only at the start rejected every turn after the first. Memory now rides inside the leading system message behind a stable delimiter.
- Sidecar spawn errors now say what actually failed (ENOENT code, exe tried,
MUSE_PYTHONoverride hint) instead of a generic guess. The py-launcher fallback is supervised correctly.
Also in this cycle
- Image input via OCR (paste/drop, hands sidecar)
- LLM-summarizing context compaction +
/compact - Claude Code-style permission modes (ask / accept_edits / plan / auto)
- Update checks (GitHub Releases, notify-only)
- Sidecar restart-loop fixes, port-conflict dedupe
106/106 tests passing.
Download
Muse Agent Setup 0.1.3.exe: NSIS installer, Windows x64MuseAgent-0.1.3-portable.exe: single file, no install
First run seeds config at %USERPROFILE%\.muse-agent\config.toml.
Note: no code signing (hobby project). SmartScreen will warn. "More info, Run anyway".
Setup
- Run the exe
- Edit
%USERPROFILE%\.muse-agent\config.toml. Presets inside for OpenAI / DeepSeek / OpenRouter / Ollama / LM Studio - Set your key:
set MUSE_LLM_API_KEY=sk-... - Chat. Every
shellcall asks first. Approvals are the security model. Hands (screenshot/mouse/keyboard) is off by default. When on, every action still asks.
Build from source: npm install && npm run dist (Node 18+, Electron 45).
MIT license. It can do anything you approve. Approve carefully.