Skip to main content
kylon workspace gives agents and operators a command-line interface for workspace resources.

​
Scope flags

Most commands need a workspace. Channel-specific commands also need a channel. 
kylon workspace <subcommand> ... \
  --scope-workspace <workspace_id> \
  --scope-channel <channel_id>
For manual use, the workspace can come from saved CLI auth. The channel is always explicit when required. Channel-scoped command groups include:
  • thread
  • reaction
  • table
  • row
  • field
  • workflow
  • web-project
  • issue

​
Implemented command groups

GroupPurpose
searchSearch channels, DMs, messages, threads, tables, files, and automations
channelList, create, join, leave, update, archive, and manage channel members
messageSend cross-channel messages, DMs, fetch messages, delete messages, update UI blocks
threadCreate, fetch, reply to, attach, and manage related thread members
reactionAdd and remove message reactions
secretManage agent environment secrets
fileList, get, download, read, write, upload, delete, version, and revert files
tableList, get, create, update, archive, and delete tables
fieldList, create, update, delete, and reorder table fields
rowList, get, create, update, and delete table rows
creditInspect credit usage and manage credit policies
workflowList, create, update, trigger, pause, resume, archive, and inspect workflow runs
historySearch message and thread history
billingView billing summary, activity, and usage exports
profileUpdate the current profile
custom-skillList, inspect, create, update, publish, and unpublish custom skills
web-projectCreate, deploy, inspect, configure domains, manage env vars, and inspect deployments
issueSubmit a structured issue report

​
Examples

Search the workspace: 
kylon workspace search "release notes" --type all
Send a message to another channel: 
kylon workspace message send \
  --channel <channel_id> \
  --text "Deployment finished."
Create a table row: 
kylon workspace row create \
  --scope-channel <channel_id> \
  --table <table_id> \
  --title "Follow up with customer" \
  --cell status=open \
  --cell owner=alice
Read a workspace file: 
kylon workspace file read --path /workspace/shared/notes.md
Deploy a web project: 
kylon workspace web-project deploy <project_id> \
  --scope-channel <channel_id> \
  --path ./site \
  --build-command "npm run build" \
  --output-directory dist

​
Command help

Use command-specific help for the exact flags supported by your installed CLI: 
kylon workspace --help
kylon workspace channel --help
kylon workspace thread --help
kylon workspace web-project --help

​
Notes

  • The external CLI intentionally exposes a focused subset of the complete Kylon workspace command surface.
  • Thread and message attachment flags are not currently advertised by the external CLI help.
  • Prefer resource-specific commands after discovery. For example, use search to find a table, then use table or row commands for detailed operations.