Trekker Claude Code Plugin
A Claude Code plugin for trekker, the AI-optimized issue tracker. Provides MCP tools, slash commands, agents, and skills for seamless task management in Claude Code.
Prerequisites
- trekker CLI installed globally
- Node.js 18+
- Claude Code CLI
Installation
Step 1: Install Trekker CLI
npm install -g @obsfx/trekker
Step 2: Install the Plugin
Option A: Via Plugin Marketplace (Recommended)
# Add the trekker marketplace
claude plugin marketplace add obsfx/trekker-claude-code
# Install the plugin
claude plugin install trekker
Or in Claude Code interactive mode:
/plugin marketplace add obsfx/trekker-claude-code
/plugin install trekker
The MCP server is bundled with the plugin and auto-configured.
Option B: Manual Installation
# Clone the repository
git clone https://github.com/obsfx/trekker-claude-code.git
# Symlink to Claude plugins directory
ln -s $(pwd)/trekker-claude-code ~/.claude/plugins/trekker
Step 3: Initialize Trekker in Your Project
cd your-project
trekker init
Features
MCP Tools (26 tools)
The MCP server exposes trekker functionality as tools:
| Category | Tool | Description |
|---|
| Task | trekker_task_create | Create a new task |
| Task | trekker_task_list | List tasks with filters and pagination |
| Task | trekker_task_show | Show task details |
| Task | trekker_task_update | Update task fields |
| Task | trekker_task_delete | Delete a task |
| Task | trekker_task_ready | Show unblocked tasks ready to work on |
| Epic | trekker_epic_create | Create an epic |
| Epic | trekker_epic_list | List epics with pagination |
| Epic | trekker_epic_show | Show epic details |
| Epic | trekker_epic_update | Update an epic |
| Epic | trekker_epic_delete | Delete an epic |
| Subtask | trekker_subtask_create | Create a subtask |
| Subtask | trekker_subtask_list | List subtasks with pagination |
| Subtask | trekker_subtask_update | Update a subtask |
| Subtask | trekker_subtask_delete | Delete a subtask |
| Comment | trekker_comment_add | Add a comment |
| Comment | trekker_comment_list | List comments with pagination |
| Comment | trekker_comment_update | Update a comment |
| Comment | trekker_comment_delete | Delete a comment |
| Dependency | trekker_dep_add | Add a dependency |
| Dependency | trekker_dep_remove | Remove a dependency |
| Dependency | trekker_dep_list | List dependencies |
| Search | trekker_search | FTS5 full-text search |
| System | trekker_init | Initialize trekker |
| System | trekker_quickstart | Get workflow guide |
| System | trekker_wipe | Wipe database |
Slash Commands (13 commands)
| Command | Description |
|---|
/trekker:prime | Load workflow context |
/trekker:create | Interactive task creation |
/trekker:list | List tasks with filters |
/trekker:show | Show task details |
/trekker:ready | Find unblocked work |
/trekker:start | Begin working on a task |
/trekker:done | Complete task with summary |
/trekker:blocked | Mark task as blocked |
/trekker:epic | Manage epics |
/trekker:comment | Add comment to task |
/trekker:deps | Manage dependencies |
/trekker:history | View audit trail of changes |
/trekker:task-agent | Run autonomous task agent |
Task Agent
The task agent (/trekker:task-agent) provides autonomous task completion:
- Discovery - Find ready tasks
- Engagement - Select and start a task
- Execution - Complete the work
- Documentation - Track progress and discoveries
- Closure - Add summary and mark complete
- Iteration - Move to next task
Invoke with /trekker:task-agent to let Claude work through tasks autonomously.
Skills (7 skills)
| Skill | Description |
|---|
trekker | Core workflow guide for task management |
planning | Plan and track multi-step tasks before implementation |
task-sync | Synchronize Trekker with Claude's built-in TodoWrite |
issue-tracking | Suggest Trekker when user mentions issues, bugs, or tasks |
search | Search-first workflow for finding existing tasks |
find-duplicates | Detect duplicate tasks before creating new ones |
smart-query | Intelligent task querying |
Hooks (4 hooks)
The plugin includes hooks for context management and workflow automation:
SessionStart - When Claude Code starts:
- Shows in-progress tasks with recent comments (resume context)
- If no work in progress, shows ready tasks
- Provides workflow reminder
PreCompact - Before context compaction:
- Reminds to save checkpoint comments
- Lists all in-progress tasks with details
- Shows recent comments for context preservation
- Provides checkpoint comment template
