trekker-marketplace

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:

1. Discovery - Find ready tasks
2. Engagement - Select and start a task
3. Execution - Complete the work
4. Documentation - Track progress and discoveries
5. Closure - Add summary and mark complete
6. 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 (5 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