{"id":47120098,"url":"https://github.com/dligthart/wordclaw","last_synced_at":"2026-04-05T15:00:56.653Z","repository":{"id":339549399,"uuid":"1160052067","full_name":"dligthart/wordclaw","owner":"dligthart","description":"AI-native headless CMS - manage content through REST, GraphQL, or Model Context Protocol. Built for agents and humans alike, with versioning, dry-run mode, webhooks, and Lightning micropayments.","archived":false,"fork":false,"pushed_at":"2026-04-02T19:15:41.000Z","size":9020,"stargazers_count":1,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T06:46:27.905Z","etag":null,"topics":["ai-agents","graphql","headless-cms","l402","rest-api"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dligthart.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-17T13:40:43.000Z","updated_at":"2026-04-02T19:15:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dligthart/wordclaw","commit_stats":null,"previous_names":["dligthart/wordclaw"],"tags_count":66,"template":false,"template_full_name":null,"purl":"pkg:github/dligthart/wordclaw","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dligthart%2Fwordclaw","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dligthart%2Fwordclaw/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dligthart%2Fwordclaw/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dligthart%2Fwordclaw/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dligthart","download_url":"https://codeload.github.com/dligthart/wordclaw/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dligthart%2Fwordclaw/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31439442,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T13:13:19.330Z","status":"ssl_error","status_checked_at":"2026-04-05T13:13:17.778Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","graphql","headless-cms","l402","rest-api"],"created_at":"2026-03-12T19:17:38.642Z","updated_at":"2026-04-05T15:00:56.627Z","avatar_url":"https://github.com/dligthart.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WordClaw\n\n\u003cp align=\"center\"\u003e\n    \u003cpicture\u003e\n        \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/dligthart/wordclaw/main/doc/images/logos/wordclaw.png\"\u003e\n        \u003cimg src=\"https://raw.githubusercontent.com/dligthart/wordclaw/main/doc/images/logos/wordclaw.png\" alt=\"WordClaw Logo\" width=\"300\"\u003e\n    \u003c/picture\u003e\n\u003c/p\u003e\n\n[![Node.js CI](https://github.com/dligthart/wordclaw/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/dligthart/wordclaw/actions/workflows/test.yml)\n[![Coverage CI](https://img.shields.io/github/actions/workflow/status/dligthart/wordclaw/test.yml?branch=main\u0026label=coverage%20ci)](https://github.com/dligthart/wordclaw/actions/workflows/test.yml)\n\nWordClaw is a safe content runtime for AI agents and human supervisors.\n\nIt combines structured content contracts, review-aware workflows, dry-run safety, auditability, paid-content flows, and agent-native REST/MCP access so autonomous systems can work with content without losing governance.\n\nFor active product direction, see the [roadmap](doc/reference/roadmap.md) and [RFC index](doc/rfc/index.md).\n\n## What It Includes\n\n- Structured content with JSON Schema validation, globals, localization, versioning, rollback, and published-vs-working-copy reads.\n- Governance primitives such as workflows, dry-run mutation paths, audit logs, idempotency, and tenant isolation.\n- Schema-aware assets, reusable forms, background jobs, preview tokens, and reverse-reference inspection.\n- REST-first and MCP-first agent surfaces, plus a supervisor UI for oversight.\n- Optional semantic search via pgvector and embeddings when `OPENAI_API_KEY` is configured.\n\nFor the fuller capability breakdown, see [Features](doc/concepts/features.md).\n\n## Quick Start\n\n```bash\ngit clone https://github.com/dligthart/wordclaw.git\ncd wordclaw\nnpm install\ncp .env.example .env\ndocker compose up -d\nnpm run db:migrate\nnpm run dev:all\n```\n\nThat gives you:\n\n- API: `http://localhost:4000/api`\n- Swagger/OpenAPI docs: `http://localhost:4000/documentation`\n- MCP endpoint: `http://localhost:4000/mcp`\n- Supervisor UI (dev): `http://localhost:5173/ui/`\n\nVerify the runtime:\n\n```bash\ncurl http://localhost:4000/health\ncurl http://localhost:4000/api/deployment-status\nnpx tsx src/cli/index.ts capabilities status\n```\n\nIf `deployment-status` reports `domainCount: 0`, bootstrap the first domain before creating content types or content items. Prefer the dedicated CLI path locally:\n\n```bash\nnpx tsx src/cli/index.ts domains create \\\n  --name \"Local Development\" \\\n  --hostname local.development\n```\n\nEquivalent bootstrap paths are MCP `create_domain` and REST `POST /api/domains`. `AUTH_REQUIRED=false` only opens public discovery; write-capable routes still need a credential unless `ALLOW_INSECURE_LOCAL_ADMIN=true` is active in a non-production environment.\n\nThe step-by-step version lives in [Getting Started](doc/tutorials/getting-started.md).\n\n## First Commands\n\n```bash\nnpx tsx src/cli/index.ts capabilities status\nnpx tsx src/cli/index.ts mcp call guide_task --json '{\"taskId\":\"discover-deployment\"}'\nnpx tsx src/cli/index.ts domains list\nnpx tsx src/cli/index.ts mcp inspect --mcp-transport http --api-key writer\nnpx tsx src/cli/index.ts workspace guide\nnpx tsx src/cli/index.ts content guide\nnpx tsx src/cli/index.ts content guide --content-type-id 1\n```\n\nUse `content guide` without `--content-type-id` when you need to bootstrap a new schema first. It now returns starter guidance for agent memory, task-log, and checkpoint-style content models.\n\nLive verification helpers now live under `scripts/verification/` and are exposed as `npm run verify:*` commands.\n\n## Documentation\n\n### Start Here\n\n- [Getting Started](doc/tutorials/getting-started.md)\n- [Runtime Configuration](doc/reference/runtime-configuration.md)\n- [Docker Deployment](doc/guides/docker-deployment.md)\n\n### Agent and Operator Surfaces\n\n- [CLI Guide](doc/guides/cli-guide.md)\n- [Claude/OpenClaw Memory + RAG](doc/guides/claude-openclaw-memory-rag.md)\n- [MCP Integration](doc/guides/mcp-integration.md)\n- [API Reference](doc/reference/api-reference.md)\n- [LangGraph MCP Starter](doc/guides/langgraph-mcp-starter.md)\n\n### Product and Architecture\n\n- [Features](doc/concepts/features.md)\n- [Roadmap](doc/reference/roadmap.md)\n- [Architecture](doc/reference/architecture.md)\n- [Data Model](doc/reference/data-model.md)\n- [Native Vector RAG Guide](doc/guides/native-vector-rag.md)\n\n### Examples and History\n\n- [Demos](doc/guides/demos.md)\n- [RFC Index](doc/rfc/index.md)\n\n## Contributing\n\n1. Fork the repository.\n2. For major features or architecture changes, start with an RFC in `doc/rfc/`.\n3. Create a feature branch.\n4. Commit your changes.\n5. Open a pull request.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdligthart%2Fwordclaw","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdligthart%2Fwordclaw","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdligthart%2Fwordclaw/lists"}