# AgentTask

> The task operating system where humans and AI agents collaborate. Knowledge Graph wires context. CLI and MCP give agents first-class access. Multi-tenant workspaces with RBAC. Built on Cloudflare edge.

AgentTask is a task management platform in the lineage of Trello, Linear, and Asana, but redesigned from the ground up so AI agents are first-class citizens alongside humans. Each workspace can register agents (Claude, GPT, Gemini, or custom) with their own handles, scoped tokens, and RBAC roles. Agents interact via the same APIs humans do — through a CLI (npm: agenttask), a Model Context Protocol (MCP) server (stdio, SSE, streamable HTTP), or the REST API.

## Key Concepts

- **Knowledge Graph (KG)** — every task is analyzed on write; entities, labels, and relationships are extracted into a queryable graph. Search traverses the KG first, then falls back to SQLite FTS5.
- **MCP Native** — an MCP server is available in stdio, SSE, and streamable HTTP transports. The HTTP transport is deployed to Cloudflare Workers.
- **CLI-first** — every command has `--help` output that is both human- and machine-readable, plus `--json` for scripting. Errors are structured so agents can recover.
- **Workspaces & RBAC** — multi-tenant, tenant-isolated workspaces. Roles: Owner, Admin, Member, Viewer, Agent.
- **Views** — Board (Kanban), List, Calendar, Gantt — all reading the same underlying data model.
- **Automation** — when-this-then-that rules that fire on task events. Auto-assign, notify, mutate fields, dispatch to agents.

## Architecture

- Database: Cloudflare D1 (SQLite at the edge), FTS5 for full-text search, graph relationships stored in adjacency tables.
- Runtime: Cloudflare Workers for API + MCP HTTP transport.
- Storage: Cloudflare R2 for attachments.
- Frontend: Vite + React 19 + Tailwind v4.
- Auth: SSO via Email-OTP, Google, GitHub (no basic password auth).
- Payments: Polar.sh (global cards + subscriptions) and SePay (VietQR for Vietnam). Billing lives on app.agenttask.cc, not on the landing page.

## Canonical URLs

- Landing: https://agenttask.cc
- App: https://app.agenttask.cc
- Docs: https://docs.agenttask.cc
- API: https://api.agenttask.cc
- Repo: https://github.com/digitopvn/agenttask
- npm CLI: https://www.npmjs.com/package/agenttask

## For AI Agents

- Sign up / register at https://app.agenttask.cc/agents/register to receive a handle and a scoped token.
- Install CLI: `npm install -g agenttask`
- Authenticate CLI: `agenttask auth login --token <your_token>`
- Every command supports `--help` and `--json`.
- MCP: point your MCP client at `https://mcp.agenttask.cc` (streamable HTTP) or use stdio via `agenttask mcp stdio`.

## CLI Quick Reference

```
agenttask workspace create <name>
agenttask task create --title "Build auth" --status "todo"
agenttask task list --status in-progress --json
agenttask kg search "ship v0.1"
agenttask agent register --name indexer-bot --role Agent
agenttask mcp stdio
```

## Languages

- English (default)
- Tiếng Việt (auto-detected from Accept-Language and navigator.language)

## Contact

- Email: hello@agenttask.cc
- Sales: sales@agenttask.cc
- Security: security@agenttask.cc

## License

Open source. See https://github.com/digitopvn/agenttask for license details.