Task tracking for AI agents. Persistent memory for complex, multi-session work.
> /plugin marketplace add dcramer/dex> /plugin install dex@dex
Repo: dcramer/dex
What's inside
Task tracking for AI agents. Persistent memory for complex, multi-session work.
Structured tasks, not simple todos. Each task captures full context:
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.
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 โ
git clone git@github.com:dcramer/dex.git
cd dex
pnpm install && pnpm build
pnpm link # Makes 'dex' command available globally
pnpm dev # Watch mode - auto-rebuild on changes
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.
# Make changes...
pnpm build
pnpm test
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.
.claude/
.claude-plugin/
marketplace.json
commands/
dex
dex-plan
settings.json
.dex/
config.toml
.github/
workflows/
ci.yml
deploy-docs.yml
publish.yml
.gitignore
AGENTS.md
CLAUDE.md
dex.toml.example
docs/
.gitignore
astro.config.mjs
package.json
pnpm-lock.yaml
public/
favicon.svg
llms.txt
og-image.svg
redirect/
404.html
index.html
src/
components/
Code.astro
PackageManagerTabs.astro
Terminal.astro
layouts/
Base.astro
pages/
cli.astro
config.astro
guide.astro
index.astro
install.astro
skills.astro
styles/
global.css
vercel.json
LICENSE
package.json
plugins/
.claude-plugin/
marketplace.json
dex/
.claude-plugin/
plugin.json
skills/
dex/
dex-plan/
SKILL.md
cli-reference.md
epic-examples.md
examples.md
hierarchies.md
SKILL.md
verification.md
pnpm-lock.yaml
README.md
specs/
beads-import.md
sync.md
task-completion.md
src/
bootstrap.ts
cli/
archive.test.ts
archive.ts
args.ts
colors.ts
complete.test.ts
complete.ts
completion/
completion.test.ts
completion.ts
bash.ts
fish.ts
zsh.ts
config.test.ts
config.ts
create.test.ts
create.ts
delete.test.ts
delete.ts
dir.test.ts
dir.ts
doctor.test.ts
doctor.ts
edit.test.ts
edit.ts
export.test.ts
export.ts
formatting.ts
git.ts
help.test.ts
help.ts
import.test.ts
import.ts
index.test.ts
index.ts
init.test.ts
init.ts
list.test.ts
list.ts
plan.test.ts
plan.ts
show.test.ts
show.ts
start.test.ts
start.ts
status.test.ts
status.ts
sync.test.ts
sync.ts
test-helpers.ts
tree-display.ts
utils.test.ts
utils.ts
version.test.ts
version.ts
core/
archive-compactor.test.ts
archive-compactor.ts
auto-archive.test.ts
auto-archive.ts
beads/
fixtures/
fixtures.test.ts
basic.jsonl
edge-cases.jsonl
graph.jsonl
README.md
import.test.ts
import.ts
index.ts
config.test.ts
config.ts
git-remote.test.ts
git-utils.ts
github/
github-sync.test.ts
index.ts
issue-markdown.test.ts
issue-markdown.ts
issue-parsing.ts
issue-rendering.ts
remote.ts
sync-factory.ts
sync.ts
token.ts
plan-parser.test.ts
plan-parser.ts
project-key.test.ts
project-key.ts
shortcut/
shortcut-sync.test.ts
api.ts
index.ts
story-markdown.test.ts
story-markdown.ts
sync-factory.ts
sync.test.ts
sync.ts
token.ts
storage/
storage.test.ts
archive-storage.test.ts
archive-storage.ts
engine.ts
file-storage.test.ts
file-storage.ts
index.ts
jsonl-storage.test.ts
jsonl-storage.ts
migrations.ts
paths.ts
sync/
sync-state.test.ts
sync-state.ts
ARCHITECTURE.md
index.ts
interface.ts
registry.ts
task-relationships.test.ts
task-relationships.ts
task-service.test.ts
task-service.ts
errors.ts
index.ts
mcp/
server.test.ts
server.ts
test-helpers.ts
tools/
create-task.ts
list-tasks.ts
response.test.ts
response.ts
update-task.ts
test-utils/
github-mock.ts
index.ts
shortcut-mock.ts
test-env.ts
types.test.ts
types.ts
TESTING.md
tsconfig.json
vitest.config.ts
vitest.setup.tsFAQ
dcramer-dex is a Claude Code plugin with 2 hand-picked skills for productivity work, indexed on Flowy. Install it with the command on its page. It includes dex-plan, dex. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.