wealthbox-cli 1.3.0__tar.gz → 1.5.0__tar.gz

{wealthbox_cli-1.3.0 → wealthbox_cli-1.5.0}/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "wealthbox-crm",
       "source": "./plugins/wealthbox-crm",
       "description": "Wealthbox CRM agent skill — natural-language CRM automation backed by the `wbox` CLI.",
-      "version": "1.2.0",
+      "version": "1.3.0",
       "category": "productivity",
       "tags": [
         "wealthbox",

{wealthbox_cli-1.3.0 → wealthbox_cli-1.5.0}/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wealthbox-crm",
   "description": "Wealthbox CRM agent skill — drive contacts, tasks, notes, events, and households via natural language. Bundles SKILL.md, references, and firm-bootstrap workflow. Requires the `wbox` CLI (auto-install instructions in SKILL.md).",
-  "version": "1.2.0",
+  "version": "1.5.0",
   "author": "Kadin Bullock",
   "homepage": "https://github.com/massive-value/wealthbox-cli",
   "repository": "https://github.com/massive-value/wealthbox-cli",

wealthbox_cli-1.5.0/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.4
+Name: wealthbox-cli
+Version: 1.5.0
+Summary: CLI and client library for the Wealthbox CRM API
+Project-URL: Homepage, https://github.com/massive-value/wealthbox-cli
+Project-URL: Documentation, https://massive-value.github.io/wealthbox-cli/
+Project-URL: Repository, https://github.com/massive-value/wealthbox-cli
+Project-URL: Issues, https://github.com/massive-value/wealthbox-cli/issues
+Project-URL: Changelog, https://github.com/massive-value/wealthbox-cli/blob/main/CHANGELOG.md
+Author: Kadin Bullock
+License: Apache-2.0
+License-File: LICENSE
+Keywords: api,cli,client-management,command-line,contacts,crm,financial-advisor,fintech,wealth-management,wealthbox
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx<1.0,>=0.27
+Requires-Dist: pydantic<3.0,>=2.0
+Requires-Dist: python-dotenv<2.0,>=1.0
+Requires-Dist: tabulate<1.0,>=0.9
+Requires-Dist: typer<1.0,>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.21; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Wealthbox CLI
+
+**Run your Wealthbox CRM through Claude or ChatGPT.** Tell your AI agent *"add a contact for Jane Doe, send her our welcome packet, and put a follow-up on my calendar for next Tuesday"* — and it just happens. No coding, no Python, no terminal commands to memorize.
+
+[![PyPI](https://img.shields.io/pypi/v/wealthbox-cli)](https://pypi.org/project/wealthbox-cli/) [![Downloads](https://img.shields.io/pypi/dm/wealthbox-cli)](https://pypi.org/project/wealthbox-cli/) [![CI](https://img.shields.io/github/actions/workflow/status/massive-value/wealthbox-cli/ci.yml?label=CI)](https://github.com/massive-value/wealthbox-cli/actions/workflows/ci.yml) [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+
+> Unofficial, community-built. Not affiliated with or endorsed by Wealthbox.
+
+------------------------------------------------------------------------
+
+## Install (60 seconds, no Python required)
+
+| Platform | Paste this into your terminal |
+|---|---|
+| **Mac / Linux** | `curl -LsSf https://raw.githubusercontent.com/massive-value/wealthbox-cli/main/scripts/install.sh \| bash` |
+| **Windows** (PowerShell) | `irm https://raw.githubusercontent.com/massive-value/wealthbox-cli/main/scripts/install.ps1 \| iex` |
+
+The installer:
+1. Sets up the tools it needs (Python, etc. — handled automatically).
+2. Asks for your **Wealthbox API token**. *Where to find it:* in Wealthbox, click your initials in the top right → **Settings** → **API Access** → **Create Access Token**. Paste the token when prompted.
+3. Installs the AI agent skill into [Claude Code](https://claude.ai/download) (and Codex, if you have it).
+
+That's it. Open Claude Code and try one of the prompts below.
+
+------------------------------------------------------------------------
+
+## Try this in Claude Code
+
+```
+"Show me my contacts created this week."
+
+"Add Jane Doe as a new prospect — she came in as a referral from Bob Smith."
+
+"Pull up the Smith household, add a task for me to call them on Monday."
+
+"Find notes from my meeting with the Joneses last month and summarize the action items."
+
+"Schedule an annual review with Mary Chen for the second Tuesday of next month."
+```
+
+The first time you ask the agent to do something, it'll walk you through a short Q&A about your firm's conventions (default contact types, naming patterns, common workflows). After that, it just works.
+
+If you're new to Claude Code itself, [download it here](https://claude.ai/download) — it's free for personal use.
+
+------------------------------------------------------------------------
+
+## What it covers
+
+Full read/write access for **contacts** (people, households, organizations, trusts), **tasks**, **events**, **notes**, **opportunities**, **projects**, and **workflows**. Read access for users, activity, and your firm's category lookups.
+
+Anything you can do in Wealthbox manually, the agent can do for you — usually in one sentence.
+
+------------------------------------------------------------------------
+
+## How it works
+
+Your AI agent uses a small command-line tool called `wbox` to talk to the [Wealthbox CRM API](https://dev.wealthbox.com). The skill that ships with this repo teaches the agent two things:
+
+1. **Your firm's conventions** — the agent walks you through a one-time Q&A on first use ("what's your default contact type for new prospects? what's your household naming convention?"), then remembers your answers. Stored locally on your machine, never sent to a server.
+2. **The right command for each request** — translating "add Jane as a prospect" into the correct API call, handling required fields, validating dropdowns against your firm's actual categories.
+
+You stay in control: the agent shows you what it's about to do before it does it.
+
+------------------------------------------------------------------------
+
+## Already a Claude Code user?
+
+You can install the skill directly from the plugin marketplace inside Claude Code:
+
+```
+/plugin marketplace add massive-value/wealthbox-cli
+/plugin install wealthbox-crm@massive-value
+```
+
+The plugin auto-updates daily. Firm data lives at `~/.config/wbox/firm/` (Mac/Linux) or `%APPDATA%\wbox\firm\` (Windows) and survives plugin updates. Run `wbox doctor` to see your install status anytime.
+
+------------------------------------------------------------------------
+
+## For developers and power users
+
+<details>
+<summary><b>Direct CLI use, scripting, automation</b></summary>
+
+```bash
+pip install wealthbox-cli
+wbox config set-token
+
+# List contacts as a table
+wbox contacts list --format table
+
+# Create a contact
+wbox contacts add person --first-name Jane --last-name Doe --contact-type Client
+
+# Export tasks to CSV
+wbox tasks list --format csv > tasks.csv
+
+# Add a meeting note linked to a contact
+wbox notes add "Discussed retirement plan" --contact 12345
+```
+
+Full command reference: [CLI Reference](https://massive-value.github.io/wealthbox-cli/cli-reference/). Output formats: `json` (default), `table`, `csv`, `tsv`. Date format: ISO 8601 (`2026-05-01T10:00:00-07:00`). See [Getting Started](https://massive-value.github.io/wealthbox-cli/getting-started/) for pipx, env-var auth, and project-scoped installs.
+</details>
+
+<details>
+<summary><b>Manage skill installs (legacy / Codex / project scope)</b></summary>
+
+```bash
+wbox skills install        # interactive picker — Claude Code, Codex, project scope
+wbox skills bootstrap      # populate firm data from your Wealthbox account
+wbox skills refresh        # re-fetch generated firm data (categories, users, custom fields)
+wbox skills upgrade        # update the bundled SKILL.md / references in every install
+wbox skills firm-path      # print the canonical firm data directory
+wbox skills uninstall      # remove the skill template (firm data is preserved)
+wbox doctor                # comprehensive health check
+```
+
+The marketplace plugin path (above) is recommended for Claude Code. The legacy `wbox skills install` path remains for Codex users (until OpenAI's marketplace lands), project-scoped installs, or air-gapped setups without the `claude` CLI.
+</details>
+
+<details>
+<summary><b>Architecture and contributing</b></summary>
+
+```
+src/wealthbox_tools/
+    cli/        # Typer commands
+    client/     # Async HTTP client built from mixins
+    models/     # Pydantic v2 input validation
+```
+
+Built with [Typer](https://typer.tiangolo.com/), [httpx](https://www.python-httpx.org/), and [Pydantic v2](https://docs.pydantic.dev/).
+
+```bash
+git clone https://github.com/massive-value/wealthbox-cli
+cd wealthbox-cli
+python -m venv .venv
+# Activate: source .venv/bin/activate (Mac/Linux) | .venv\Scripts\Activate.ps1 (Windows)
+pip install -e ".[dev]"
+pytest
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [CLAUDE.md](CLAUDE.md) for the architecture guide and conventions.
+</details>
+
+<details>
+<summary><b>Troubleshooting</b></summary>
+
+- **401 Unauthorized** — token expired or wrong. Run `wbox config show` to see the masked token, `wbox config set-token` to update.
+- **Windows: "execution policy" error during install** — the installer offers to fix this for you. If you skipped it, run `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` and re-run the installer.
+- **Linux: command not found after install** — open a new terminal, or run `source ~/.local/bin/env` in your current shell.
+- **Date format errors** — Wealthbox needs ISO 8601: `"2026-05-01T10:00:00-07:00"` for datetimes, `"YYYY-MM-DD"` for date-only fields.
+- **Writes succeed but nothing changes** — some category-constrained fields silently no-op on bad values. Check valid values with `wbox categories <type>`.
+
+For anything else, open an issue at [github.com/massive-value/wealthbox-cli/issues](https://github.com/massive-value/wealthbox-cli/issues).
+</details>
+
+------------------------------------------------------------------------
+
+## Links
+
+[Documentation](https://massive-value.github.io/wealthbox-cli/) · [Changelog](https://massive-value.github.io/wealthbox-cli/changelog/) · [PyPI](https://pypi.org/project/wealthbox-cli/) · [Wealthbox CRM](https://www.wealthbox.com/) · [Wealthbox API](https://dev.wealthbox.com)
+
+## Disclaimer
+
+This is an **unofficial, community-built** tool. It is not affiliated with, endorsed by, or supported by Wealthbox or its parent company. "Wealthbox" is a trademark of its respective owner. Use of this tool is subject to the [Wealthbox API Terms of Service](https://dev.wealthbox.com).
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

wealthbox_cli-1.5.0/README.md

@@ -0,0 +1,168 @@
+# Wealthbox CLI
+
+**Run your Wealthbox CRM through Claude or ChatGPT.** Tell your AI agent *"add a contact for Jane Doe, send her our welcome packet, and put a follow-up on my calendar for next Tuesday"* — and it just happens. No coding, no Python, no terminal commands to memorize.
+
+[![PyPI](https://img.shields.io/pypi/v/wealthbox-cli)](https://pypi.org/project/wealthbox-cli/) [![Downloads](https://img.shields.io/pypi/dm/wealthbox-cli)](https://pypi.org/project/wealthbox-cli/) [![CI](https://img.shields.io/github/actions/workflow/status/massive-value/wealthbox-cli/ci.yml?label=CI)](https://github.com/massive-value/wealthbox-cli/actions/workflows/ci.yml) [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+
+> Unofficial, community-built. Not affiliated with or endorsed by Wealthbox.
+
+------------------------------------------------------------------------
+
+## Install (60 seconds, no Python required)
+
+| Platform | Paste this into your terminal |
+|---|---|
+| **Mac / Linux** | `curl -LsSf https://raw.githubusercontent.com/massive-value/wealthbox-cli/main/scripts/install.sh \| bash` |
+| **Windows** (PowerShell) | `irm https://raw.githubusercontent.com/massive-value/wealthbox-cli/main/scripts/install.ps1 \| iex` |
+
+The installer:
+1. Sets up the tools it needs (Python, etc. — handled automatically).
+2. Asks for your **Wealthbox API token**. *Where to find it:* in Wealthbox, click your initials in the top right → **Settings** → **API Access** → **Create Access Token**. Paste the token when prompted.
+3. Installs the AI agent skill into [Claude Code](https://claude.ai/download) (and Codex, if you have it).
+
+That's it. Open Claude Code and try one of the prompts below.
+
+------------------------------------------------------------------------
+
+## Try this in Claude Code
+
+```
+"Show me my contacts created this week."
+
+"Add Jane Doe as a new prospect — she came in as a referral from Bob Smith."
+
+"Pull up the Smith household, add a task for me to call them on Monday."
+
+"Find notes from my meeting with the Joneses last month and summarize the action items."
+
+"Schedule an annual review with Mary Chen for the second Tuesday of next month."
+```
+
+The first time you ask the agent to do something, it'll walk you through a short Q&A about your firm's conventions (default contact types, naming patterns, common workflows). After that, it just works.
+
+If you're new to Claude Code itself, [download it here](https://claude.ai/download) — it's free for personal use.
+
+------------------------------------------------------------------------
+
+## What it covers
+
+Full read/write access for **contacts** (people, households, organizations, trusts), **tasks**, **events**, **notes**, **opportunities**, **projects**, and **workflows**. Read access for users, activity, and your firm's category lookups.
+
+Anything you can do in Wealthbox manually, the agent can do for you — usually in one sentence.
+
+------------------------------------------------------------------------
+
+## How it works
+
+Your AI agent uses a small command-line tool called `wbox` to talk to the [Wealthbox CRM API](https://dev.wealthbox.com). The skill that ships with this repo teaches the agent two things:
+
+1. **Your firm's conventions** — the agent walks you through a one-time Q&A on first use ("what's your default contact type for new prospects? what's your household naming convention?"), then remembers your answers. Stored locally on your machine, never sent to a server.
+2. **The right command for each request** — translating "add Jane as a prospect" into the correct API call, handling required fields, validating dropdowns against your firm's actual categories.
+
+You stay in control: the agent shows you what it's about to do before it does it.
+
+------------------------------------------------------------------------
+
+## Already a Claude Code user?
+
+You can install the skill directly from the plugin marketplace inside Claude Code:
+
+```
+/plugin marketplace add massive-value/wealthbox-cli
+/plugin install wealthbox-crm@massive-value
+```
+
+The plugin auto-updates daily. Firm data lives at `~/.config/wbox/firm/` (Mac/Linux) or `%APPDATA%\wbox\firm\` (Windows) and survives plugin updates. Run `wbox doctor` to see your install status anytime.
+
+------------------------------------------------------------------------
+
+## For developers and power users
+
+<details>
+<summary><b>Direct CLI use, scripting, automation</b></summary>
+
+```bash
+pip install wealthbox-cli
+wbox config set-token
+
+# List contacts as a table
+wbox contacts list --format table
+
+# Create a contact
+wbox contacts add person --first-name Jane --last-name Doe --contact-type Client
+
+# Export tasks to CSV
+wbox tasks list --format csv > tasks.csv
+
+# Add a meeting note linked to a contact
+wbox notes add "Discussed retirement plan" --contact 12345
+```
+
+Full command reference: [CLI Reference](https://massive-value.github.io/wealthbox-cli/cli-reference/). Output formats: `json` (default), `table`, `csv`, `tsv`. Date format: ISO 8601 (`2026-05-01T10:00:00-07:00`). See [Getting Started](https://massive-value.github.io/wealthbox-cli/getting-started/) for pipx, env-var auth, and project-scoped installs.
+</details>
+
+<details>
+<summary><b>Manage skill installs (legacy / Codex / project scope)</b></summary>
+
+```bash
+wbox skills install        # interactive picker — Claude Code, Codex, project scope
+wbox skills bootstrap      # populate firm data from your Wealthbox account
+wbox skills refresh        # re-fetch generated firm data (categories, users, custom fields)
+wbox skills upgrade        # update the bundled SKILL.md / references in every install
+wbox skills firm-path      # print the canonical firm data directory
+wbox skills uninstall      # remove the skill template (firm data is preserved)
+wbox doctor                # comprehensive health check
+```
+
+The marketplace plugin path (above) is recommended for Claude Code. The legacy `wbox skills install` path remains for Codex users (until OpenAI's marketplace lands), project-scoped installs, or air-gapped setups without the `claude` CLI.
+</details>
+
+<details>
+<summary><b>Architecture and contributing</b></summary>
+
+```
+src/wealthbox_tools/
+    cli/        # Typer commands
+    client/     # Async HTTP client built from mixins
+    models/     # Pydantic v2 input validation
+```
+
+Built with [Typer](https://typer.tiangolo.com/), [httpx](https://www.python-httpx.org/), and [Pydantic v2](https://docs.pydantic.dev/).
+
+```bash
+git clone https://github.com/massive-value/wealthbox-cli
+cd wealthbox-cli
+python -m venv .venv
+# Activate: source .venv/bin/activate (Mac/Linux) | .venv\Scripts\Activate.ps1 (Windows)
+pip install -e ".[dev]"
+pytest
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [CLAUDE.md](CLAUDE.md) for the architecture guide and conventions.
+</details>
+
+<details>
+<summary><b>Troubleshooting</b></summary>
+
+- **401 Unauthorized** — token expired or wrong. Run `wbox config show` to see the masked token, `wbox config set-token` to update.
+- **Windows: "execution policy" error during install** — the installer offers to fix this for you. If you skipped it, run `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser` and re-run the installer.
+- **Linux: command not found after install** — open a new terminal, or run `source ~/.local/bin/env` in your current shell.
+- **Date format errors** — Wealthbox needs ISO 8601: `"2026-05-01T10:00:00-07:00"` for datetimes, `"YYYY-MM-DD"` for date-only fields.
+- **Writes succeed but nothing changes** — some category-constrained fields silently no-op on bad values. Check valid values with `wbox categories <type>`.
+
+For anything else, open an issue at [github.com/massive-value/wealthbox-cli/issues](https://github.com/massive-value/wealthbox-cli/issues).
+</details>
+
+------------------------------------------------------------------------
+
+## Links
+
+[Documentation](https://massive-value.github.io/wealthbox-cli/) · [Changelog](https://massive-value.github.io/wealthbox-cli/changelog/) · [PyPI](https://pypi.org/project/wealthbox-cli/) · [Wealthbox CRM](https://www.wealthbox.com/) · [Wealthbox API](https://dev.wealthbox.com)
+
+## Disclaimer
+
+This is an **unofficial, community-built** tool. It is not affiliated with, endorsed by, or supported by Wealthbox or its parent company. "Wealthbox" is a trademark of its respective owner. Use of this tool is subject to the [Wealthbox API Terms of Service](https://dev.wealthbox.com).
+
+## License
+
+Apache 2.0 — see [LICENSE](LICENSE).

{wealthbox_cli-1.3.0/plugins/wealthbox-crm/skills → wealthbox_cli-1.5.0/codex-skill}/wealthbox-crm/references/contacts.md

@@ -36,7 +36,7 @@ wbox contacts <ID>
 wbox contacts get <ID>
 ```
 
-Returns full contact record including comments (use `--no-comments` to omit).
+Returns the full contact record. Contacts do not carry comments in Wealthbox — to read comments, fetch the related task, note, event, opportunity, project, or workflow with its `get` command (those default to including comments and accept `--no-comments` to suppress).
 
 ## Create Contact
 
@@ -69,6 +69,7 @@ wbox contacts add person [OPTIONS]
 | `--email-type` | STR | Work, Personal, etc. |
 | `--phone` | STR | Phone number |
 | `--phone-type` | STR | Work, Mobile, etc. |
+| `--tags` | STR | Comma-separated tag names (e.g. "VIP,Q1-Outreach"). New tags are auto-created. |
 | `--more-fields` | JSON | Additional fields as JSON object |
 | `--format` | json\|table\|csv\|tsv | Output format |
 
@@ -76,7 +77,7 @@ wbox contacts add person [OPTIONS]
 ```bash
 wbox contacts add household --name <NAME> [OPTIONS]
 ```
-`--name` is required. Supports: `--contact-type`, `--contact-source`, `--active/--inactive`, `--assigned-to`, `--email`, `--email-type`, `--more-fields`, `--format`.
+`--name` is required. Supports: `--contact-type`, `--contact-source`, `--active/--inactive`, `--assigned-to`, `--email`, `--email-type`, `--tags`, `--more-fields`, `--format`.
 
 ### Organization
 ```bash
@@ -110,6 +111,7 @@ Only pass the fields you want to change:
 | `--contact-source` | STR | Source |
 | `--active` / `--inactive` | flag | Active status |
 | `--assigned-to` | INT | Reassign to user ID |
+| `--tags` | STR | Comma-separated tag names. Replaces all tags — include existing ones to keep. |
 | `--json` | STR | Full JSON for nested/complex fields |
 | `--format` | json\|table\|csv\|tsv | Output format |
 

{wealthbox_cli-1.3.0/plugins/wealthbox-crm/skills → wealthbox_cli-1.5.0/codex-skill}/wealthbox-crm/references/tasks.md

@@ -44,17 +44,21 @@ wbox tasks add <NAME> [OPTIONS]
 |------|------|-------------|
 | `<NAME>` | positional | Task name (required) |
 | `--due-date` | STR | Due date (XOR with --frame) |
-| `--frame` | today\|tomorrow\|this-week\|next-week\|this-month\|next-month\|... | Relative due date (XOR with --due-date) |
+| `--frame` | today\|tomorrow\|this-week\|next-week\|future\|specific | Relative due date (XOR with --due-date). Both kebab-case (`next-week`) and snake_case (`next_week`) are accepted. |
 | `--priority` | Low\|Medium\|High | Priority level |
+| `--category` | STR | Task category by name or ID (e.g. "Follow-up"). See `wbox categories task-categories`. |
+| `--description` | STR | Task description |
 | `--assigned-to` | INT | Assign to user ID |
 | `--contact` | INT | Link to contact |
 | `--project` | INT | Link to project |
 | `--opportunity` | INT | Link to opportunity |
-| `--more-fields` | JSON | e.g. `{"category": 123, "description": "..."}` |
+| `--more-fields` | JSON | e.g. `{"complete": false, "assigned_to_team": 456}` |
 | `--format` | json\|table\|csv\|tsv | Output format |
 
 **Note:** `--due-date` and `--frame` are mutually exclusive. Use `--frame` for relative dates.
 
+**Note (Wealthbox quirk):** `--frame next_week` resolves on the API side to the Monday of the calendar week *after* today. **If today is Sunday, `next_week` is tomorrow** (Monday) — only one day away, not seven. Wealthbox treats Sunday as the last day of the current week. If precise control matters (e.g. an advisor said "next week" expecting 7+ days out), use `--due-date YYYY-MM-DDTHH:MM:SS-07:00` with an explicit date instead of `--frame`.
+
 ## Update Task
 
 ```bash
@@ -65,8 +69,9 @@ wbox tasks update <ID> [OPTIONS]
 |------|------|-------------|
 | `--name` | STR | Rename |
 | `--due-date` | STR | Change due date |
-| `--frame` | STR | Change relative due date |
+| `--frame` | STR | Change relative due date. Accepts kebab-case (`next-week`) or snake_case (`next_week`); see Note above re: Sunday boundary. |
 | `--priority` | Low\|Medium\|High | Change priority |
+| `--category` | STR | Task category by name or ID. See `wbox categories task-categories`. |
 | `--assigned-to` | INT | Reassign |
 | `--complete` / `--no-complete` | flag | Mark complete/incomplete |
 | `--description` | STR | Update description |

{wealthbox_cli-1.3.0 → wealthbox_cli-1.5.0}/plugins/wealthbox-crm/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wealthbox-crm",
   "description": "Wealthbox CRM agent skill — drive contacts, tasks, notes, events, and households via natural language. Bundles SKILL.md, references, and firm-bootstrap workflow. Requires the `wbox` CLI (auto-install instructions in SKILL.md).",
-  "version": "1.2.0",
+  "version": "1.5.0",
   "author": {
     "name": "Kadin Bullock"
   },

{wealthbox_cli-1.3.0/src/wealthbox_tools → wealthbox_cli-1.5.0/plugins/wealthbox-crm}/skills/wealthbox-crm/references/contacts.md

@@ -36,7 +36,7 @@ wbox contacts <ID>
 wbox contacts get <ID>
 ```
 
-Returns full contact record including comments (use `--no-comments` to omit).
+Returns the full contact record. Contacts do not carry comments in Wealthbox — to read comments, fetch the related task, note, event, opportunity, project, or workflow with its `get` command (those default to including comments and accept `--no-comments` to suppress).
 
 ## Create Contact
 
@@ -69,6 +69,7 @@ wbox contacts add person [OPTIONS]
 | `--email-type` | STR | Work, Personal, etc. |
 | `--phone` | STR | Phone number |
 | `--phone-type` | STR | Work, Mobile, etc. |
+| `--tags` | STR | Comma-separated tag names (e.g. "VIP,Q1-Outreach"). New tags are auto-created. |
 | `--more-fields` | JSON | Additional fields as JSON object |
 | `--format` | json\|table\|csv\|tsv | Output format |
 
@@ -76,7 +77,7 @@ wbox contacts add person [OPTIONS]
 ```bash
 wbox contacts add household --name <NAME> [OPTIONS]
 ```
-`--name` is required. Supports: `--contact-type`, `--contact-source`, `--active/--inactive`, `--assigned-to`, `--email`, `--email-type`, `--more-fields`, `--format`.
+`--name` is required. Supports: `--contact-type`, `--contact-source`, `--active/--inactive`, `--assigned-to`, `--email`, `--email-type`, `--tags`, `--more-fields`, `--format`.
 
 ### Organization
 ```bash
@@ -110,6 +111,7 @@ Only pass the fields you want to change:
 | `--contact-source` | STR | Source |
 | `--active` / `--inactive` | flag | Active status |
 | `--assigned-to` | INT | Reassign to user ID |
+| `--tags` | STR | Comma-separated tag names. Replaces all tags — include existing ones to keep. |
 | `--json` | STR | Full JSON for nested/complex fields |
 | `--format` | json\|table\|csv\|tsv | Output format |
 

{wealthbox_cli-1.3.0/src/wealthbox_tools → wealthbox_cli-1.5.0/plugins/wealthbox-crm}/skills/wealthbox-crm/references/tasks.md

@@ -44,17 +44,21 @@ wbox tasks add <NAME> [OPTIONS]
 |------|------|-------------|
 | `<NAME>` | positional | Task name (required) |
 | `--due-date` | STR | Due date (XOR with --frame) |
-| `--frame` | today\|tomorrow\|this-week\|next-week\|this-month\|next-month\|... | Relative due date (XOR with --due-date) |
+| `--frame` | today\|tomorrow\|this-week\|next-week\|future\|specific | Relative due date (XOR with --due-date). Both kebab-case (`next-week`) and snake_case (`next_week`) are accepted. |
 | `--priority` | Low\|Medium\|High | Priority level |
+| `--category` | STR | Task category by name or ID (e.g. "Follow-up"). See `wbox categories task-categories`. |
+| `--description` | STR | Task description |
 | `--assigned-to` | INT | Assign to user ID |
 | `--contact` | INT | Link to contact |
 | `--project` | INT | Link to project |
 | `--opportunity` | INT | Link to opportunity |
-| `--more-fields` | JSON | e.g. `{"category": 123, "description": "..."}` |
+| `--more-fields` | JSON | e.g. `{"complete": false, "assigned_to_team": 456}` |
 | `--format` | json\|table\|csv\|tsv | Output format |
 
 **Note:** `--due-date` and `--frame` are mutually exclusive. Use `--frame` for relative dates.
 
+**Note (Wealthbox quirk):** `--frame next_week` resolves on the API side to the Monday of the calendar week *after* today. **If today is Sunday, `next_week` is tomorrow** (Monday) — only one day away, not seven. Wealthbox treats Sunday as the last day of the current week. If precise control matters (e.g. an advisor said "next week" expecting 7+ days out), use `--due-date YYYY-MM-DDTHH:MM:SS-07:00` with an explicit date instead of `--frame`.
+
 ## Update Task
 
 ```bash
@@ -65,8 +69,9 @@ wbox tasks update <ID> [OPTIONS]
 |------|------|-------------|
 | `--name` | STR | Rename |
 | `--due-date` | STR | Change due date |
-| `--frame` | STR | Change relative due date |
+| `--frame` | STR | Change relative due date. Accepts kebab-case (`next-week`) or snake_case (`next_week`); see Note above re: Sunday boundary. |
 | `--priority` | Low\|Medium\|High | Change priority |
+| `--category` | STR | Task category by name or ID. See `wbox categories task-categories`. |
 | `--assigned-to` | INT | Reassign |
 | `--complete` / `--no-complete` | flag | Mark complete/incomplete |
 | `--description` | STR | Update description |

{wealthbox_cli-1.3.0 → wealthbox_cli-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wealthbox-cli"
-version = "1.3.0"
+version = "1.5.0"
 description = "CLI and client library for the Wealthbox CRM API"
 readme = "README.md"
 requires-python = ">=3.11"