dude-projects

name	dude-projects
description	Manage development projects using the dude MCP server. List, create, update projects. Get full project context with issues and specifications. Search for projects. Use when working with project organization, project hierarchies, starting work on a codebase, or needing project-level context.

Dude Projects - Project Management

Manage development projects via the dude: MCP tools.

Quick Start

dude:list_projects              - List all projects
dude:get_project_context        - Full project with issues/specs
dude:search { "entityTypes": ["project"] }  - Find projects

Project Operations

Listing Projects

Tool	Description
dude:list_projects	List all projects or filter by parent

Parameters:

• parentUuid (optional): Filter to children of parent project

Getting Project Details

Tool	Description
dude:get_project	Get single project details by UUID
dude:get_project_by_directory	Get project by directory path (for session init)
dude:get_project_context	Get project with ALL issues and specs

get_project Parameters:

• uuid (required): Project UUID

get_project_by_directory Parameters:

• directory (required): Project directory path

get_project_context Parameters:

• uuid (optional): Project UUID
• directory (optional): Project directory path (alternative to UUID)
• includeSubprojects (optional): Include child projects (default: false)

Note: get_project_context accepts either uuid OR directory - use whichever you have.

Creating Projects

Tool	Description
dude:create_project	Create new project

Parameters:

• name (required): Project name
• directory (optional): Project directory path
• parent_project_uuid (optional): Parent project for nesting

Updating Projects

Tool	Description
dude:update_project	Update existing project

Parameters:

• uuid (required): Project UUID
• name (optional): New name
• directory (optional): New directory path
• parent_project_uuid (optional, nullable): New parent (null for top-level)
• active (optional): Set active status (1 = active, 0 = inactive)

Archiving Projects

To archive a project (soft delete), set the active flag to 0:

dude:update_project { "uuid": "...", "active": 0 }

To reactivate:

dude:update_project { "uuid": "...", "active": 1 }

Search for Projects

Semantic Search

dude:search {
  "query": "authentication service",
  "entityTypes": ["project"],
  "limit": 5
}

Parameters:

• query (required): Natural language search query
• limit (optional): Max results (default: 10)
• threshold (optional): Min similarity 0-1 (default: 0.3)
• entityTypes (optional): Filter to ["project"]
• projectUuid (optional): Scope to specific project

Keyword Search

dude:search_text { "query": "auth" }

Parameters:

• query (required): Text to search for

Common Workflows

Starting Work on a Codebase (MANDATORY)

Always start with this workflow:

1. Get project context by directory:

dude:get_project_context { "directory": "/path/to/codebase" }

2. If project doesn't exist, create it:

dude:create_project { "name": "my-project", "directory": "/path/to/codebase" }

3. Then get full context:

dude:get_project_context { "uuid": "{project_uuid}" }

4. Begin coding with awareness of existing issues/specs

Organizing Projects

dude:create_project { "name": "Frontend", "parent_project_uuid": "parent-uuid" }

Related Skills

• dude-issues: Create and manage issues within projects
• dude-specifications: Create and manage specifications within projects