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

Parameters:

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

Getting Project Details

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

Parameters:

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

Updating Projects

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