Dude Projects - Project Management

Manage development projects via the dude: MCP tools.

Quick Start

code

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:

code

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

To reactivate:

code

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

Search for Projects

Semantic Search

code

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

code

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:

•Get project context by directory:

code

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

•If project doesn't exist, create it:

code

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

•Then get full context:

code

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

•Begin coding with awareness of existing issues/specs

Organizing Projects

code

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