shumeiko.it 2edfd01e6e refactor: remove coding-agent hook management (P2.2)
The hooks for Claude Code, Codex and the other agents ran the
hive-mind-hooks-* packages, which left the repository; ADR-0002 hides
the feature in v1. Remove the hook installer surface from the tool
launcher, the POST /api/tools/hooks route, the hook status probe in
tool detection, and the hook fields of the tool manifest and detection
envelope (hookCapable, hookRoot, hookPointer, hooksInstalled,
hookPointerPath). Third-party adapter manifests no longer accept the
hook fields.

In the web UI, remove the hidden hook actions and the "How memory is
shared" explainer from the Launcher, adapter.manageHooks, the
hook-wired count in Mission Control and the agentHooks and memoryMcp
memory feature flags. Launch, watch and stop are unchanged; the
roadmap tool note no longer mentions hooks.
2026-11-01 00:35:13 +01: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
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%