tasknexus

TaskNexus

The High-Bandwidth Collaborative Synapse for AI-Developer Pairs

[!WARNING] Beta Release: TaskNexus is under active development. Development Tooling: This is strictly a development-time tool. It is designed to automatically not render in production environments to ensure zero overhead.

🚀 The Core Vision

TaskNexus is more than just a task manager; it's a contextual bridge. In the age of AI-assisted coding, the gap between "what needs to be done" and "how it was implemented" can grow exponentially.

TaskNexus bridges this gap by providing a persistent, AI-accessible layer of intent that sits directly atop your live application during development. It transforms ephemeral chat history into structured project state.

✨ Key Features

• 🖱️ Dual Display Architecture: Switch between a floating draggable widget for immediate capture and a full-page Standalone Dashboard for deep planning.
• 📍 Intelligent Context Capture: Automatically tracks URLs, timestamps, and contextual metadata. Screenshots can be attached directly to tasks for visual debugging.
• ⚡ Model Context Protocol (MCP): Built-in MCP server allows AI agents (like Claude) to read from and write to your project's task nexus with full awareness of your workspace.
• 🎨 Premium Visual Engine: Hand-crafted Light, Dark, and Midnight themes with a sophisticated token-based color system.
• ⌨️ Quick-Access Flow: Configurable global hotkeys (Alt+T default) to toggle the nexus without breaking your flow.
• 🤝 Collaborative Loop: AI-friendly JSON storage enables "staged" updates—AI suggests changes, and you approve the final state.

🛠️ Getting Started

Installation

npm install tasknexus -D

Note: If your project doesn't use Vite (e.g., standard Next.js or Angular), you'll need to install vite as a dev dependency to power the standalone dashboard.

npm install vite -D

Integration

Wrap your app or specific routes with the TaskNexus component. It's designed to be transparent.

import { TaskNexus } from 'tasknexus';

const App = () => {
    return (
        <BrowserRouter>
            {/* Your Application Logic */}
            <TaskNexus config={{
                theme: 'midnight',
                categories: ['Frontend', 'Backend', 'Refactor'],
                position: 'bottom-right'
            }} />
        </BrowserRouter>
    );
};

🖥️ Usage Modes

TaskNexus adapts to your current working style.

🪟 The Widget

Stay in the zone. Capture bugs as they happen, note down refactor ideas, and see what the AI has planned next without leaving your app's UI.

📊 The Standalone Dashboard

For heavy-duty project management. Drag-and-drop task prioritization, bulk archiving, and deep-linking support for sharing specific tasks.

To launch standalone mode:

VITE_STANDALONE=true npm run dev

🤖 AI Superpowers (MCP Server)

Empower your AI agents to be productive members of your team. By exposing TaskNexus via the Model Context Protocol, your agent can:

• Discover: Find where tasks are stored and what specialists are available.
• Plan: Create complex multi-step choreographies for large features.
• Refine: Update task statuses as code is written and tests are passed.

Configuration for Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "tasknexus": {
      "command": "npm",
      "args": ["run", "mcp", "--", "/path/to/your/project"]
    }
  }
}

⚙️ Configuration

Option	Type	Default	Description
theme	'dark' | 'light' | 'midnight'	'dark'	Visual aesthetic style.
categories	CategoryConfig[]	['General']	Custom groupings with specific path mapping.
shortcut	string	'Alt+T'	Hotkey to toggle the widget.
position	string	'bottom-right'	Starting anchor for the widget.
taxonomies	TaxonomyDefinition[]	[]	Advanced custom metadata fields for tasks.

🧱 Project Architecture

• src/TaskNexusWidget.tsx - Floating interface & modal logic.
• src/StandalonePage.tsx - High-density management board.
• src/TaskNexusCore.tsx - Shared state and UI primitives.
• src/mcp/ - Native Model Context Protocol implementation.
• src/types.ts - Centralized contract for project state.

Built with ❤️ by Stratnexus.