feat(field): read and write custom fields with per-type value coercion

README.md

@@ -17,6 +17,7 @@ A GitHub CLI-inspired command-line interface for ClickUp.
 - **GitHub CLI-like Interface**: Familiar command structure for developers who use `gh`
 - **Task Management**: Create, view, update, and manage tasks from the command line
 - **Comment Management**: Add, list, and delete comments on tasks with user assignment
+- **Custom Fields**: Read and write ClickUp custom fields, resolving names to option ids
 - **Cache Management**: Optimize performance with intelligent caching and cache control commands
 - **Project Configuration**: Set project-specific defaults with `.cu.yml` configuration files
 - **API Passthrough**: Direct access to ClickUp API endpoints for advanced operations
@@ -93,6 +94,23 @@ cu comment list <task-id>
 cu comment <task-id> -m "Please review" --assignee user@example.com
 ```
 
+### Custom Fields
+```bash
+# List the custom fields available on a list
+cu field list --list abc123
+
+# Show the values set on a task
+cu field get <task-id>
+
+# Set values — names are resolved to option ids, dates to epoch millis
+cu field set <task-id> Repo https://github.com/owner/repo
+cu field set <task-id> "Last synced" today
+cu field set <task-id> Machine "Chilastra,Sunrunner"
+
+# Clear a value
+cu field clear <task-id> "Last synced"
+```
+
 ### Cache Management
 ```bash
 # View cache statistics

docs/site/commands/cu.md

@@ -29,6 +29,7 @@ enabling efficient task management and seamless integration with development wor
 * [cu completion](cu_completion.md)	 - Generate shell completion script
 * [cu config](cu_config.md)	 - Manage cu configuration
 * [cu export](cu_export.md)	 - Export data to various formats
+* [cu field](cu_field.md)	 - Manage custom field values
 * [cu interactive](cu_interactive.md)	 - Interactive mode for task management
 * [cu list](cu_list.md)	 - Manage lists
 * [cu me](cu_me.md)	 - Show current user information
@@ -37,4 +38,4 @@ enabling efficient task management and seamless integration with development wor
 * [cu user](cu_user.md)	 - Manage users
 * [cu version](cu_version.md)	 - Show cu version information
 
-###### Auto generated by spf13/cobra on 29-Jun-2025
+###### Auto generated by spf13/cobra on 22-Aug-2026

docs/site/commands/cu_field.md

@@ -0,0 +1,35 @@
+## cu field
+
+Manage custom field values
+
+### Synopsis
+
+Read and write ClickUp custom fields.
+
+Fields are resolved by name (case-insensitive) or by id. Values are coerced to
+the shape each field type expects — epoch milliseconds for dates, option ids
+for dropdowns and labels — so names can be used on the command line.
+
+### Options
+
+```
+  -h, --help   help for field
+```
+
+### Options inherited from parent commands
+
+```
+      --config string   config file (default is $HOME/.config/cu/config.yml)
+      --debug           enable debug mode
+  -o, --output string   output format (table|json|yaml|csv) (default "table")
+```
+
+### SEE ALSO
+
+* [cu](cu.md)	 - A GitHub CLI-inspired command-line interface for ClickUp
+* [cu field clear](cu_field_clear.md)	 - Clear a custom field value on a task
+* [cu field get](cu_field_get.md)	 - Show custom field values on a task
+* [cu field list](cu_field_list.md)	 - List custom fields available on a list
+* [cu field set](cu_field_set.md)	 - Set a custom field value on a task
+
+###### Auto generated by spf13/cobra on 22-Aug-2026

docs/site/commands/cu_field_clear.md

@@ -0,0 +1,27 @@
+## cu field clear
+
+Clear a custom field value on a task
+
+```
+cu field clear <task-id> <field> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for clear
+```
+
+### Options inherited from parent commands
+
+```
+      --config string   config file (default is $HOME/.config/cu/config.yml)
+      --debug           enable debug mode
+  -o, --output string   output format (table|json|yaml|csv) (default "table")
+```
+
+### SEE ALSO
+
+* [cu field](cu_field.md)	 - Manage custom field values
+
+###### Auto generated by spf13/cobra on 22-Aug-2026

docs/site/commands/cu_field_get.md

@@ -0,0 +1,27 @@
+## cu field get
+
+Show custom field values on a task
+
+```
+cu field get <task-id> [field] [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for get
+```
+
+### Options inherited from parent commands
+
+```
+      --config string   config file (default is $HOME/.config/cu/config.yml)
+      --debug           enable debug mode
+  -o, --output string   output format (table|json|yaml|csv) (default "table")
+```
+
+### SEE ALSO
+
+* [cu field](cu_field.md)	 - Manage custom field values
+
+###### Auto generated by spf13/cobra on 22-Aug-2026

docs/site/commands/cu_field_list.md

@@ -0,0 +1,28 @@
+## cu field list
+
+List custom fields available on a list
+
+```
+cu field list [flags]
+```
+
+### Options
+
+```
+  -h, --help          help for list
+  -l, --list string   List ID (defaults to the configured default list)
+```
+
+### Options inherited from parent commands
+
+```
+      --config string   config file (default is $HOME/.config/cu/config.yml)
+      --debug           enable debug mode
+  -o, --output string   output format (table|json|yaml|csv) (default "table")
+```
+
+### SEE ALSO
+
+* [cu field](cu_field.md)	 - Manage custom field values
+
+###### Auto generated by spf13/cobra on 22-Aug-2026

docs/site/commands/cu_field_set.md

@@ -0,0 +1,39 @@
+## cu field set
+
+Set a custom field value on a task
+
+### Synopsis
+
+Set a custom field value on a task.
+
+The field is resolved against the fields accessible from the task's own list,
+so space-level and folder-level fields work the same as list-level ones.
+
+Examples:
+  cu field set 86dxbeqyt Repo git@github.com:owner/repo.git
+  cu field set 86dxbeqyt "Last synced" today
+  cu field set 86dxbeqyt Machine "Chilastra,Sunrunner"
+
+```
+cu field set <task-id> <field> <value> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for set
+```
+
+### Options inherited from parent commands
+
+```
+      --config string   config file (default is $HOME/.config/cu/config.yml)
+      --debug           enable debug mode
+  -o, --output string   output format (table|json|yaml|csv) (default "table")
+```
+
+### SEE ALSO
+
+* [cu field](cu_field.md)	 - Manage custom field values
+
+###### Auto generated by spf13/cobra on 22-Aug-2026

go.mod

@@ -7,6 +7,7 @@ require (
 	github.com/manifoldco/promptui v0.9.0
 	github.com/raksul/go-clickup v0.0.0-20241002105938-60c057c125ff
 	github.com/spf13/cobra v1.9.1
+	github.com/spf13/pflag v1.0.6
 	github.com/spf13/viper v1.20.1
 	github.com/stretchr/testify v1.10.0
 	github.com/zalando/go-keyring v0.2.6
@@ -33,7 +34,6 @@ require (
 	github.com/sourcegraph/conc v0.3.0 // indirect
 	github.com/spf13/afero v1.12.0 // indirect
 	github.com/spf13/cast v1.7.1 // indirect
-	github.com/spf13/pflag v1.0.6 // indirect
 	github.com/subosito/gotenv v1.6.0 // indirect
 	go.uber.org/atomic v1.9.0 // indirect
 	go.uber.org/multierr v1.9.0 // indirect