HHostingByteSoftware
Ctrl K
ComunidadGuías…

llms.txt

Rama main · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
# weave

> weave is an open-source, self-hosted work database for people and AI agents,
> and an alternative to Airtable, Fibery, Notion databases and ClickUp. Connected
> tables, bidirectional relations, workflow states, lookups, rollups, formulas,
> automations, kanban layouts, forms and markdown documents on every row. People
> use the web UI; agents use the built-in MCP server, REST API or CLI on the same
> engine. One SQLite file, zero runtime dependencies, no build step, MIT licensed.

weave runs as a single Node process over a single `.db` file. Everything the web
UI can do is also available over a REST API, a scriptable CLI, and a built-in
Model Context Protocol (MCP) server backed by the same engine. That covers every
configuration choice: field types and their options, colors, icons, column widths
and order, hidden columns, saved views, automations. `weave_vocabulary`
(`GET /api/vocabulary`, `weave vocabulary`) returns every value those settings
accept and what each looks like on screen, so an agent configures a workspace
without a human and without guessing. A local install needs no account and
sends no telemetry; weave cloud at https://weave.grunion.ai runs the same code
behind a sign-in. A hosted instance signs people in through one OpenID Connect provider
and agents through `wv_` tokens; with a provider configured, `/mcp` is an
OAuth 2.1 protected resource, so `claude mcp add --transport http weave https://<host>/mcp`
signs an agent in through the browser. A local install binds loopback.
Authentication is off until an architect runs `weave workspace require-auth`
on a workspace.

Requires Node ≥ 22.16 (Node 24 LTS recommended). Install is `git clone`. There
is nothing to build and nothing to install from npm.

## Docs

- [Agent quickstart: AGENTS.md › Using weave](https://github.com/grunion-ai/weave/blob/main/AGENTS.md#using-weave): read this first to use weave as an agent. The MCP primer, the surfaces and how to start each, every tool by job, plans with turn budgets, and common errors with their fixes
- [README](https://github.com/grunion-ai/weave/blob/main/README.md): what weave is, quickstart, comparison against Airtable/ClickUp/Fibery and other open-source alternatives, self-hosting, FAQ
- [AGENTS.md](https://github.com/grunion-ai/weave/blob/main/AGENTS.md): the whole agent guide: Using weave first, then the reference (the 65 MCP tools (17 listed by default, the rest through `weave_call`; `--tools all` lists every one) and their CLI equivalents, configuring a workspace without a browser, entity-ref forms), then Developing weave (repo layout, rules for changing the repo)
- [Ontology & glossary](https://github.com/grunion-ai/weave/blob/main/docs/ONTOLOGY.md): the entity as weave's one core kind, its five levels, what an entity is made of, and the glossary
- [Architecture map](https://github.com/grunion-ai/weave/tree/main/docs/architecture): interactive runtime map rendered by archify, each node linked to its source at a pinned commit
- [Feature parity matrix](https://github.com/grunion-ai/weave/blob/main/docs/PARITY.md): weave against Fibery's core work-platform feature set, feature by feature
- [weave vs Airtable](https://github.com/grunion-ai/weave/blob/main/docs/comparison/airtable.md): how Airtable concepts map onto weave, and what is missing
- [weave vs Fibery](https://github.com/grunion-ai/weave/blob/main/docs/comparison/fibery.md): the same mapping for Fibery
- [Open-source alternatives compared](https://github.com/grunion-ai/weave/blob/main/docs/comparison/alternatives.md): NocoDB, Baserow, Grist and Teable, side by side with weave, feature by feature
- [CONTRIBUTING](https://github.com/grunion-ai/weave/blob/main/CONTRIBUTING.md): setup, the zero-dependency and no-build-step rules, PR expectations
- [SECURITY](https://github.com/grunion-ai/weave/blob/main/SECURITY.md): the threat model (roles, `wv_` tokens, provider sign-in, the `requireAuth` switch, the request checks), what is in scope, private reporting

## Optional

- [Screenshots](https://github.com/grunion-ai/weave/tree/main/docs/screenshots): table, kanban layout, phone, entity documents, docked entity, relation map, search
- [License](https://github.com/grunion-ai/weave/blob/main/LICENSE): MIT