288 commands, one registry.

telos customer list

List customers

• --status? — Customer status filter
• --ownerId? — Owner (DRI) user UUID filter; pair with whoami to list your own accounts
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer get <id>

Get a customer

telos customer create

Create a customer

• --name
• --logoUrl?
• --website?
• --content?
• --status?
• --ownerId?
• --arr?
• --customerSince?
• --idempotency-key? — Stable retry key for this mutation

telos customer update <id>

Update a customer

• --name?
• --logoUrl?
• --logoFileId?
• --website?
• --content?
• --status?
• --health?
• --ownerId?
• --arr?
• --customerSince?
• --reason?
• --idempotency-key? — Stable retry key for this mutation

telos customer delete <id>

Delete a customer

• --idempotency-key? — Stable retry key for this mutation

telos customer contacts <id>

List a customer's contacts

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer create-contact <id>

Add a contact to a customer

• --name
• --title?
• --role?
• --email?
• --phone?
• --notes?
• --isPrimary? — Make this the account's primary contact
• --idempotency-key? — Stable retry key for this mutation

telos customer update-contact <id> <contactId>

Update a customer contact

• --name?
• --title?
• --role?
• --email?
• --phone?
• --notes?
• --isPrimary? — Make this the account's primary contact
• --idempotency-key? — Stable retry key for this mutation

telos customer delete-contact <id> <contactId>

Delete a customer contact

• --idempotency-key? — Stable retry key for this mutation

telos customer opportunities <id>

List a customer's linked opportunities

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer link-opportunity <id>

Link an opportunity to a customer

• --opportunityId — Opportunity UUID
• --stepInstanceId?
• --idempotency-key? — Stable retry key for this mutation

telos customer unlink-opportunity <id> <opportunityId>

Unlink an opportunity from a customer

• --idempotency-key? — Stable retry key for this mutation

telos customer updates <id>

List a customer's update feed

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer post-update <id>

Post a customer update

• --body — The update text
• --idempotency-key? — Stable retry key for this mutation

telos customer commitments

List every dated client promise

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer arr <id>

List a customer's ARR history

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer add-arr-point <id>

Record an ARR level for a customer

• --at — The date the level took effect
• --arr — ARR level from that date
• --note? — Why it changed
• --idempotency-key? — Stable retry key for this mutation

telos customer delete-arr-point <id> <arrPointId>

Delete an ARR history point

• --idempotency-key? — Stable retry key for this mutation

telos customer arr-summary

Org-wide ARR roll-up and movement

• --months?

telos customer reviews <id>

List a customer's stored reviews

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos customer review <id> <reviewId>

Get a stored customer review

telos customer generate-review <id>

Generate a customer review

• --from — Window start; the window ends now
• --idempotency-key? — Stable retry key for this mutation

telos customer onboarding <id>

Get a customer's onboarding state

telos customer set-onboarding <id>

Start or swap a customer's onboarding template

• --templateId? — Onboarding template UUID; defaults to the org's customer default
• --idempotency-key? — Stable retry key for this mutation

telos customer advance-onboarding <id>

Move a customer to another onboarding milestone

• --stepInstanceId?
• --stepId? — Template step UUID, resolved to this customer's milestone
• --message? — Handoff note
• --markComplete? — Mark the milestone being left as completed
• --idempotency-key? — Stable retry key for this mutation

telos customer complete-onboarding <id>

Complete a customer's onboarding and take the account live

• --message? — Go-live note
• --idempotency-key? — Stable retry key for this mutation

telos customer update-onboarding-step <id> <stepInstanceId>

Update one of a customer's onboarding milestones

• --driUserId? — New DRI user UUID
• --arrUnlock? — ARR unlocked when the milestone completes; null clears it
• --taskId? — Existing task to attach to this milestone
• --idempotency-key? — Stable retry key for this mutation

telos customer add-onboarding-work <id> <stepInstanceId>

Create work on a customer's onboarding milestone

• --kind — Bespoke client work, or a product opportunity
• --title — Work item title
• --idempotency-key? — Stable retry key for this mutation

telos strategy list

List strategies

• --status? — Strategy status filter
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos strategy get <id>

Get a strategy

telos strategy create

Create a strategy

• --name
• --content?
• --status?
• --idempotency-key? — Stable retry key for this mutation

telos strategy update <id>

Update a strategy

• --name?
• --content?
• --changeNote?
• --idempotency-key? — Stable retry key for this mutation

telos strategy publish <id>

Publish a strategy

• --idempotency-key? — Stable retry key for this mutation

telos strategy archive <id>

Archive a strategy

• --idempotency-key? — Stable retry key for this mutation

telos strategy versions <id>

List a strategy's version history

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos strategy rename-version <id> <version>

Rename a strategy version

• --note — Version label; empty clears it
• --idempotency-key? — Stable retry key for this mutation

telos vision list

List visions

• --kind? — Vision kind filter
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos vision get <id>

Get a vision

telos vision create

Create a vision

• --name
• --kind?
• --narrative
• --idempotency-key? — Stable retry key for this mutation

telos vision update <id>

Update a vision

• --name?
• --narrative?
• --idempotency-key? — Stable retry key for this mutation

telos vision versions <id>

List a vision's version history

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos vision objectives <id>

List objectives for a vision

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos vision children <id>

Count a vision's children

telos vision rename-version <id> <version>

Rename a vision version

• --note — Version label; empty clears it
• --idempotency-key? — Stable retry key for this mutation

telos metric list

List metrics

• --stewardId? — Steward user UUID filter
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos metric get <id>

Get a metric

telos metric create

Create a metric

• --name
• --description?
• --currentValue? — Starting value
• --unit
• --dataSourceType?
• --dataSourceConfig?
• --stewardId?
• --idempotency-key? — Stable retry key for this mutation

telos metric update <id>

Update a metric

• --name?
• --description?
• --currentValue? — Latest value
• --unit?
• --dataSourceType?
• --dataSourceConfig?
• --stewardId?
• --idempotency-key? — Stable retry key for this mutation

telos metric delete <id>

Delete a metric

• --idempotency-key? — Stable retry key for this mutation

telos metric values <id>

List metric values

• --since? — Only values recorded at or after this time
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos metric record-value <id>

Record a metric value

• --value — Observed value
• --recordedAt?
• --note?
• --source?
• --idempotency-key? — Stable retry key for this mutation

telos metric list-builtins

List built-in metrics Telos can track

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos metric track-builtin

Start tracking a built-in metric

• --key — Catalog key, from list-builtins
• --categoryId? — Scope to one task category
• --statusType? — Status group to measure (required for time_in_status_days)
• --userId? — Scope a GitHub builtin to one engineer's mapped logins
• --idempotency-key? — Stable retry key for this mutation

telos metric opportunities <id>

Get the opportunities betting on a metric

telos metric dependents <id>

Count what depends on a metric

telos objective list

List objectives

• --visionId? — Vision UUID filter
• --metricId? — Anchor metric UUID filter
• --driId? — DRI user UUID filter
• --status? — Objective status filter. One of: active, achieved, abandoned
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos objective get <id>

Get an objective

telos objective create

Create an objective

• --title
• --description?
• --deadline?
• --visionId
• --driId
• --horizon?
• --metric?
• --idempotency-key? — Stable retry key for this mutation

telos objective update <id>

Update an objective

• --visionId?
• --title?
• --description?
• --deadline?
• --driId?
• --horizon?
• --status?
• --idempotency-key? — Stable retry key for this mutation

telos objective delete <id>

Delete an objective

• --idempotency-key? — Stable retry key for this mutation

telos objective opportunities <id>

Get the opportunities linked to an objective

telos objective set-metric <id>

Set an objective's metric

• --metricId — Metric UUID to anchor to; null clears the anchor
• --operator? — Comparison operator. One of: gte, lte, eq
• --target? — Target value on the metric
• --startValue? — Value the objective started from; null clears it
• --idempotency-key? — Stable retry key for this mutation

telos objective alignment

Read the alignment grid

telos objective nesting <id>

Get an objective's parent and sub-objectives

telos objective set-alignment-link <id>

Point an objective or opportunity at an objective

• --sourceType — What is doing the serving
• --sourceId — Objective or opportunity UUID
• --kind — How hard the source pushes. One of: primary, supporting; null clears the link
• --idempotency-key? — Stable retry key for this mutation

telos objective claims <id>

Get the customer claims on an objective

telos opportunity list

List opportunities

• --state? — Opportunity lifecycle state filter
• --teamId? — Team UUID filter
• --leadUserId? — Lead UUID filter. Pass your own user id (whoami) for 'my opportunities'
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos opportunity get <id>

Get an opportunity

telos opportunity create

Create an opportunity

• --title
• --description?
• --leadId?
• --teamId?
• --templateId?
• --initialState?
• --categoryId?
• --objectiveLinks?
• --tagIds?
• --scores?
• --dueDate?
• --prdTemplateId?
• --patternPromotion?
• --idempotency-key? — Stable retry key for this mutation

telos opportunity update <id>

Update an opportunity

• --title?
• --leadId?
• --teamId?
• --categoryId?
• --dueDate?
• --prd?
• --tagIds? — Replace the opportunity's whole tag set; omit to leave tags alone
• --idempotency-key? — Stable retry key for this mutation

telos opportunity delete <id>

Delete an opportunity

• --idempotency-key? — Stable retry key for this mutation

telos opportunity tasks <id>

List tasks attached to an opportunity

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos opportunity context <ref>

Get an opportunity's full context bundle

telos opportunity scorecard <id>

Get an opportunity's scorecard

telos opportunity score <id> <criterionId>

Set a scorecard value

• --value — Score value on the 1-5 scale
• --idempotency-key? — Stable retry key for this mutation

telos opportunity clear-score <id> <criterionId>

Clear a scorecard value

• --idempotency-key? — Stable retry key for this mutation

telos opportunity link-objective <id>

Link an objective to an opportunity

• --objectiveId
• --idempotency-key? — Stable retry key for this mutation

telos opportunity update-objective-link <id> <objectiveId>

Update an objective link

• --newObjectiveId — Objective the link should point at instead
• --idempotency-key? — Stable retry key for this mutation

telos opportunity unlink-objective <id> <objectiveId>

Unlink an objective from an opportunity

• --idempotency-key? — Stable retry key for this mutation

telos opportunity reject-via-template <id>

Reject an opportunity and skip remaining template steps

• --category
• --reason
• --idempotency-key? — Stable retry key for this mutation

telos opportunity updates <id>

List an opportunity's status updates

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos opportunity post-update <id>

Post an opportunity status update

• --body — The update text
• --idempotency-key? — Stable retry key for this mutation

telos opportunity set-state <id>

Set an opportunity's lifecycle state

• --state — Target lifecycle state. One of: backlog, in_progress, completed
• --idempotency-key? — Stable retry key for this mutation

telos opportunity add-prototype <id>

Add a prototype to an opportunity

• --url?
• --fileId?
• --title
• --idempotency-key? — Stable retry key for this mutation

telos opportunity remove-prototype <id>

Remove a prototype link from an opportunity

• --url
• --idempotency-key? — Stable retry key for this mutation

telos opportunity synthesize <id>

Draft a PRD from the opportunity's evidence

• --bypassCache? — Ignore the cached draft and re-run the model
• --idempotency-key? — Stable retry key for this mutation

telos opportunity risks <id>

List an opportunity's validation risks and votes

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos opportunity cast-risk-vote <id> <risk>

Vote on one of an opportunity's validation risks

• --vote
• --note
• --idempotency-key? — Stable retry key for this mutation

telos opportunity apply-prd-template <id>

Apply a PRD template to an opportunity

• --templateId
• --mode
• --idempotency-key? — Stable retry key for this mutation

telos opportunity scoring-criteria

List the org's scoring criteria

• --includeArchived? — Include archived criteria (kept for historical scores)
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos opportunity phases <id>

List an opportunity's delivery phases

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos opportunity unphased-task-count <id>

Count an opportunity's unphased work

telos opportunity phase-handoff <fromPhaseId>

Write the handoff note out of a finished phase

• --note — What the next owner needs to know
• --idempotency-key? — Stable retry key for this mutation

telos opportunity add-phase <id>

Add a delivery phase to an opportunity

• --title
• --targetDate?
• --ownerUserId?
• --idempotency-key? — Stable retry key for this mutation

telos opportunity update-phase <phaseId>

Rename, re-date or re-own a phase

• --title?
• --targetDate?
• --ownerUserId?
• --idempotency-key? — Stable retry key for this mutation

telos opportunity remove-phase <phaseId>

Remove a phase

• --idempotency-key? — Stable retry key for this mutation

telos opportunity reorder-phases <id>

Reorder an opportunity's phases

• --orderedIds
• --idempotency-key? — Stable retry key for this mutation

telos task planned-work-summary

Summarise planned work

• --teamIds? — Telos team UUIDs to scope the read to; omit for every team
• --cycleId? — Cycle UUID as the planning window
• --start? — Planning window start (YYYY-MM-DD)
• --end? — Planning window end, exclusive (YYYY-MM-DD)

telos task planned-work-gaps

Get planned work gaps

• --teamIds? — Telos team UUIDs to scope the read to; omit for every team
• --cycleId? — Cycle UUID as the planning window
• --start? — Planning window start (YYYY-MM-DD)
• --end? — Planning window end, exclusive (YYYY-MM-DD)

telos task list-statuses

List task statuses

• --includeArchived?
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos task create-status

Create a task status

• --type
• --name
• --color
• --description?
• --idempotency-key? — Stable retry key for this mutation

telos task update-status <id>

Update a task status

• --name?
• --color?
• --description?
• --idempotency-key? — Stable retry key for this mutation

telos task reorder-status

Reorder a task status

• --id
• --afterId?
• --beforeId?
• --idempotency-key? — Stable retry key for this mutation

telos task archive-status <id>

Archive a task status

• --replacementStatusId?
• --idempotency-key? — Stable retry key for this mutation

telos task restore-status <id>

Restore a task status

• --idempotency-key? — Stable retry key for this mutation

telos task list

List tasks

• --opportunityId? — Opportunity UUID filter
• --status? — Task status filter
• --statusId? — Concrete workspace status UUID filter
• --priority? — Task priority filter
• --teamId? — Team UUID filter
• --ownerUserId? — Owner UUID filter. Pass your own user id (whoami) for 'my assignments'
• --noCycle? — Only work bound to no cycle: the pool a cycle is planned from
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos task get <id>

Get a task

telos task create

Create a task

• --title
• --description?
• --content?
• --status?
• --statusId?
• --priority?
• --opportunityId?
• --phaseId?
• --teamId?
• --ownerId?
• --categoryId?
• --parentTaskId?
• --subtaskPosition? — Position among the parent's subtasks
• --subtasks?
• --templateId?
• --onboardingStepInstanceId?
• --estimateMinutes? — Estimate in minutes
• --estimateUnit?
• --dueDate?
• --tagIds?
• --patternPromotion?
• --confirmedRepo? — Repository to dispatch an agent owner against, when prompted
• --idempotency-key? — Stable retry key for this mutation

telos task update <id>

Update a task

• --title?
• --description?
• --content?
• --status?
• --statusId?
• --priority?
• --opportunityId?
• --phaseId?
• --teamId?
• --templateId?
• --categoryId?
• --estimateMinutes? — Estimate in minutes; null clears it
• --estimateUnit?
• --dueDate?
• --tagIds? — Replace the task's whole tag set; omit to leave tags alone
• --idempotency-key? — Stable retry key for this mutation

telos task post-update <id>

Post a development update

• --body
• --idempotency-key? — Stable retry key for this mutation

telos task updates <id>

List development updates

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos task delete <id>

Delete a task

• --idempotency-key? — Stable retry key for this mutation

telos task set-status <id>

Set a task's status

• --status
• --statusId?
• --idempotency-key? — Stable retry key for this mutation

telos task set-owner <id>

Set a task's owner

• --ownerUserId — New owner's user UUID, or null to leave the task unassigned
• --confirmedRepo? — Repository to dispatch an agent owner against, when prompted
• --idempotency-key? — Stable retry key for this mutation

telos task assign-cycle <id>

Preview assigning a task to a cycle

• --cycleId — Cycle UUID
• --idempotency-key? — Stable retry key for this mutation

telos task move-cycle <id>

Move a task into a cycle

• --cycleId — Cycle UUID to move the task into
• --acknowledgedBreaks? — The {taskId, insightId} pairs a prior PROMISE_BREAKS refusal returned
• --announceToCustomers? — Post the schedule change to each acknowledged customer's activity log
• --idempotency-key? — Stable retry key for this mutation

telos task count-by-status

Count tasks per lifecycle status

• --opportunityId? — Opportunity UUID filter
• --priority? — Task priority filter
• --teamId? — Team UUID filter
• --ownerUserId? — Owner UUID filter

telos task attach-session <ref>

Pin a coding session to a task

• --provider — Session provider slug, e.g. "claude-code"
• --sessionId — The provider's session id
• --model? — Model id used in the session
• --inputTokens? — Session input-token total
• --outputTokens? — Session output-token total
• --costCents? — Estimated session cost, cents
• --idempotency-key? — Stable retry key for this mutation

telos task time-in-status <id>

Time a task has spent in each status

telos task context <ref>

Get a task's full context bundle

telos task list-recurring

List recurring tasks

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos task get-recurring <id>

Get a recurring task

telos task create-recurring

Create a recurring task

• --name — Label for the recurring-task definition (not the task title)
• --teamId — Team the generated tasks belong to
• --rrule — iCal RRULE string, e.g. 'FREQ=WEEKLY;BYDAY=MO' or 'FREQ=MONTHLY;BYMONTHDAY=1'
• --dtstart? — Recurrence start (ISO 8601). Defaults to now
• --tzid? — IANA timezone the cadence reads in. Defaults to UTC
• --active? — Start the definition running
• --title
• --description?
• --content?
• --priority?
• --ownerUserId — Required. Owns every task this definition generates.
• --categoryId?
• --templateId?
• --estimateMinutes? — Estimate in minutes on each generated task
• --tagIds?
• --dueOffsetDays? — Days after the occurrence the generated task is due
• --idempotency-key? — Stable retry key for this mutation

telos task update-recurring <id>

Update a recurring task

• --name?
• --teamId?
• --rrule?
• --dtstart?
• --tzid?
• --active? — true resumes, false pauses
• --title?
• --description?
• --content?
• --priority?
• --ownerUserId?
• --categoryId?
• --templateId?
• --estimateMinutes? — Estimate in minutes on each generated task
• --tagIds?
• --dueOffsetDays? — Days after the occurrence the generated task is due
• --idempotency-key? — Stable retry key for this mutation

telos task set-recurring-active <id>

Pause or resume a recurring task

• --active — true to resume, false to pause
• --idempotency-key? — Stable retry key for this mutation

telos task delete-recurring <id>

Delete a recurring task

• --idempotency-key? — Stable retry key for this mutation

telos task external-links

Get a work item's external links and blockers

• --entityType — Work item type the link hangs off
• --entityId — Work item UUID

telos task block-on-external

Flag work as waiting on someone outside the team

• --itemKind — Work item type the blocker hangs off
• --itemId — Work item UUID
• --awaiting — Who the work is waiting on
• --contactId? — Customer contact UUID being waited on
• --note? — Why the work is waiting
• --idempotency-key? — Stable retry key for this mutation

telos task resolve-external-block <blockerId>

Resolve an external blocker

• --idempotency-key? — Stable retry key for this mutation

telos task link-message

Link a work item back to the chat message it came from

• --entityType — Work item type the link hangs off
• --entityId — Work item UUID
• --messageId — Source message UUID
• --idempotency-key? — Stable retry key for this mutation

telos task agent-runs

List coding-agent runs

• --taskId? — List one task's runs
• --integrationId? — List one integration's runs
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos task cancel-agent-run <id>

Cancel a coding-agent run

• --idempotency-key? — Stable retry key for this mutation

telos team list

List teams

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos team get <id>

Get a team

telos team create

Create a team

• --name
• --description?
• --prefix?
• --idempotency-key? — Stable retry key for this mutation

telos team update <id>

Update a team

• --name?
• --description?
• --defaultPrdTemplateId?
• --prefix?
• --idempotency-key? — Stable retry key for this mutation

telos team delete <id>

Delete a team

• --idempotency-key? — Stable retry key for this mutation

telos team members <id>

List team members

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos team add-member <id>

Add a team member

• --userId
• --idempotency-key? — Stable retry key for this mutation

telos team remove-member <id> <userId>

Remove a team member

• --idempotency-key? — Stable retry key for this mutation

telos team ownership-config

List team ownership config

• --teamId? — Only this team's row
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos user list

List users

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos user get <id>

Get a user

telos user update <id>

Update a user

• --name?
• --salaryMonthly? — Monthly salary; travels with salaryCurrency
• --salaryCurrency?
• --weeklyHours? — Contracted hours per week (1-80)
• --role?
• --orgRoleId?
• --idempotency-key? — Stable retry key for this mutation

telos tag list

List tags

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos tag create

Create a tag

• --name
• --themeId?
• --color?
• --idempotency-key? — Stable retry key for this mutation

telos tag update <id>

Update a tag

• --name?
• --color?
• --idempotency-key? — Stable retry key for this mutation

telos tag delete <id>

Delete a tag

• --idempotency-key? — Stable retry key for this mutation

telos tag list-themes

List tag themes

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos tag create-theme

Create a tag theme

• --name
• --color?
• --idempotency-key? — Stable retry key for this mutation

telos tag update-theme <id>

Update a tag theme

• --name?
• --color?
• --idempotency-key? — Stable retry key for this mutation

telos tag delete-theme <id>

Delete a tag theme

• --idempotency-key? — Stable retry key for this mutation

telos comment list

List comments

• --entityType? — Entity the comments hang off (with entityId)
• --entityId? — Entity UUID (with entityType)
• --parentId? — Read this top-level comment's thread replies instead
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos comment create

Post a comment

• --entityType
• --entityId
• --body
• --kind?
• --idempotency-key? — Stable retry key for this mutation

telos comment update <id>

Edit a comment

• --body
• --idempotency-key? — Stable retry key for this mutation

telos comment delete <id>

Delete a comment

• --idempotency-key? — Stable retry key for this mutation

telos comment set-reaction <id>

Add or remove your reaction to a comment

• --emoji — Emoji to react with
• --on — true adds your reaction, false removes it
• --idempotency-key? — Stable retry key for this mutation

telos insight list

List insights

• --status? — Insight lifecycle status filter
• --customerId? — Customer UUID filter
• --opportunityId? — Only insights linked to this opportunity
• --taskId? — Only insights linked to this task
• --objectiveId? — Only insights linked to this objective
• --reviewTeamId? — Only insights routed to this team's review queue
• --recordedByUserId? — Only insights recorded by this user (whoami for your own)
• --tagId? — Only insights carrying this tag
• --search? — Full-text match on the verbatim
• --includeArchived? — Include archived insights (default false)
• --reviewQueue? — Your own review queue: insights routed to teams you are the insight reviewer for, plus your own insights sent back for context. Replaces the other filters when set.
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos insight get <id>

Get an insight

telos insight create

Create an insight

• --customerId?
• --stakeholderUserId?
• --externalStakeholderId?
• --contactId?
• --verbatim
• --source
• --moscow?
• --deadline?
• --reviewTeamId?
• --attachToOpportunityId?
• --attachToTaskId?
• --attachToObjectiveId?
• --pinned? — Pin the link created by attachToOpportunityId
• --tagIds?
• --idempotency-key? — Stable retry key for this mutation

telos insight update <id>

Update an insight

• --verbatim?
• --source?
• --customerId?
• --stakeholderUserId?
• --externalStakeholderId?
• --contactId?
• --moscow?
• --deadline?
• --idempotency-key? — Stable retry key for this mutation

telos insight delete <id>

Delete an insight

• --idempotency-key? — Stable retry key for this mutation

telos insight attach <id>

Attach an insight

• --entityType
• --entityId
• --pinned? — Pin the new link
• --idempotency-key? — Stable retry key for this mutation

telos insight detach <id>

Detach an insight

• --entityType
• --entityId
• --idempotency-key? — Stable retry key for this mutation

telos insight set-link <id>

Set the flags on an insight's link

• --entityType — The linked entity's kind
• --entityId — The linked entity's UUID
• --pinned? — Pin or unpin the link
• --blocking? — Flag or unflag the link as blocking (opportunity/task only)
• --idempotency-key? — Stable retry key for this mutation

telos insight set-status <id>

Set an insight's review outcome

• --status — Destination review outcome
• --note? — Why: the rejection reason, the context question, or a free note on any other transition
• --rejectionCategory? — Required when status is rejected
• --idempotency-key? — Stable retry key for this mutation

telos insight set-review-team <id>

Route an insight to a team's review queue

• --reviewTeamId — Team UUID to route to, or null to clear the review team
• --idempotency-key? — Stable retry key for this mutation

telos insight set-tags <id>

Set an insight's tags

• --tagIds — The complete tag set for this insight; replaces what is there
• --idempotency-key? — Stable retry key for this mutation

telos insight set-impact <id>

Set an insight's objective impacts

• --impacts — The complete impact set; replaces what is there
• --idempotency-key? — Stable retry key for this mutation

telos insight blocking

List the insights blocking a work item

• --itemKind — The work item's kind
• --itemId — The work item's UUID
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos insight similar <id>

Find near-duplicate insights and past rejections

telos insight patterns

Read the insight pattern board

telos insight accept-pattern <patternId>

Accept an insight pattern (deprecated)

• --idempotency-key? — Stable retry key for this mutation

telos insight dismiss-pattern <patternId>

Dismiss an insight pattern

• --idempotency-key? — Stable retry key for this mutation

telos insight attach-pattern-work <patternId>

Attach a pattern to existing work

• --entityType
• --entityId
• --idempotency-key? — Stable retry key for this mutation

telos insight link-pattern-insights <patternId>

Link new pattern insights

• --workItemIds — Pattern-work association UUIDs
• --insightIds — Selected current pattern insight UUIDs
• --idempotency-key? — Stable retry key for this mutation

telos insight list-external-stakeholders

List other stakeholders

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos insight create-external-stakeholder

Create an other stakeholder

• --name
• --idempotency-key? — Stable retry key for this mutation

telos prd-template list

List PRD templates

• --allTeams? — Return every template in the org, including other teams' (requires prd_template:update)
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos prd-template get <id>

Get a PRD template

telos prd-template create

Create a PRD template

• --name
• --content
• --teamId?
• --idempotency-key? — Stable retry key for this mutation

telos prd-template update <id>

Update a PRD template

• --name?
• --content?
• --teamId?
• --idempotency-key? — Stable retry key for this mutation

telos prd-template delete <id>

Delete a PRD template

• --idempotency-key? — Stable retry key for this mutation

telos webhook list

List webhook subscriptions

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos webhook create

Create a webhook subscription

• --url
• --secret
• --eventTypes
• --description?
• --idempotency-key? — Stable retry key for this mutation

telos webhook update <id>

Update a webhook subscription

• --url?
• --eventTypes?
• --description?
• --active? — false pauses deliveries, true resumes them
• --idempotency-key? — Stable retry key for this mutation

telos webhook test <id>

Send a test event to a webhook subscription

• --idempotency-key? — Stable retry key for this mutation

telos webhook delete <id>

Delete a webhook subscription

• --idempotency-key? — Stable retry key for this mutation

telos template list

List templates

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos template get <id>

Get a template

telos template create

Create a template

• --name
• --description?
• --defaultEntityType?
• --idempotency-key? — Stable retry key for this mutation

telos template update <id>

Update a template

• --name?
• --description?
• --defaultEntityType?
• --idempotency-key? — Stable retry key for this mutation

telos template delete <id>

Delete a template

• --idempotency-key? — Stable retry key for this mutation

telos template create-step <id>

Add a template step

• --title
• --description?
• --defaultDriRole?
• --defaultDriUserId?
• --slaTargetHours? — Hours the step is expected to take
• --idempotency-key? — Stable retry key for this mutation

telos template update-step <stepId>

Update a template step

• --position? — New position among the template's real steps
• --title?
• --description?
• --defaultDriRole?
• --defaultDriUserId?
• --slaTargetHours? — Hours the step is expected to take; null clears it
• --idempotency-key? — Stable retry key for this mutation

telos template delete-step <stepId>

Delete a template step

• --idempotency-key? — Stable retry key for this mutation

telos template handoff

Write a template handoff

• --targetStepInstanceId
• --markComplete? — Complete the steps being skipped past
• --message?
• --mentions?
• --mentionLinkUrl?
• --idempotency-key? — Stable retry key for this mutation

telos template usage <id>

List active work using a template

telos template default <entityType>

Get the org's default template for an entity type

telos template reassign-and-delete <id>

Move every entity to another template, then delete this one

• --replaceWithTemplateId — Template the reassigned work moves onto
• --idempotency-key? — Stable retry key for this mutation

telos template instance <entityType> <entityId>

Read the template running on an entity

telos template attach

Start a template on an entity

• --entityType
• --entityId
• --templateId
• --activateFirstStep? — false seeds every step pending
• --idempotency-key? — Stable retry key for this mutation

telos template swap

Move an entity onto a different template

• --entityType
• --entityId
• --newTemplateId
• --activateFirstStep? — false seeds every step pending
• --idempotency-key? — Stable retry key for this mutation

telos template update-instance-step <stepInstanceId>

Advance or reassign a running step

• --status?
• --driUserId?
• --idempotency-key? — Stable retry key for this mutation

telos category list

List categories

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos category get <id>

Get a category

telos category create

Create a category

• --label
• --color
• --sortOrder? — Display position among the org's categories
• --idempotency-key? — Stable retry key for this mutation

telos category update <id>

Update a category

• --label?
• --color?
• --sortOrder? — Display position among the org's categories
• --idempotency-key? — Stable retry key for this mutation

telos category delete <id>

Delete a category

• --idempotency-key? — Stable retry key for this mutation

telos notification list

List notifications

• --unreadOnly? — Only return unread notifications
• --pinnedOnly? — Only return pinned notifications
• --types? — Only return these notification types. JSON array on MCP, comma-separated on REST and CLI. One of: strategy.published, strategy.updated, vision.published, customer.update_posted, customer.went_live, insight.assigned, insight.needs_context, insight.rejected, opportunity.completed, opportunity.cancelled, objective.committed_date_breach, cycle.scope_changed, template.step_assigned, task.handoff, task.agent_run_completed, task.agent_run_failed, task.agent_run_cancelled, comment.mention, comment.thread_reply, doc.mention, room.invited, room.mentioned, community.mentioned, good_vibes.shoutout
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos notification unread-count

Get unread notification count

telos notification mark-read <id>

Mark a notification read

• --idempotency-key? — Stable retry key for this mutation

telos notification mark-all-read

Mark all notifications read

• --idempotency-key? — Stable retry key for this mutation

telos notification pin <id>

Pin a notification

• --idempotency-key? — Stable retry key for this mutation

telos notification unpin <id>

Unpin a notification

• --idempotency-key? — Stable retry key for this mutation

telos notification unsubscribe <id>

Unsubscribe at notification source

• --idempotency-key? — Stable retry key for this mutation

telos time-entry list

List time entries

• --from — Range start (YYYY-MM-DD, inclusive)
• --to — Range end (YYYY-MM-DD, inclusive; max 366 days after from)
• --engineerId? — Another engineer's user UUID; requires compensation:read
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos time-entry create

Log a time entry

• --entryDate
• --opportunityId?
• --taskId?
• --miscCategoryId?
• --hours — Hours worked, 0-24 per entry
• --note?
• --idempotency-key? — Stable retry key for this mutation

telos time-entry update <id>

Update a time entry

• --entryDate?
• --hours?
• --note?
• --idempotency-key? — Stable retry key for this mutation

telos time-entry delete <id>

Delete a time entry

• --idempotency-key? — Stable retry key for this mutation

telos time-entry aggregate-by-category

Aggregate time by category

• --from — Range start (YYYY-MM-DD, inclusive)
• --to — Range end (YYYY-MM-DD, inclusive; max 366 days after from)
• --teamId? — Restrict to one team's members

telos time-entry costs-for-range

Get every engineer's costed time in a date range

• --from — Range start (YYYY-MM-DD, inclusive)
• --to — Range end (YYYY-MM-DD, inclusive; max 366 days after from)
• --teamId? — Restrict to one team's members

telos time-entry actual-cost-for-opportunity <opportunityId>

Actual labor cost of an opportunity

telos time-entry actual-cost-for-task <taskId>

Actual labor cost of a task

telos time-entry upsert-range

Replace a timesheet window

• --from — Range start (YYYY-MM-DD, inclusive)
• --to — Range end (YYYY-MM-DD, inclusive; max 366 days after from)
• --rows — The complete set of entries for the window
• --idempotency-key? — Stable retry key for this mutation

telos time-entry list-for-opportunity <opportunityId>

List an opportunity's time entries

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos room list

List rooms

• --scope? — 'mine' (default) for your rooms, 'open' for joinable open channels
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos room get <id>

Get a room

telos room create

Create a group channel

• --name
• --description?
• --memberIds
• --visibility?
• --idempotency-key? — Stable retry key for this mutation

telos room update <id>

Update a group channel

• --name?
• --description?
• --idempotency-key? — Stable retry key for this mutation

telos room archive <id>

Archive a group channel

• --idempotency-key? — Stable retry key for this mutation

telos room find-or-create-dm

Open a DM with an org member

• --otherUserId — Org member to open the DM with
• --idempotency-key? — Stable retry key for this mutation

telos room members <id>

List a room's members

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos room add-member <id>

Add a member to a group channel

• --userId — Org member to add
• --idempotency-key? — Stable retry key for this mutation

telos room remove-member <id> <userId>

Remove a member from a group channel

• --idempotency-key? — Stable retry key for this mutation

telos room set-membership <id>

Set your own membership state in a room

• --joined? — true joins an open group channel, false leaves it
• --pinned? — Pin the room to the top of your list
• --notificationLevel? — How much the room notifies you: all, mentions, muted
• --idempotency-key? — Stable retry key for this mutation

telos message list

List a room's messages

• --roomId — Room UUID
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos message thread <id>

List a message's thread replies

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos message pinned

List pinned messages

• --roomId? — Scope to a single room
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos message search

Search messages

• --q? — Text to find in message bodies (min 2 chars to match on its own)
• --roomId? — Scope to a single room
• --fromUserId? — Only messages by this author
• --toUserId? — Only messages in the DM with this user
• --fromDate? — Only messages at or after this time
• --toDate? — Only messages at or before this time

telos message create

Post a message

• --roomId — Room UUID
• --body — Message body (markdown, max 10000 chars)
• --parentId? — Top-level message UUID to reply to in its thread
• --idempotency-key? — Stable retry key for this mutation

telos message update <id>

Update a message

• --body — Message body (markdown, max 10000 chars)
• --idempotency-key? — Stable retry key for this mutation

telos message delete <id>

Delete a message

• --idempotency-key? — Stable retry key for this mutation

telos message set-pinned <id>

Pin or unpin a message

• --pinned — true pins the message, false unpins it
• --idempotency-key? — Stable retry key for this mutation

telos message set-reaction <id>

Add or remove your reaction to a message

• --emoji — Emoji to react with
• --on — true adds your reaction, false removes it
• --idempotency-key? — Stable retry key for this mutation

telos activity list

List an entity's activity

• --entityType — Entity type. One of: opportunity, task, customer, insight
• --entityId — Entity UUID
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos file list

List file metadata

• --entityType? — Attachment target entity type; requires entityId
• --entityId? — Attachment target UUID; requires entityType
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos file get <id>

Get a file's metadata and download URL

telos file storage-usage

Get the org's storage usage

telos file request-upload

Request a presigned file upload

• --filename
• --mimeType
• --size — Byte length of the file you are about to upload
• --sha256
• --entityType?
• --entityId?
• --idempotency-key? — Stable retry key for this mutation

telos file confirm-upload <id>

Confirm a completed file upload

• --etag
• --idempotency-key? — Stable retry key for this mutation

telos file attach <id>

Attach a file to an entity

• --entityType
• --entityId
• --idempotency-key? — Stable retry key for this mutation

telos file detach <id>

Detach a file from an entity

• --entityType
• --entityId
• --idempotency-key? — Stable retry key for this mutation

telos file delete <id>

Delete a file

• --idempotency-key? — Stable retry key for this mutation

telos import list

List import runs

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos import get <id>

Get an import run

telos integration list

List integrations

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos integration get <id>

Get an integration

telos integration events <id>

List an integration's delivery log

• --status?
• --kind?
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos role list

List roles

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos search global

Search across the workspace

• --q — Search text; at least 2 characters
• --perTypeLimit? — Max results per entity type, 1-20 (default 8)

telos subscription status

Check whether you follow an entity

• --entityType — Entity to follow. One of: opportunity, task, comment, customer, customer_update, customer_document, insight, vision, strategy, objective, metric, team, template, opportunity_risk, file
• --entityId — Entity UUID

telos subscription set

Follow or unfollow an entity

• --entityType — Entity to follow. One of: opportunity, task, comment, customer, customer_update, customer_document, insight, vision, strategy, objective, metric, team, template, opportunity_risk, file
• --entityId — Entity UUID
• --subscribed — true follows the entity, false mutes it
• --idempotency-key? — Stable retry key for this mutation

telos viewer me

Get the authenticated caller

telos viewer set-avatar

Set the caller's own avatar

• --avatarFileId — File UUID from confirm-file-upload
• --idempotency-key? — Stable retry key for this mutation

telos cycle list

List cycles

• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos cycle get <id>

Get a cycle

telos cycle grids

List the cycle grids

telos cycle list-with-stats

List one grid's cycles with delivery stats

• --teamId? — Team UUID of the grid to read; omit for the organisation grid
• --cursor? — Pagination cursor from a previous page
• --limit? — Items per page

telos cycle get-by-number <grid> <number>

Get a cycle by grid and number

telos cycle burnup <id>

Get a cycle's burnup series

telos cycle breakdown <id>

Break a cycle's work down by owner, priority and team

telos cycle options

Search cycles for a picker

• --q? — Match against the cycle name or number
• --limit? — Window size (default 100, max 100)

telos cycle impact-candidates

List the cycles work can still be assigned to

• --teamId? — Narrow to one team's grid; null (the literal string "null" on a query string or CLI flag) for work with no effective team, omit for every enabled grid
• --limit? — Window size (default 100, max 200)

telos cycle update-default-estimate

Set the default estimate for unestimated work

• --defaultEstimateMinutes — Minutes an unestimated task counts for (1 to twenty workdays)
• --idempotency-key? — Stable retry key for this mutation

telos cycle get-verdict <id>

Get a cycle verdict

telos cycle get-config

Get cycle configuration

telos cycle configure

Configure cycle planning

• --enabled — Whether cycle planning is enabled for the organisation
• --mode — Whether cycles are organisation-wide or per enabled team
• --autoRollover — Whether completed cycles automatically roll unfinished work forward
• --durationWeeks — Cycle duration in whole weeks (1–8)
• --cooldownWeeks — Whole-week gap between adjacent cycles (0–3)
• --upcomingCount — Number of active or future cycles to keep generated
• --startDate — UTC calendar anchor for the organisation cycle grid
• --teamConfigs? — Per-team cadence settings when mode is team
• --idempotency-key? — Stable retry key for this mutation

telos cycle rollover <id>

Roll over an ended cycle now

• --idempotency-key? — Stable retry key for this mutation

telos cycle commit <id>

Commit a cycle baseline

• --idempotency-key? — Stable retry key for this mutation

telos cycle commitments <id>

List a cycle's customer commitments

telos cycle commitments-batch

List several cycles' customer commitments at once

• --ids — Cycle UUIDs, comma-separated on a query string or CLI flag (1 to 20)

telos cycle load <id>

Get a cycle's load per person

telos cycle load-batch

Get several cycles' load per person at once

• --ids — Cycle UUIDs, comma-separated on a query string or CLI flag (1 to 20)

telos cycle events <id>

List a cycle's ledger events

• --cursor?
• --limit?

telos cycle impact <id>

Get cycle impact

• --taskId?

telos cycle update <id>

Update a future cycle

• --name?
• --goal?
• --startsAt?
• --endsAt?
• --scope?
• --teamId?
• --idempotency-key? — Stable retry key for this mutation

telos cycle delete <id>

Delete an empty future cycle

• --idempotency-key? — Stable retry key for this mutation