# NexTask

> NexTask is an ultra-fast, high-velocity task management workspace and agile execution engine engineered for developer autonomy and autonomous AI agents. Built with a sub-20ms optimistic UI mutation engine, mechanical haptic audio feedback, local-first Progressive Web App (PWA) offline architecture, 1-click Trello migration, and a native Model Context Protocol (MCP) server for AI assistants (Cursor, Claude Desktop, Google Antigravity).

## Executive Summary
NexTask is designed from the ground up for high-velocity software engineering teams and AI coding agents. Unlike traditional project trackers burdened by complex permission hierarchies, slow spinners, and bloated UIs, NexTask treats speed, keyboard ergonomics, and direct AI agent integration as core features. All state changes render instantly (<20ms optimistic latency) and synchronize in the background using vector clocks and LibSQL/Turso.

## Core Capabilities & Benchmarks
- **Sub-20ms Optimistic UI**: Zero-latency UI updates with mechanical haptic audio feedback and automatic background synchronization.
- **Native MCP Server (26 Tools)**: Complete Model Context Protocol server (`npx nextask mcp start`) providing autonomous AI agents direct access to manage issues, sprints, dependencies, comments, and audit trails.
- **1-Click Trello Migration**: Frictionless board importer with auto-discovery, mapping boards, lists, cards, checklists, members, and labels into sprint issues.
- **Automated Agile Sprints & Cycles**: Bi-weekly sprint automation with burn-down velocity tracking, story points, and rollover for incomplete tasks.
- **Local-First PWA**: Offline-first mutation queue with FIFO replay, client-to-server ID remapping (`tempIdMap`), and service worker caching.
- **Keyboard-First Ergonomics**: Command menu (<kbd>Cmd</kbd>+<kbd>K</kbd>), single-key triage (<kbd>C</kbd> create, <kbd>X</kbd> select, <kbd>S</kbd> status, <kbd>P</kbd> priority, <kbd>A</kbd> assign, <kbd>D</kbd> due date), and 60 FPS list virtualization.
- **Enterprise Multi-Tenancy**: Scoped Personal API Keys (`NEXTASK_API_KEY`) restricting AI agents strictly to specific workspaces and projects with SHA-256 constant-time hashing.

## Quickstart for AI Coding Agents
AI assistants (Claude Desktop, Cursor, Google Antigravity) can connect directly to NexTask via Stdio transport using:
```bash
npx nextask mcp start
```
Or in `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "nextask": {
      "command": "npx",
      "args": ["-y", "tsx", "/path/to/nextask/mcp/server.ts"],
      "env": {
        "NEXTASK_API_KEY": "nt_live_your_scoped_api_key"
      }
    }
  }
}
```

## Essential Documentation Links
- [Documentation Hub](https://nextask.fauzanlm.my.id/docs): Complete developer portal, guides, architecture, and API documentation.
- [Engineering Blog & Guides](https://nextask.fauzanlm.my.id/blog): High-velocity engineering articles, sub-20ms architecture breakdowns, and AI agent workflows.
- [Model Context Protocol (MCP) Guide](https://nextask.fauzanlm.my.id/docs/developer/ai-mcp-server): Detailed setup guide for Claude Desktop, Antigravity, and Cursor with all 26 MCP tools.
- [REST API Reference](https://nextask.fauzanlm.my.id/docs/developer/rest-api-reference): OpenAPI endpoints for issues, cycles, projects, webhooks, and team management.
- [Trello Migration Guide](https://nextask.fauzanlm.my.id/docs/workspaces/trello-migration): Step-by-step guide to importing Trello boards and checklists into NexTask.
- [Keyboard Shortcuts Reference](https://nextask.fauzanlm.my.id/docs/getting-started/shortcuts): Comprehensive shortcut key reference for keyboard-first task triage.
- [Offline-First PWA Architecture](https://nextask.fauzanlm.my.id/docs/getting-started/offline-pwa): Details on offline queue replay, vector clocks, and ID remapping.
- [Real-User Monitoring (RUM) & Performance Telemetry](https://nextask.fauzanlm.my.id/docs/developer/performance-telemetry): Sub-16ms telemetry engine and developer HUD (<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>P</kbd>).

## Agent Tools & Web Endpoints
- [NexTask Web Application](https://nextask.fauzanlm.my.id/): Main client interface and workspace application.
- [Interactive Demo Mode](https://nextask.fauzanlm.my.id/demo): Live interactive client workspace without signup requirement.
- [MCP Server Endpoint](https://nextask.fauzanlm.my.id/api/mcp): Model Context Protocol server over HTTP JSON-RPC.
- [Agentic Resource Discovery (ARD)](https://nextask.fauzanlm.my.id/.well-known/ard.json): Standardized agent discovery manifest.
- [Full LLM Knowledge Base (llms-full.txt)](https://nextask.fauzanlm.my.id/llms-full.txt): Complete uncompressed product, API, and architectural documentation for deep LLM retrieval.
- [Sitemap Index](https://nextask.fauzanlm.my.id/sitemap.xml): Full XML sitemap covering all 35 public pages and technical articles.