# Tool Specification: mshtools-todo_read

> Task list retrieval tool with no parameters. Returns current todo items with status, priority, and content for session state awareness.

- Skill: `tools-only/tool-specification-mshtools-todo-read` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tools-only/tool-specification-mshtools-todo-read`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/tool-specification-mshtools-todo-read/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-29
- Page: https://skillmd.com/skills/tools-only/tool-specification-mshtools-todo-read

---

# Tool Specification: mshtools-todo_read

## Overview
Task list retrieval tool with no parameters. Returns current todo items with status, priority, and content for session state awareness.

## JSON Schema
```json
{
  "type": "object",
  "properties": {}
}
```

## Streaming Mechanism
- **Storage Location**: `/mnt/kimi/.store/.todo.jsonl`
- **Return Format**:
  ```json
  {
    "todos": [
      {
        "id": "1",
        "content": "Task description",
        "status": "in_progress",
        "priority": "high"
      }
    ]
  }
  ```
- **Empty State**: Returns empty list if no todos exist

## Integration Architecture

### Persistence
- **File**: `/mnt/kimi/.store/.todo.jsonl` (append-only)
- **Scope**: Session-scoped (survives kernel restarts but not new conversations)
- **Size**: ~634 bytes typical

## Usage Patterns

### Check Status
```
todo_read()  # No parameters
# Returns current task list
```

### Workflow Integration
- At conversation start to check pending work
- Before starting new tasks to prioritize
- When user asks about previous tasks
- After completing tasks to update understanding
- Every few messages to ensure on track