# vodoo project

Manage Odoo Projects (`project.project`).

<!-- This file is auto-generated by scripts/gen_cli_docs.py. Do not edit manually. -->

## Commands

### list

List projects.

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--name` | TEXT | Filter by project name |
| `--user` | TEXT | Filter by project manager name |
| `--partner` | TEXT | Filter by partner name |
| `--limit` | INT | Maximum number of projects (default: 50) |
| `--field` / `-f` | TEXT | Specific fields to fetch (can be used multiple times) |

### show

Show detailed project information.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--field` / `-f` | TEXT | Specific fields to fetch (can be used multiple times) |
| `--html` | BOOL | Show raw HTML description instead of markdown |

### comment

Add a comment to a project (visible to followers).

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |
| `message` | TEXT | Comment message |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--author` / `-a` | INT | User ID to post as |
| `--no-markdown` | BOOL | Disable markdown to HTML conversion |

### note

Add an internal note to a project.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |
| `message` | TEXT | Note message |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--author` / `-a` | INT | User ID to post as |
| `--no-markdown` | BOOL | Disable markdown to HTML conversion |

### chatter

Show message history/chatter for a project.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--limit` | INT | Maximum number of messages to show |
| `--html` | BOOL | Show raw HTML body instead of plain text |

### attachments

List attachments for a project.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |

### fields

List available fields or show field values for a specific project.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID (optional) |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--field-name` | TEXT | Show details for a specific field |

### set

Set field values on a project.

Supports operators: =, +=, -=, *=, /=
HTML fields automatically convert markdown to HTML.

Examples:
    vodoo project set 42 name="New Project Name"
    vodoo project set 42 user_id=5

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |
| `fields` | TEXT | Field assignments in format 'field=value' or 'field+=amount' |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--no-markdown` | BOOL | Disable markdown to HTML conversion for HTML fields |

### attach

Attach a file to a project.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |
| `file_path` | PATH | Path to file to attach |

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--name` / `-n` | TEXT | Custom attachment name (defaults to filename) |

### url

Get the web URL for a project.

**Arguments:**

| Argument | Type | Description |
|----------|------|-------------|
| `project_id` | INT | Project ID |

### stages

List task stages for projects.

Shows all stages or only stages available for a specific project.

Examples:
    vodoo project stages              # All stages
    vodoo project stages --project 10 # Stages for project ID 10

**Options:**

| Option | Type | Description |
|--------|------|-------------|
| `--project` / `-p` | INT | Filter stages by project ID |

