Skip to main content

How branches work

Every CLI command lives under a top-level branch that names a resource — ekso item ..., ekso field ..., ekso docs .... Verbs scope to that resource (list, get, create, update, delete) plus any resource-specific extras (field create-list, docs folder create). You can always discover the verbs for a branch with:
ekso <branch> --help
And the flags for a verb with:
ekso <branch> <verb> --help
--help reflects the binary you have installed — treat it as the source of truth if these docs and your CLI ever drift.

Work management

BranchWhat it does
itemItems — the core unit of work. Create, list, filter, copy, screen, dependency edges.
containerContainers — top-level groupings (products, projects, support queues).
areaSub-groupings within a container (front-end, database, complaints, …).
labelColoured labels you attach to containers and items.
linkItem-to-item references (Related, Duplicate, …).
watchWatchers — users who get notified on item changes.

Process & workflow

BranchWhat it does
processBusiness processes — define which fields and verbs an item uses.
fieldCustom and system field definitions. One verb per type — create-date, create-list, etc.
constraintField validation rules (regex, ranges, required-when conditions).
ruleAutomation rules — when X happens, do Y.
screenItem-detail screens — which fields render in which order.
clockSLA clocks — countdown timers with start/finish/breach status.

Planning & delivery

BranchWhat it does
boardBoards — Kanban / table / timeline views over a container.
cycleCycles (sprints) — time-boxed groupings of items within a board.

Time & finance

BranchWhat it does
timeTime entries — log work against items, query by user/period.
cost-centerCost centers users belong to.
job-roleJob roles + billing rates.
skuStock-unit / product codes for billable work.
crmCRM records — clients items can be tagged against.
non-billableNon-billable categories (Meetings, Training, Vacation).
budget-reasonReason codes for budget overruns / under-runs.
reportingReports — profitability, risk, time summaries.

Knowledge & files

BranchWhat it does
docsKnowledge-base folders, docs, and doc content.
fileFile attachments on items and annotations.

Communication

BranchWhat it does
mail-generalTenant-wide mail config (block lists, suppressed subjects).
mail-mailboxMailbox connections — IMAP/POP credentials.
mail-ticketingTicketing pipelines that turn inbound email into items.
notificationNotification preferences and history.
hookOutbound webhooks fired on rule actions.

Administration

BranchWhat it does
authSign in / out, current-user details.
userTenant users. Admin-tier — requires SuperAdmin.
user-groupUser groups for permissions. Admin-tier.
access-controlRole grants (View / Add / Manage / …). Admin-tier.
api-keyMint, list, revoke API keys. Admin-tier.
metaMeta data — countries, currencies, timezones.
mcpMCP-server-related operations.

See also