create_task_fileLABSCO SUMMARY
A task list that lives in your repository.
Because a project is a markdown file rather than a row in someone else's database, the plan diffs, reviews and travels with the code it belongs to.
What it is
A task manager whose storage is plain markdown, one file per project. Tasks carry status, priority, category and complexity, support subtasks up to three levels deep, and stay readable in version control.
What you get
- A project created as its own markdown task file
- Tasks added with category, priority and dependencies on other tasks
- The projects you have, listed back
- Status tracked across todo, in progress, done and blocked
- Complex tasks broken into subtasks, recursively up to three levels
Requirements
Go 1.21 or later to build it. Tasks are written to a directory you choose — ./tasks unless the environment says otherwise — and it speaks stdio by default, or SSE if you set TRANSPORT.
Setup effort
Build from source — clone the repository and build it, then follow the project's own run instructions
USE CASES
Starting a plan for a new piece of work
Create the project's file, then add the tasks with their priorities and dependencies as you talk the work through.
Breaking a task that is too big to start
A complex item becomes subtasks under it, up to three levels down, so the first step is small enough to actually begin.
Seeing what is on across projects
List the projects and open the file behind any of them — the same file a person can read or edit by hand.
5 tools
Listed in project docs. Your client may show a different list.
list_projectsadd_taskupdate_task_statusget_next_taskBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
- go on PATH
- Go 1.21+
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
go build -o task-manager-go main.goMCP Clients
Claude Desktop — binary
{
"mcpServers": {
"task-manager-go": {
"command": "<YOUR_PATH_TO_TASK_MANAGER_GO>",
"env": {
"TRANSPORT": "stdio",
"TASKS_DIR": "tasks"
}
}
}
}Claude Desktop — go run
{
"mcpServers": {
"task-manager-go": {
"command": "go",
"args": [
"run",
"main.go"
],
"cwd": "<YOUR_PATH_TO_MCP_TASK_MANAGER_GO>",
"env": {
"TRANSPORT": "stdio"
}
}
}
}Any MCP client — SSE
{
"mcpServers": {
"task-manager-go": {
"type": "sse",
"url": "http://localhost:8050/sse"
}
}
}