shumeiko.it e9ed8c0765 refactor(server): read workspace state, briefings and workspaces from the memory contract (P1.5)
- Workspace state, the "Workspace Now" block, the home briefing and the
  proactive handlers read the workspace's memory through server.memory:
  decisions are memories of kind 'decision', critical ones or ones worded
  as decisions; summaries list memories most important first. They no
  longer open workspace .mind files, so the builders are async and
  ProactiveContext carries `memory` instead of `getWorkspaceMindDb`.
- The home briefing counts extracted personal facts that are neither
  confirmed nor archived as awaiting review (memory-status.ts).
- Workspace routes count memories through the contract, seed template
  starter memories with remember() in the background (origin
  'workspace-template'), export memories through list(), and deleting a
  workspace forgets its memory scope and clears its awareness items before
  the directory is removed; the delete is refused if forgetting fails.
  agentState.releaseWorkspace() replaces closeWorkspaceMind for callers.
- The command palette searches personal memory and the active workspace's
  memory (UF-033).
- chat.ts drops the MindDB-flake diagnostics; the mind cache they guarded
  no longer serves chat turns.
2026-10-24 13:19:06 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:14:22 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:14:22 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00
2026-09-02 10:10:29 +02:00

Waggle OS Community Edition

Waggle is a local-first AI workspace: an agent with persistent memory, personas, skills, connectors and scheduled automations. It runs as a Node.js sidecar with a React web UI, and can be wrapped in a Tauri desktop shell. You bring your own model: a local model through Ollama or a provider API key.

Status: work in progress. This branch is being converted from the commercial Waggle OS codebase into an open-source community edition. Billing, KVARK, compliance reporting and self-learning are already removed; memory is moving to a local mem0 store, and installers for Windows, macOS and Linux are not ready yet. The rules for this conversion are in AGENTS.md and the decision records in docs/oss/adr/.

Repository layout

waggle-os/
├── apps/web/           # Web UI (React 19, Vite, Tailwind 4)
├── app/                # Tauri 2 desktop shell (Rust); loads the apps/web build
├── packages/           # npm workspaces: agent, server, core, shared, marketplace,
│                       # memory-contract, memory-mem0, cli, launcher, sdk, weaver, ...
└── docs/               # Guides, reference, and docs/oss for the community edition

AGENTS.md lists the status of every package in this edition.

Run from source

Prerequisites: Node.js ^20.19.0 or >=22.12.0, and npm.

npm install
npm run build:packages   # workspace packages export dist/; the sidecar needs it
npm run build            # builds the web UI into dist/
npm run dev:server       # the sidecar on http://localhost:3333, serving the UI

Open http://localhost:3333. Rebuild the UI and restart the sidecar to see UI changes: the Vite dev server (npm run dev:web) cannot authenticate against the sidecar yet (UF-003 in docs/oss/upstream-fixes.md).

Provider keys are entered in the app under Settings → API Keys and stored in the encrypted vault, so a basic local run needs no .env file. .env.example lists the optional variables.

Embeddings. By default EMBEDDING_PROVIDER=auto downloads a small in-process model (about 23 MB, cached under ~/.waggle/models/) and works offline. To use Ollama instead, install Ollama, run ollama pull nomic-embed-text, and set EMBEDDING_PROVIDER=ollama.

Variable Description
ANTHROPIC_API_KEY Claude API key; can be set in the app instead.
OPENAI_API_KEY Enables OpenAI models and optional OpenAI embeddings.
EMBEDDING_PROVIDER auto (default), inprocess, ollama, voyage, openai or mock.
LITELLM_BASE_URL Optional external LiteLLM-compatible proxy.

Checks

npm run build:packages   # build all workspace packages
npm run typecheck:web    # type-check the web UI
npm run lint             # lint the packages
npm run check:deps       # every import is a declared dependency
npm test                 # unit tests

Known failures and the numbers to compare against are in docs/oss/baseline.md.

Documentation

The guides predate the community edition and still describe some removed features; they are rewritten before the first release.

License

This repository is licensed under the MIT License, except the hive-mind-* packages under packages/, which are licensed under Apache-2.0. Each hive-mind-* package carries its own LICENSE file, which governs that package.

Description
No description provided
Readme MIT 302 MiB
Languages
TypeScript 92.4%
JavaScript 3.2%
PowerShell 2.9%
Python 0.5%
Rust 0.4%
Other 0.5%