Deals represent revenue opportunities in your pipeline. Each deal has a stage, value, and optional links to contacts and companies. Use these commands to create, update, and move deals through your pipeline.
moss deal list
List deals with optional filtering.
moss deal list
moss deal list --stage qualified --min-value 10000
moss deal list --owner-id me
| Option | Required | Description |
|---|
--page <n> | No | Page number |
--per-page <n> | No | Items per page |
--sort <field> | No | Sort field (name, value, expected_close, created_at) |
--order <dir> | No | Sort order (asc or desc) |
--q <query> | No | Full-text search query |
--stage <stage> | No | Filter by stage (lead, qualified, proposal, negotiation, won, lost) |
--company-id <id> | No | Filter by company |
--contact-id <id> | No | Filter by linked contact |
--owner-id <id> | No | Filter by owner (UUID or "me" for current user) |
--min-value <n> | No | Minimum deal value |
--max-value <n> | No | Maximum deal value |
--tag <name> | No | Filter by tag name |
moss deal show
Show details for a single deal.
moss deal show --id deal_abc123
| Option | Required | Description |
|---|
--id <id> | Yes | Deal ID |
moss deal create
Create a new deal.
moss deal create \
--name "Acme Corp - Enterprise" \
--value 50000 \
--stage lead \
--company-id cmp_abc123 \
--owner-id me
| Option | Required | Description |
|---|
--name <name> | Yes | Deal name |
--company-id <id> | No | Company ID |
--stage <stage> | No | Stage: lead, qualified, proposal, negotiation, won, lost (default: lead) |
--value <n> | No | Deal value |
--currency <code> | No | Currency code (default: USD) |
--expected-close <date> | No | Expected close date (YYYY-MM-DD) |
--owner-id <id> | No | Owner user ID |
--notes <text> | No | Free-text notes |
--tags <tags> | No | Comma-separated tag names |
--set <key=value> | No | Set a custom field value (repeatable) |
moss deal create-batch
Create multiple deals from a JSON file. Each object in the array takes the same fields as moss deal create.
moss deal create-batch --file deals.json
cat deals.json | moss deal create-batch --file -
| Option | Required | Description |
|---|
--file <path> | Yes | Path to JSON file containing an array of deal objects, or "-" for stdin |
moss deal update
Update an existing deal.
moss deal update --id deal_abc123 --value 75000 --owner-id usr_def456
| Option | Required | Description |
|---|
--id <id> | Yes | Deal ID |
--name <name> | No | Deal name |
--company-id <id> | No | Company ID |
--value <n> | No | Deal value |
--currency <code> | No | Currency code |
--expected-close <date> | No | Expected close date (YYYY-MM-DD) |
--owner-id <id> | No | Owner user ID |
--notes <text> | No | Free-text notes |
--tags <tags> | No | Comma-separated tag names |
--set <key=value> | No | Set a custom field value (repeatable) |
moss deal move
Move a deal to a new stage.
moss deal move --id deal_abc123 --stage proposal
moss deal move --id deal_abc123 --stage lost --lost-reason "Budget cut"
| Option | Required | Description |
|---|
--id <id> | Yes | Deal ID |
--stage <stage> | Yes | Target stage: lead, qualified, proposal, negotiation, won, lost |
--lost-reason <reason> | No | Reason (required when moving to lost) |
moss deal bulk-move
Move multiple deals to a new stage at once.
moss deal bulk-move --ids deal_a1,deal_b2,deal_c3 --stage negotiation --confirm
| Option | Required | Description |
|---|
--ids <ids> | Yes | Comma-separated deal IDs |
--stage <stage> | Yes | Target stage: lead, qualified, proposal, negotiation, won, lost |
--confirm | Yes | Confirm bulk operation (required) |
moss deal delete
Delete a deal permanently.
moss deal delete --id deal_abc123 --confirm
| Option | Required | Description |
|---|
--id <id> | Yes | Deal ID |
--confirm | Yes | Confirm deletion (required for destructive operations) |
This permanently deletes the deal. This cannot be undone.
Manage contacts linked to a deal.
List contacts linked to a deal.
moss deal contact list --deal-id deal_abc123
| Option | Required | Description |
|---|
--deal-id <id> | Yes | Deal ID |
moss deal contact link --deal-id deal_abc123 --contact-id cnt_def456 --role "Decision Maker"
| Option | Required | Description |
|---|
--deal-id <id> | Yes | Deal ID |
--contact-id <id> | Yes | Contact ID |
--role <role> | No | Contact’s role in the deal |
moss deal contact unlink --deal-id deal_abc123 --contact-id cnt_def456
| Option | Required | Description |
|---|
--deal-id <id> | Yes | Deal ID |
--contact-id <id> | Yes | Contact ID |
