dex

Task tracking for AI agents. Persistent memory for complex, multi-session work.

Why dex?

Structured tasks, not simple todos. Each task captures full context:

• Description: One-line summary (like an issue title)
• Context: Background, requirements, approach (like an issue body)
• Result: Implementation summary, decisions, outcomes (like a PR description)

Built for agent coordination. Agents break down work, track progress, and record results that persist across sessions.

Git-friendly storage. JSONL format (one task per line) enables collaboration, versioning, and conflict-free merges.

Quick Start

Install dex globally:

npm install -g @zeeg/dex

Or use the skills installer for your AI agent (Claude Code, OpenCode, Codex, Cursor):

npx skills add dcramer/dex

Use natural language or slash commands:

> Use Dex. Work on the next logical task. When done, run code-simplifier and commit.

/dex create a task to refactor the authentication module

Read the full documentation →

Contributing

Development Setup

git clone git@github.com:dcramer/dex.git
cd dex
pnpm install && pnpm build
pnpm link      # Makes 'dex' command available globally

Development Cycle

pnpm dev       # Watch mode - auto-rebuild on changes

Testing Locally

Test the plugin locally without installing from the marketplace:

claude --plugin-dir plugins/dex

This loads the plugin from the local directory. Restart your AI agent to pick up changes.

Manual Build

# Make changes...
pnpm build
pnpm test

Releasing

Releases are automated via GitHub Actions when a version tag is pushed.

# Run tests, build, and bump version (creates git tag)
pnpm release patch   # 0.1.0 → 0.1.1
pnpm release minor   # 0.1.0 → 0.2.0
pnpm release major   # 0.1.0 → 1.0.0

# Push commit and tag to trigger publish
git push --follow-tags

The workflow runs tests and publishes to npm with provenance.

{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "dex",
  "description": "Task tracking for Agents with CLI, MCP, and Claude Code interfaces",
  "owner": {
    "name": "dcramer",
    "email": "dcramer@gmail.com"
  },
  "plugins": [
    {
      "name": "dex",
      "description": "Task management skill for coordinating complex agent work",
      "author": {
        "name": "dcramer"
      },
      "source": "./plugins/dex",
      "category": "productivity"
    }
  ]
}