Skip to content

Commit f49da18

Browse files
dcramerclaude
andcommitted
docs: Make documentation agent-agnostic
Update documentation to use generic "AI agent" terminology instead of Claude Code-specific references. This reflects dex's compatibility with multiple AI coding assistants (Claude Code, OpenCode, Codex, Cursor). - Update README quick start with global install and skills installer - Replace "Claude Code" with "AI agent" throughout docs - Rename "Claude Code's TaskCreate" to "Built-in Task Tools" Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 78450f2 commit f49da18

File tree

5 files changed

+30
-23
lines changed

5 files changed

+30
-23
lines changed

README.md

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,16 @@ Task tracking for AI agents. Persistent memory for complex, multi-session work.
1616

1717
## Quick Start
1818

19-
Install the Claude Code plugin:
19+
Install dex globally:
2020

2121
```bash
22-
claude plugin marketplace add dcramer/dex
23-
claude plugin install dex@dex
22+
npm install -g @zeeg/dex
23+
```
24+
25+
Or use the skills installer for your AI agent (Claude Code, OpenCode, Codex, Cursor):
26+
27+
```bash
28+
npx skills dcramer/dex
2429
```
2530

2631
Use natural language or slash commands:
@@ -52,15 +57,15 @@ pnpm link # Makes 'dex' command available globally
5257
pnpm dev # Watch mode - auto-rebuild on changes
5358
```
5459

55-
### Testing the Claude Code Plugin
60+
### Testing Locally
5661

5762
Test the plugin locally without installing from the marketplace:
5863

5964
```bash
6065
claude --plugin-dir plugins/dex
6166
```
6267

63-
This loads the plugin from the local directory. Restart Claude Code to pick up changes.
68+
This loads the plugin from the local directory. Restart your AI agent to pick up changes.
6469

6570
### Manual Build
6671

docs/src/pages/guide.astro

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,18 @@ import Base from '../layouts/Base.astro';
33
import Terminal from '../components/Terminal.astro';
44
---
55

6-
<Base title="Guide" description="How to use dex with Claude Code for persistent task management">
6+
<Base title="Guide" description="How to use dex for persistent task management">
77
<h1>Guide</h1>
88

9-
<p>Dex helps Claude Code act as a <strong>master coordinator</strong> for complex work—breaking down tasks, tracking progress, and preserving context across sessions.</p>
9+
<p>Dex helps your AI agent act as a <strong>master coordinator</strong> for complex work—breaking down tasks, tracking progress, and preserving context across sessions.</p>
1010

1111
<h2>The Core Idea</h2>
1212

1313
<p>When you tell Claude "use dex" or invoke <code>/dex</code>, you're asking it to create <strong>persistent tickets</strong> that survive beyond the current session. Unlike Claude's built-in task tracking (which disappears when the session ends), dex tasks are stored as files in your repository.</p>
1414

1515
<p>This means:</p>
1616
<ul>
17-
<li>You can close Claude Code and pick up exactly where you left off</li>
17+
<li>You can close your session and pick up exactly where you left off</li>
1818
<li>Context, decisions, and progress are preserved</li>
1919
<li>Multiple sessions (or agents) can coordinate on the same work</li>
2020
<li>Task history lives alongside your code in git</li>
@@ -38,16 +38,16 @@ import Terminal from '../components/Terminal.astro';
3838
<li>The overhead isn't worth it</li>
3939
</ul>
4040

41-
<h2>dex vs Claude Code's TaskCreate</h2>
41+
<h2>dex vs Built-in Task Tools</h2>
4242

43-
<p>Claude Code has built-in task tools (<code>TaskCreate</code>, <code>TaskUpdate</code>, <code>TaskList</code>). These are <strong>not</strong> the same as dex.</p>
43+
<p>Some AI agents (like Claude Code) have built-in task tools (<code>TaskCreate</code>, <code>TaskUpdate</code>, <code>TaskList</code>). These are <strong>not</strong> the same as dex.</p>
4444

4545
<table>
4646
<thead>
4747
<tr>
4848
<th></th>
4949
<th>dex</th>
50-
<th>Claude Code TaskCreate</th>
50+
<th>Built-in Task Tools</th>
5151
</tr>
5252
</thead>
5353
<tbody>
@@ -74,7 +74,7 @@ import Terminal from '../components/Terminal.astro';
7474
</tbody>
7575
</table>
7676

77-
<p><strong>Rule of thumb:</strong> Use dex for work that needs to persist, be handed off, or tracked across sessions. Use Claude Code's TaskCreate only for ephemeral in-session tracking (like a scratchpad).</p>
77+
<p><strong>Rule of thumb:</strong> Use dex for work that needs to persist, be handed off, or tracked across sessions. Use built-in task tools only for ephemeral in-session tracking (like a scratchpad).</p>
7878

7979
<h2>Basic Workflow</h2>
8080

@@ -344,7 +344,7 @@ All 24 tests passing."</pre>
344344

345345
<p><strong>For team visibility:</strong></p>
346346
<ul>
347-
<li>Team members see progress without using Claude Code</li>
347+
<li>Team members see progress without needing the AI agent</li>
348348
<li>GitHub notifications keep everyone informed</li>
349349
</ul>
350350

docs/src/pages/install.astro

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ import Terminal from '../components/Terminal.astro';
44
import PackageManagerTabs from '../components/PackageManagerTabs.astro';
55
---
66

7-
<Base title="Install" description="Install dex for Claude Code and CLI">
7+
<Base title="Install" description="Install dex CLI and AI agent skills">
88
<h1>Installation</h1>
99

1010
<h2>Quick Start</h2>

docs/src/pages/skills.astro

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,10 +4,10 @@ import Terminal from '../components/Terminal.astro';
44
import { Code } from 'astro:components';
55
---
66

7-
<Base title="Skills" description="Claude Code skills for natural language task management">
7+
<Base title="Skills" description="Skills for AI agents to manage tasks with natural language">
88
<h1>Skills</h1>
99

10-
<p>Dex provides two skills for Claude Code that enable natural language task management.</p>
10+
<p>Dex provides two skills that enable natural language task management.</p>
1111

1212
<h2>/dex — Task Management</h2>
1313

plugins/dex/skills/dex/SKILL.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -42,15 +42,17 @@ Think: "Would someone understand the what, why, and how from this task alone?"
4242
- Everything fits in one session with no follow-up
4343
- Overhead exceeds value
4444

45-
## dex vs Claude Code's TaskCreate
45+
## dex vs Built-in Task Tools
4646

47-
| | dex | Claude Code TaskCreate |
48-
| --------------- | ------------------------------------- | ---------------------- |
49-
| **Persistence** | Files in `.dex/` | Session-only |
50-
| **Context** | Rich (description + context + result) | Basic |
51-
| **Hierarchy** | 3-level (epic → task → subtask) | Flat |
47+
Some AI agents (like Claude Code) have built-in task tools. These are session-only and not the same as dex.
5248

53-
Use **dex** for persistent work. Use **TaskCreate** for ephemeral in-session tracking only.
49+
| | dex | Built-in Task Tools |
50+
| --------------- | ------------------------------------- | ------------------- |
51+
| **Persistence** | Files in `.dex/` | Session-only |
52+
| **Context** | Rich (description + context + result) | Basic |
53+
| **Hierarchy** | 3-level (epic → task → subtask) | Flat |
54+
55+
Use **dex** for persistent work. Use built-in task tools for ephemeral in-session tracking only.
5456

5557
## Basic Workflow
5658

0 commit comments

Comments
 (0)