productiveio/tb-prod

tb-prod

CLI for interacting with the Productive.io API. Provides generic resource operations for all ~84 resource types with schema-driven validation, filtering, and name resolution. Built for AI agent consumption — all resource commands output JSON.

Capabilities

• All resource types — tasks, projects, people, deals, invoices, bookings, services, and 77 more
• Describe — introspect any resource type's schema, fields, filters, actions
• Query — filter, sort, paginate resources with JSON FilterGroup syntax
• CRUD — create, update, delete with client-side validation
• Search — keyword search across resource types
• Actions — custom actions (archive, restore, move, merge, etc.) + extension actions
• Cache — two-tier cache (org-wide + project-scoped) with fuzzy name resolution

Getting started

Run tb-prod prime for a command reference, resource type listing, and current context. Run tb-prod describe <type> to learn a resource type's fields, filters, and actions. Use tb-prod <command> --help for detailed command usage.

Field naming — write keys vs filter keys. A field's create/update key can differ from both its output name and its filter key. describe <type> --include schema shows all three: the Fields table lists the output name and marks the create/update key as [write:NAME] when it differs (e.g. closed → is_closed); the Filters table lists the query keys (e.g. relationship task filters as task_id). Relationship values in create/update are flat ID strings ("task": "123"), never the {"id","type"} object shape from responses.

Live context

!tb-prod prime