# thask

Maps project dependencies into a graph so Claude Code and Cursor can inspect what breaks before editing code.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: kimgh06
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kimgh06/Thask
- Updated: 2026-07-05
- HTML: https://affpapa.org/en/nevibecode/mcp/thask

## What it does

Coding assistants often edit an isolated file without checking downstream components. Thask runs a graph of nodes for tasks, bugs, UI, and APIs. Connected via MCP, agents explore edges such as dependencies or triggers before modifying code.

The server exposes 25 MCP tools. To stop hallucinated edits from corrupting your notes, agent keys block direct writes to semantic descriptions. Modifications land in a suggestion queue for human review. Every record logs six provenance dimensions, including the agent model and trigger evidence.

Thask runs self-hosted via Docker. Without an active instance URL and a valid `THASK_TOKEN`, the MCP client fails to connect.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `THASK_URL`, `THASK_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add thask -e THASK_URL=<THASK_URL> -e THASK_TOKEN=<THASK_TOKEN> -- npx -y @thask-org/cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add thask --env THASK_URL=<THASK_URL> --env THASK_TOKEN=<THASK_TOKEN> -- npx -y @thask-org/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "thask": {
            "command": "npx",
            "args": [
                "-y",
                "@thask-org/cli"
            ],
            "env": {
                "THASK_URL": "<THASK_URL>",
                "THASK_TOKEN": "<THASK_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "thask": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@thask-org/cli"
            ],
            "env": {
                "THASK_URL": "<THASK_URL>",
                "THASK_TOKEN": "<THASK_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e THASK_URL=<THASK_URL> -e THASK_TOKEN=<THASK_TOKEN> thask npx -y @thask-org/cli
```
Replace <…> with your own values

## When to use it
- trace downstream impacts before refactoring shared functions
- expose architecture dependencies and requirements to coding agents
- prevent automated hallucinated overwrites on project memory
- audit change history with six-dimension provenance tracking

## Example prompts
- Query Thask to see which downstream endpoints depend on `handleCheckout`
- Check the dependency graph for affected flows before refactoring this service
- Submit an update to the user flow description via the Thask suggestion queue

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md