mentat-tasks

Manage local markdown task stores with POSIX atomic claims and TTL refresh.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/matheushenriquefs/mentat --skill mentat-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mentat-tasks
Source: https://github.com/matheushenriquefs/mentat/tree/main/.agents/skills/mentat-tasks
Command: npx skills add https://github.com/matheushenriquefs/mentat --skill mentat-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a local markdown task store with atomic claim and TTL refresh, eliminating the need for servers, databases, or binaries. It simplifies task management with atomic claim, TTL refresh, and HITL/AFK doctrine.

Core Features & Use Cases

  • Local Markdown Task Store: Backed by POSIX atomics, each task is a file, each claim is a lock sentinel.
  • Atomic Claim and TTL Refresh: Ensure exclusive task access with atomic lock and manage claim duration with TTL.
  • HITL/AFK Doctrine: Classify tasks as HITL or AFK for better organization and workflow.
  • Use Case: Ideal for managing tasks in parallel worktrees and devcontainers with isolated tooling.

Quick Start

Use the mentat-tasks create command to create a new task and add it to the task store.

Frequently Asked Questions about mentat-tasks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage parallel worktree tasks without a database?

You can manage parallel worktree tasks without a database by using a local markdown task store. This approach uses files for task definitions and POSIX atomics for locking, eliminating the need for external servers or binaries.

What is atomic claim and TTL refresh in local task management?

Atomic claim and TTL refresh in local task management ensure exclusive access to tasks using lock sentinels. POSIX atomics handle the locking, while time-to-live refresh manages the duration of the claim for isolated tooling.

How do I create a task in a local markdown task store?

To create a task in a local markdown task store, use the `mentat-tasks create` command. This generates a new markdown file defining the task and registers it in the store for atomic claiming.

Can I use local markdown files for HITL and AFK task classification?

Yes, local markdown files support HITL and AFK task classification. This workflow doctrine organizes tasks requiring human-in-the-loop intervention separately from away-from-keyboard automated tasks.

Does POSIX atomic locking work in devcontainers for parallel task management?

POSIX atomic locking works in devcontainers for parallel task management. It uses lock sentinels on markdown files to guarantee exclusive task access across isolated tooling environments.

What are the limitations of a file-based markdown task store?

A file-based markdown task store requires local markdown files for task definition and relies on POSIX atomics. It is designed for local devcontainer and worktree workflows rather than distributed server environments.