werk

@werk/loom (0.1.1)

Published 2026-07-26 20:22:06 +02:00 by amelie

Installation

@werk:registry=https://gitlab.amandy.love/api/packages/werk/npm/
npm install @werk/loom@0.1.1
"@werk/loom": "0.1.1"

About this package

loom

Unified Bun workspace monorepo for the Loom, Facet, and Nerve ecosystem.

Structure

  • packages/loom/*: runtime/foundation packages (@loom/*)
  • packages/facet/*: UI framework packages (@facet/*)
  • packages/nerve/*: search/retrieval/memory packages (@nerve/*)
  • apps/*: executable apps and integration shells
  • tools/*: maintenance and migration utilities
  • docs/*: architecture and migration documentation

Run Deck (workbench)

bun install
bun run deck          # http://localhost:10000
bun run deck:dev      # watch mode

Deck lives in apps/deck and consumes workspace packages (@deck/runtime, @facet/*, @loom/* via runtime).

MCP / Agent Integration

@loom/mcp exposes workspace, analysis, Nerve, and Deck runtime tools over MCP stdio (read-only by default).

bun run mcp:start          # MCP server (stdio)
bun run mcp:list           # list tools
bun run mcp:config         # client config snippets (Cursor, Gemini, generic)
bun run skills:sync --package @loom/mcp

See packages/loom/mcp/README.md for safety flags and tool reference.

Dependency Policy

This ecosystem strictly enforces dependency minimalism to ensure stability, fast cold starts, and easy migration:

  • Prefer zero external runtime dependencies.
  • Prefer Bun/Node built-ins whenever possible.
  • Prefer workspace packages over external alternatives.
  • External dependencies require explicit justification.
  • Live AI/Network requests are never part of default tests.
  • Generated tooling or agents must not casually add packages.

Migration notes

This repository is an incremental structural migration. Source systems were moved with minimal rewriting to preserve behavior, tests, and existing project identity.

The ecosystem now integrates core concepts from the legacy Fox-Issue project, providing file-centric guidance and enhanced issue lifecycle management for AI-driven development.

Dependencies

Dependencies

ID Version
blessed ^0.1.81

Development Dependencies

ID Version
@types/node latest
bun-types latest
typescript ^6.0.3
Details
npm
2026-07-26 20:22:06 +02:00
1
947 KiB
Assets (1)
loom-0.1.1.tgz 947 KiB
Versions (4) View all
0.1.3 2026-07-26
0.1.2 2026-07-26
0.1.1 2026-07-26
0.1.0 2026-07-26