Summary

Weft is a self-hosted, AI-powered task management system designed for personal use and developers. It allows users to create tasks that AI agents execute, integrating with services like Gmail, Google Docs, Sheets, and GitHub. The primary benefit is automating routine tasks while maintaining data privacy and control through deployment on Cloudflare's Developer Platform.

How It Works

Weft leverages Cloudflare's serverless architecture, comprising Workers for HTTP routing and frontend serving, Durable Objects for persistent state and real-time updates via WebSockets, and Workflows for orchestrating AI agent execution. Agents interact with integrated tools, with critical state-mutating actions (e.g., sending emails, creating PRs) requiring explicit user approval before commitment. This design ensures a private, scalable, and resilient execution environment.

Quick Start & Requirements

• Prerequisites: Node.js 18+, Docker (for Cloudflare Sandboxes), a Cloudflare account with a paid plan (for Durable Objects/Workflows), and OAuth credentials for desired integrations (Google, GitHub).
• Local Setup: Clone the repository, run npm install, copy .env.example to .env, and configure ENCRYPTION_KEY and OAuth secrets. Run locally with npm run dev.
• Deployment: Deploy to Cloudflare using wrangler CLI, setting secrets via npx wrangler secret put. Authentication can be configured via AUTH_MODE in wrangler.jsonc, supporting direct use or Cloudflare Access for multi-user scenarios.
• Documentation: Setup instructions are detailed within the README.

Highlighted Details

• Integrations: Built-in support for Gmail (read, draft, send), Google Docs (create, edit), Google Sheets (create, update), and GitHub (issues, PRs, code).
• Execution Environments: Utilizes Cloudflare Sandbox for isolated code execution and supports integration with remote MCP servers for custom tools.
• Agent Workflow: Features an agent loop with automatic checkpointing and retry mechanisms.
• User Control: All actions that mutate state require explicit user approval before execution.
• AI Backend: Requires an Anthropic API key for agent functionality, configured per board.

Maintenance & Community

The provided README does not contain specific details regarding notable contributors, community channels (e.g., Discord, Slack), public roadmaps, sponsorships, or partnerships.

Licensing & Compatibility

Weft is licensed under the Apache License 2.0. This license is generally permissive and allows for commercial use and integration into closed-source projects, with standard attribution and license inclusion requirements.

Limitations & Caveats

Deployment necessitates a paid Cloudflare plan. Setting up OAuth credentials for Google and GitHub integrations can be a complex multi-step process. The system's core functionality relies on the availability and configuration of an Anthropic API key.