# Memory Tasks

Task management via Basic Memory schemas: create, track, and resume structured tasks...

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Writing
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill memory-tasks -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill memory-tasks -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill memory-tasks -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill memory-tasks -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

Task management via Basic Memory schemas: create, track, and resume structured tasks that survive context compaction. Uses BM's schema system for uniform notes queryable through the knowledge graph.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Memory Tasks

Manage work-in-progress using Basic Memory's schema system. Tasks are just notes with `type: Task`, they live in the knowledge graph, validate against a schema, and survive context compaction.

## Project scope

If the project is unknown, discover it with `bm_project(command="list")`.
Pass a nonempty `project` on every note, folder, context and schema call, even
with one project or a qualified `memory://` URL. Use the chosen project's name,
`workspace/project`, or external ID; `<project>` below is a placeholder for it.
Recent activity also requires `project`. Search accepts `project` for one
project, `projects` for selected projects, or `all_projects=True` explicitly.
Discovery and bundled manuals need no project. Keep the same scope when following
returned paths, paginating, or recovering from a refusal.

## When to Use

- **Starting multi-step work** (3+ steps, or anything that might outlast the context window)
- **After compaction/restart**, search for active tasks to resume
- **Pre-compaction flush**, update all active tasks with current state
- **On demand**, user asks to create, check, or manage tasks

## Task Schema

Tasks use the BM schema system. The schema note lives at `schema/Task.md`:

```yaml
---
title: Task
type: schema
entity: Task
version: 1
schema:
  description: string, what needs to be done
  status?(enum, current state): [active, blocked, done, abandoned]
  assigned_to?: string, who is working on this
  steps?(array): string, ordered steps to complete
  current_step?: integer, which step number we're on (1-indexed)
  context?: string, key context needed to resume after memory loss
  started?: string, when work began
  completed?: string, when work finished
  blockers?(array): string, what's preventing progress
  parent_task?: Task, parent task if this is a subtask
settings:
  validation: warn
---
```

## Creating a Task

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/skills/memory-tasks/SKILL.md