Skip to content

Lucky v0.1.0-preview

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Guts444 Guts444 released this 12 Jul 22:48
v0.1.0-preview
764e9a6

Lucky v0.1.0-preview

First public preview of Lucky — a local-first WinUI 3 AI agent harness for Windows.

This is an early, build-from-source release. APIs, UI, and packaging will still change before a stable v0.1.0. There is no polished installer yet.

Highlights

  • WinUI 3 shell with project/history rail, streaming chat canvas, Thinking traces, and a rounded composer (model/reasoning, access level, context meter).
  • Local-first state under %LOCALAPPDATA%\Lucky — chats, projects, settings, and memories stay on your machine; API keys and MCP launch config use Windows DPAPI.
  • Providers: DeepSeek, LM Studio, custom OpenAI-compatible endpoints, and optional ChatGPT subscription models via a local app-server helper.
  • Project file tools (Workspace / Full access): list, read, search, write, exact edit, unified-diff patch — path-safe and visible in the Thinking expander.
  • Full access extras: bounded PowerShell at the project root, opt-in Docker code sandbox (no host mounts), trusted-domain page reader, stdio MCP tools.
  • Durable memory with USER profile notes and project/session MEMORY, secret-skipping capture, lexical retrieval, and separate character budgets.
  • Subagents (explorer, reviewer, tester, writer, worker + custom JSON agents) with access caps and compact summaries back to the parent turn.
  • Access levels: Chat only → Workspace → Full access, enforced in the tool loop—not just the prompt.
  • Optional web: user-controlled SearXNG (/web and auto-search) plus opt-in static page reading.

Build from source

dotnet restore Lucky.slnx
dotnet build Lucky.slnx
dotnet test Lucky.slnx
dotnet run --project src\Lucky.App\Lucky.App.csproj -p:Platform=x64

Requirements: Windows 10 1809+, .NET SDK matching the repo, Windows App SDK runtime. Optional: LM Studio, SearXNG, DeepSeek API key, ChatGPT plan + official local coding CLI, Docker Desktop for the sandbox.

Docs

Known limitations

  • Pre-release: expect breaking changes; no Store/MSIX release pipeline yet.
  • MCP is stdio-only for now (no Streamable HTTP / OAuth MCP).
  • Memory retrieval is lexical (not embeddings).
  • Interactive browser automation requires a user-configured MCP server; Lucky’s built-in page reader is static and domain-trusted only.
  • Full-access PowerShell is not an OS sandbox—treat it as running as you.

License

MIT © Guts444

Feedback and issues welcome on GitHub. Please report security issues privately per SECURITY.md — never open issues that include live API keys or chat logs.

Assets 2
Loading