---
id: 20
title: "CLI & init: Multi-project workspace support"
assignee: claude
tags: [cli, projects, init]
created: 2026-02-10
---

## Description

Update the CLI entry point and `init` command to support multi-project workspaces.

### CLI changes

```bash
# Workspace mode (default when .mdboard.yaml exists or multiple project dirs found)
uvx mdboard [--port PORT] [--dir WORKSPACE_DIR]

# Single-project mode (backward compat)
uvx mdboard [--port PORT] [--tasks-dir DIR]

# Init a new workspace
uvx mdboard init                    # creates .mdboard.yaml + first project
uvx mdboard init --project NAME     # adds a project to existing workspace
```

### What to build

1. **Auto-detect mode** — If `--tasks-dir` is passed, single-project mode. Otherwise, look for `.mdboard.yaml` or scan for project subdirs.
2. **Init updates** — `mdboard init` creates workspace structure. `mdboard init --project foo` scaffolds a new project subdir.
3. **Skill template update** — Update the Claude skill template in `init.py` to mention projects.

## Acceptance Criteria
- [ ] `mdboard` auto-detects workspace vs single-project mode
- [ ] `--tasks-dir` flag still works for single-project backward compat
- [ ] `mdboard init` creates workspace with `.mdboard.yaml` and a default project
- [ ] `mdboard init --project NAME` adds a new project to existing workspace
- [ ] Skill template references project structure

## Notes
