---
name: kandev-projects
description: List and create Office projects, then place new tasks in the correct project when organizing workspace work by repository.
kandev:
  system: true
  version: "0.42.0"
  default_for_roles: [ceo]
---

# Projects

Use project IDs returned by the CLI. Project access is scoped to the current
Office workspace, and project creation is permission checked.

## Inspect projects

```bash
$KANDEV_CLI kandev projects list
```

## Create a project

`--name` is required. Repeat `--repository` for each repository URL or local
path the project owns.

```bash
$KANDEV_CLI kandev projects create \
  --name "Payments" \
  --description "Payment services and checkout" \
  --repository "https://github.com/acme/payments" \
  --repository "/workspace/checkout"
```

Optional project fields are `--lead-agent-profile-id`, `--color`,
`--budget-cents`, and `--executor-config`.

## Create work in a project

Pass the returned project ID when creating a task:

```bash
$KANDEV_CLI kandev task create \
  --title "Add payment retry policy" \
  --project "$PROJECT_ID" \
  --assignee "$AGENT_ID"
```

Do not create a duplicate project when an existing project already owns the
repository. Office runs do not administer workspaces.