Skip to content

docs: sync teable-assistant-ops skill to Teable CLI v0.6.45 - #32

Merged
unofn merged 2 commits into
mainfrom
bot/sync-cli-docs
Sep 25, 2026
Merged

unofn merged 2 commits into
mainfrom
bot/sync-cli-docs

Conversation

@teable-agent

@teable-agent teable-agent Bot commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

Automated docs sync: @teable/cli v0.6.45 changed the CLI command surface.
Docs were updated by an AI agent (pi) from the manifest diff below; the manifest
snapshot, sync metadata, and api-reference mirrors were updated deterministically
by the workflow.

api-reference mirror files were regenerated verbatim from the CLI's embedded docs.

Summary

PR summary

CLI changes reviewed

  • Synced the skill against the @teable/cli v0.6.45 manifest.
  • Added coverage for the new teable media command group (generate, get, and cancel).
  • Incorporated connected-app connectorEvent support for automations and routines, including account binding, real-event previews, activation, and disconnected-account recovery.
  • Reviewed the broad CLI terminology change from “base” to user-facing “project”; the curated skill content already followed that convention while retaining API/CLI identifiers such as base, baseId, and --base-id.

Documentation changes

  • Added guides/media-guide.md with operational guidance for single-image vs batch generation, task recovery/polling, output selection, idempotent retries, and safe cancellation.
  • Added Media to the SKILL.md module map and routing rules, and expanded skill activation wording for image generation.
  • Updated automation trigger selection and workflow guidance for connectorEvent.
  • Updated the routine guide and routing rules to distinguish scheduled and connected-app-event agent routines from deterministic automation graphs.
  • Added all three media commands to guides/base-id-reference.md.
  • Bumped skill metadata from 1.9.0 to 1.10.0 and raised the minimum CLI version from >=0.6.40 to >=0.6.45.
  • Left generated API-reference mirrors unchanged, as required.

Validation and uncertainties

  • New command and option names were checked against .github/teable-cli-manifest.json; no sandbox-only command was documented.
  • The new media guide intentionally avoids reproducing the CLI help/flag inventory and contains no new full teable ... invocation requiring validator exemption.
  • /home/runner/work/_temp/commit-log.md was not available, so no optional commit context was used.
  • The supplied manifest diff is explicitly truncated near the end; the v0.6.45 manifest was used as ground truth for the additional routine and automation connector-event behavior.
Command-surface diff

Teable CLI command-surface changes: v0.6.40 → v0.6.45

Added commands

teable media

media operations (generate, get, cancel)

help: teable media
Usage: teable media [options] [command]

media operations (generate, get, cancel)

Options:
  -h, --help          display help for command

Commands:
  generate [options]  Generate a batch of images in one task; save to ChatFile or download locally
  get [options]       Read a media task and retrieve completed images without generating again
  cancel [options]    Cancel a media task while preserving completed images
  help [command]      display help for command

Examples:
  teable media generate --prompt "A mountain landscape" --output image.png
  teable media generate --input images.json --output-dir ./images
  teable media get --id mgtXXXXXXXXXXXXXXXX --output-dir ./images
  teable media cancel --id mgtXXXXXXXXXXXXXXXX

teable media cancel

Cancel a media task while preserving completed images

help: teable media cancel
Usage: teable media cancel [options]

Cancel a media task while preserving completed images

Options:
  -b, --base-id <baseId>  Target project ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  --id <taskId>           Existing media task ID
  -h, --help              display help for command

teable media generate

Generate a batch of images in one task; save to ChatFile or download locally

help: teable media generate
Usage: teable media generate [options]

Generate a batch of images in one task; save to ChatFile or download locally

Options:
  -b, --base-id <baseId>    Target project ID (required, e.g. bseXXXX). Set default: `teable config
                            base-id <id>`.
  --token <token>           Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>     Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                            saved config
  --pretty                  Indent JSON for human readability (default: false)
  -o, --output <file>       Download the single generated image to a new local file
  --output-dir <directory>  Download completed images immediately into a local directory
  --type <type>             Media type (currently image) (default: "image")
  --prompt <text>           Prompt for a single image
  --description <text>      Short description for the image
  --aspect-ratio <ratio>    Aspect ratio supported by the selected image model
  --quality <quality>       Image quality: low, medium or high
  --model <key>             Image model key from the base AI settings; omit for the default
  --reference <file>        Local reference image; repeat for multiple references
  --input <file>            JSON image list or {items:[...]}; use - to read stdin
  --request-id <id>         Stable submission ID; reuse it when recovering an interrupted submission
  -h, --help                display help for command

teable media get

Read a media task and retrieve completed images without generating again

help: teable media get
Usage: teable media get [options]

Read a media task and retrieve completed images without generating again

Options:
  -b, --base-id <baseId>    Target project ID (required, e.g. bseXXXX). Set default: `teable config
                            base-id <id>`.
  --token <token>           Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>     Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                            saved config
  --pretty                  Indent JSON for human readability (default: false)
  -o, --output <file>       Download the single generated image to a new local file
  --output-dir <directory>  Download completed images immediately into a local directory
  --id <taskId>             Existing media task ID
  --wait                    Wait until every image in the task has finished
  -h, --help                display help for command

Changed commands

teable

  • description changed "Teable AI Tools CLI for operating Teable bases, tables, fields, views, records, SQL read queries, and related app/automation workflows with a safe read-before-write process." → "Teable AI Tools CLI for operating Teable projects, tables, fields, views, records, SQL read queries, and related app/automation workflows with a safe read-before-write process."
  • rendered help text changed:
help: teable (old)
Usage: teable [options] [command]

Teable AI Tools CLI for operating Teable bases, tables, fields, views, records, SQL read queries,
and related app/automation workflows with a safe read-before-write process.

Options:
  -V, --version                  Show CLI version
  --debug                        Enable debug output (verbose logging to stderr)
  -h, --help                     display help for command

Setup:
  auth|init [options]            Manage auth for teable
  config                         Manage project-level CLI configuration

Resources:
  base                           base operations (create, get, list, update, delete)
  table                          table operations (create, get, update, delete)
  field                          field operations (create, get, update, delete)
  record                         record operations (create, get, update, delete)
  view                           view operations (create, get, update, delete)
  app                            app operations (list, get-code, create, update, delete, publish,
                                 status, unpublish, login-config, ai-docs, ai-enable)
  automation                     automation operations (list, get, update, activate, setup-trigger,
                                 delete, test-node, delete-node, generate-script,
                                 generate-flowchart, get-script-input, get-runs, get-run)
  routine                        routine operations (create, list, get, update, activate,
                                 deactivate, delete, run-now, get-runs, get-run)
  authority                      authority operations (get, export, diff, apply, enable, disable,
                                 role-list, role-get, role-delete, role-duplicate)
  folder                         folder operations (create, update, delete, move)
  artifact                       artifact operations (list, create, update, get)
  scrape                         scrape operations (search, run, status)
  integration                    integration operations (connect, list, get-token)
  env                            env operations (list, set, update, delete)
  secret                         secret operations (list, set, grant, revoke, delete)
  sandbox                        sandbox operations (tool)
  skill                          skill operations (list, import-github, import-file, update)

Tools:
  get-node-tree [options]        Get the tree structure of all nodes (tables, automations, apps,
                                 etc.) in a base
  search-api [options]           Search available APIs by description to find the right endpoint
  get-doc [options]              Get documentation for a topic
  tools                          Tool discovery and metadata commands
  sql-query [options]            Execute SQL query on tables
  get-collaborators [options]    Get collaborators in the current base with pagination and search
  get-ai-config [options]        Get AI field configuration documentation with available models
  import [options]               Import tabular data into Teable (analyzes by default; --table-name
                                 creates, --table-id appends)
  import-airtable [options]      Import an Airtable base into Teable
  import-google-sheet [options]  Import a Google spreadsheet into Teable
  import-status [options]        Query import job status for a table
  upload-attachment [options]    Upload a local file as an attachment
  call-api [options]             Call any Teable API (axios-style: method, url, params, data)
  trigger-ai-fill [options]      Trigger AI generation for an AI-configured field
  send-email [options]           Send an email to one or more recipients (system SMTP by default, or
                                 --smtp for a custom transport)

Commands:
  help [command]                 display help for command

Examples:
  teable table get --table-id tblXXXX            List table metadata
  teable record get --table-id tblXXXX           Query records
  teable table create --name Tasks --fields '["Title:text","Status:sel:Todo,Done"]'
help: teable (new)
Usage: teable [options] [command]

Teable AI Tools CLI for operating Teable projects, tables, fields, views, records, SQL read queries,
and related app/automation workflows with a safe read-before-write process.

Options:
  -V, --version                  Show CLI version
  --debug                        Enable debug output (verbose logging to stderr)
  -h, --help                     display help for command

Setup:
  auth|init [options]            Manage auth for teable
  config                         Manage project-level CLI configuration

Resources:
  media                          media operations (generate, get, cancel)
  base                           project operations (create, get, list, update, delete)
  table                          table operations (create, get, update, delete)
  field                          field operations (create, get, update, delete)
  record                         record operations (create, get, update, delete)
  view                           view operations (create, get, update, delete)
  app                            app operations (list, get-code, create, update, delete, publish,
                                 status, unpublish, login-config, ai-docs, ai-enable)
  automation                     automation operations (list, get, update, activate, setup-trigger,
                                 delete, test-node, delete-node, generate-script,
                                 generate-flowchart, get-script-input, get-runs, get-run)
  routine                        routine operations (create, list, get, update, activate,
                                 deactivate, delete, run-now, get-runs, get-run)
  authority                      authority operations (get, export, diff, apply, enable, disable,
                                 role-list, role-get, role-delete, role-duplicate)
  folder                         folder operations (create, update, delete, move)
  artifact                       artifact operations (list, create, update, get)
  scrape                         scrape operations (search, run, status)
  integration                    integration operations (connect, list, get-token)
  env                            env operations (list, set, update, delete)
  secret                         secret operations (list, set, grant, revoke, delete)
  sandbox                        sandbox operations (tool)
  skill                          skill operations (list, import-github, import-file, update)

Tools:
  get-node-tree [options]        Get the tree structure of all nodes (tables, automations, apps,
                                 etc.) in a project
  search-api [options]           Search available APIs by description to find the right endpoint
  get-doc [options]              Get documentation for a topic
  tools                          Tool discovery and metadata commands
  sql-query [options]            Execute SQL query on tables
  get-collaborators [options]    Get collaborators in the current project with pagination and search
  get-ai-config [options]        Get AI field configuration documentation with available models
  import [options]               Import tabular data into Teable (analyzes by default; --table-name
                                 creates, --table-id appends)
  import-airtable [options]      Import an Airtable base into Teable
  import-google-sheet [options]  Import a Google spreadsheet into Teable
  import-status [options]        Query import job status for a table
  upload-attachment [options]    Upload a local file as an attachment
  call-api [options]             Call any Teable API (axios-style: method, url, params, data)
  trigger-ai-fill [options]      Trigger AI generation for an AI-configured field
  send-email [options]           Send an email to one or more recipients (system SMTP by default, or
                                 --smtp for a custom transport)

Commands:
  help [command]                 display help for command

Project = API base (bse-prefixed ID). Commands use teable base and --base-id.

Examples:
  teable table get --table-id tblXXXX            List table metadata
  teable record get --table-id tblXXXX           Query records
  teable table create --name Tasks --fields '["Title:text","Status:sel:Todo,Done"]'

teable app

  • rendered help text changed:
help: teable app (old)
Usage: teable app [options] [command]

app operations (list, get-code, create, update, delete, publish, status, unpublish, login-config,
ai-docs, ai-enable)

Options:
  -h, --help              display help for command

Commands:
  list [options]          Get all apps in the base
  get-code [options]      Download app source code as a local read-only context snapshot
  create [options]        Create or update an app with AI
  update [options]        Create or update an app with AI
  delete [options]        Delete an app
  publish [options]       Publish an app. Returns success/failed when final; if it returns
                          deploying, poll app status until success/failed
  status [options]        Check app publish status after publish returns deploying
  unpublish [options]     Unpublish an app
  login-config [options]  Configure login/authentication for an app
  ai-docs [options]       How the app calls AI through Teable proxy (usage + available model keys)
  ai-enable [options]     Enable AI access for an app (provisions the AI proxy key)
  help [command]          display help for command

Examples:
  teable app list
  teable app get-code --app-id appXXXX
  teable app create --prompt "A task tracker with status board"
  teable app update --app-id appXXXX --prompt "Add a dark mode toggle"
  teable app delete --app-id appXXXX
  teable app publish --app-id appXXXX
  teable app status --app-id appXXXX
  teable app unpublish --app-id appXXXX
  teable app login-config --app-id appXXXX --login-config '{"enabled":true,"userTableId":"tblXXX","emailFieldId":"fldXXX","providers":[{"type":"email-otp"}]}'
  teable app ai-docs
  teable app ai-enable --app-id appXXXX
help: teable app (new)
Usage: teable app [options] [command]

app operations (list, get-code, create, update, delete, publish, status, unpublish, login-config,
ai-docs, ai-enable)

Options:
  -h, --help              display help for command

Commands:
  list [options]          Get all apps in the project
  get-code [options]      Download app source code as a local read-only context snapshot
  create [options]        Create or update an app with AI
  update [options]        Create or update an app with AI
  delete [options]        Delete an app
  publish [options]       Publish an app. Returns success/failed when final; if it returns
                          deploying, poll app status until success/failed
  status [options]        Check app publish status after publish returns deploying
  unpublish [options]     Unpublish an app
  login-config [options]  Configure login/authentication for an app
  ai-docs [options]       How the app calls AI through Teable proxy (usage + available model keys)
  ai-enable [options]     Enable AI access for an app (provisions the AI proxy key)
  help [command]          display help for command

Examples:
  teable app list
  teable app get-code --app-id appXXXX
  teable app create --prompt "A task tracker with status board"
  teable app update --app-id appXXXX --prompt "Add a dark mode toggle"
  teable app delete --app-id appXXXX
  teable app publish --app-id appXXXX
  teable app status --app-id appXXXX
  teable app unpublish --app-id appXXXX
  teable app login-config --app-id appXXXX --login-config '{"enabled":true,"userTableId":"tblXXX","emailFieldId":"fldXXX","providers":[{"type":"email-otp"}]}'
  teable app ai-docs
  teable app ai-enable --app-id appXXXX

teable app ai-docs

  • description changed "Shortcut for: get-doc --topic app.ai\n\nReturns documentation on how an app-builder app calls AI through Teable's\nproxy, with the available model keys for the current base. Covers:\n - Injected env vars (TEABLE_AI_API_BASE_URL / TEABLE_AI_API_KEY)\n - Server-side usage with the OpenAI / Anthropic SDK\n - How to enable AI access if it is off\n - Available model keys (e.g. aiGateway@openai/gpt-5.5@teable)" → "Shortcut for: get-doc --topic app.ai\n\nReturns documentation on how an app-builder app calls AI through Teable's\nproxy, with the available model keys for the current project. Covers:\n - Injected env vars (TEABLE_AI_API_BASE_URL / TEABLE_AI_API_KEY)\n - Server-side usage with the OpenAI / Anthropic SDK\n - How to enable AI access if it is off\n - Available model keys (e.g. aiGateway@openai/gpt-5.5@teable)"
  • option -b, --base-id <baseId>: description changed "Target base ID (required, e.g. bseXXXX). Set default: teable config base-id <id>." → "Target project ID (required, e.g. bseXXXX). Set default: teable config base-id <id>."
  • rendered help text changed:
help: teable app ai-docs (old)
Usage: teable app ai-docs [options]

Shortcut for: get-doc --topic app.ai

Returns documentation on how an app-builder app calls AI through Teable's
proxy, with the available model keys for the current base. Covers:
  - Injected env vars (TEABLE_AI_API_BASE_URL / TEABLE_AI_API_KEY)
  - Server-side usage with the OpenAI / Anthropic SDK
  - How to enable AI access if it is off
  - Available model keys (e.g. aiGateway@openai/gpt-5.5@teable)

Options:
  -b, --base-id <baseId>  Target base ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command
help: teable app ai-docs (new)
Usage: teable app ai-docs [options]

Shortcut for: get-doc --topic app.ai

Returns documentation on how an app-builder app calls AI through Teable's
proxy, with the available model keys for the current project. Covers:
  - Injected env vars (TEABLE_AI_API_BASE_URL / TEABLE_AI_API_KEY)
  - Server-side usage with the OpenAI / Anthropic SDK
  - How to enable AI access if it is off
  - Available model keys (e.g. aiGateway@openai/gpt-5.5@teable)

Options:
  -b, --base-id <baseId>  Target project ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command

teable app ai-enable

  • option -b, --base-id <baseId>: description changed "Target base ID (required, e.g. bseXXXX). Set default: teable config base-id <id>." → "Target project ID (required, e.g. bseXXXX). Set default: teable config base-id <id>."
  • rendered help text changed:
help: teable app ai-enable (old)
Usage: teable app ai-enable [options]

Enable AI access for an app so it can call AI through Teable's proxy.
Provisions the proxy key and injects TEABLE_AI_API_BASE_URL /
TEABLE_AI_API_KEY on the next preview restart. Idempotent — safe to run
when already enabled. System-model usage consumes credits; BYOK models
run on the space's own key (no Teable credits).

The key value is never printed. Run `app ai-docs` for usage + models.

Options:
  --app-id <appId>        App id (appXXXX); defaults to TEABLE_APP_ID
  -b, --base-id <baseId>  Target base ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command
help: teable app ai-enable (new)
Usage: teable app ai-enable [options]

Enable AI access for an app so it can call AI through Teable's proxy.
Provisions the proxy key and injects TEABLE_AI_API_BASE_URL /
TEABLE_AI_API_KEY on the next preview restart. Idempotent — safe to run
when already enabled. System-model usage consumes credits; BYOK models
run on the space's own key (no Teable credits).

The key value is never printed. Run `app ai-docs` for usage + models.

Options:
  --app-id <appId>        App id (appXXXX); defaults to TEABLE_APP_ID
  -b, --base-id <baseId>  Target project ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command

teable app create

  • option --folder-id <folderId>: description changed "Folder to place the new app in (folderId from Active Tab Meta); omit for base root." → "Folder to place the new app in (folderId from Active Tab Meta); omit for project root."
  • option -b, --base-id <baseId>: description changed "Target base ID (required, e.g. bseXXXX). Set default: teable config base-id <id>." → "Target project ID (required, e.g. bseXXXX). Set default: teable config base-id <id>."
  • rendered help text changed:
help: teable app create (old)
Usage: teable app create [options]

Build or modify a web application with Teable integration.

Actions:
  create: Create a new app
  update: Modify an existing app

Parameters:
  action: create or update (required)
  name: App name (optional)
  prompt: App-building prompt for teable app create/update CLI (required)
  appId: App ID to update (required for update action)
  tableIds: Table IDs to include in app context (optional)
  attachmentTokens: Image tokens for UI reference (optional)
  sendMode: queue or steer, update action only (optional)

Busy app builder (update action):
  Default (queue): a busy app queues the prompt; it runs automatically when the current generation
finishes.
  steer: redirect the in-flight generation with the prompt instead of waiting; use it to adjust work
that is already running. Falls back to queue when nothing is running.

Important rules for prompt:
  First complete any requested setup, table inspection, analysis, or data changes.
  Do not pass setup, analysis, or data-seeding steps to App Builder.
  Include only the app purpose, UI/workflow, explicit constraints, relevant table IDs, and verified
data context.
  Keep the user intent without adding extra features or details.
  Do not use markdown formatting in the prompt.
  Do not specify technology stack unless the user explicitly requests it.

Workflow:
  Use get-apps tool first to check existing apps.
  If a matching app exists, use update action.
  Otherwise, use create action.

Options:
  --prompt <prompt>                App-building prompt. Include only app goals, constraints, and
                                   verified data context.
  --name <name>                    Name for the app
  --table-ids <jsonArray>          Optional array of table IDs to include in the app context
  --attachment-tokens <jsonArray>  Optional array of attachment tokens (screenshots, designs, etc.)
  --folder-id <folderId>           Folder to place the new app in (`folderId` from Active Tab Meta);
                                   omit for base root.
  -b, --base-id <baseId>           Target base ID (required, e.g. bseXXXX). Set default: `teable
                                   config base-id <id>`.
  --token <token>                  Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>            Teable API server base URL; falls back to TEABLE_ENDPOINT env
                                   var, then saved config
  --pretty                         Indent JSON for human readability (default: false)
  -h, --help                       display help for command
help: teable app create (new)
Usage: teable app create [options]

Build or modify a web application with Teable integration.

Actions:
  create: Create a new app
  update: Modify an existing app

Parameters:
  action: create or update (required)
  name: App name (optional)
  prompt: App-building prompt for teable app create/update CLI (required)
  appId: App ID to update (required for update action)
  tableIds: Table IDs to include in app context (optional)
  attachmentTokens: Image tokens for UI reference (optional)
  sendMode: queue or steer, update action only (optional)

Busy app builder (update action):
  Default (queue): a busy app queues the prompt; it runs automatically when the current generation
finishes.
  steer: redirect the in-flight generation with the prompt instead of waiting; use it to adjust work
that is already running. Falls back to queue when nothing is running.

Important rules for prompt:
  First complete any requested setup, table inspection, analysis, or data changes.
  Do not pass setup, analysis, or data-seeding steps to App Builder.
  Include only the app purpose, UI/workflow, explicit constraints, relevant table IDs, and verified
data context.
  Keep the user intent without adding extra features or details.
  Do not use markdown formatting in the prompt.
  Do not specify technology stack unless the user explicitly requests it.

Workflow:
  Use get-apps tool first to check existing apps.
  If a matching app exists, use update action.
  Otherwise, use create action.

Options:
  --prompt <prompt>                App-building prompt. Include only app goals, constraints, and
                                   verified data context.
  --name <name>                    Name for the app
  --table-ids <jsonArray>          Optional array of table IDs to include in the app context
  --attachment-tokens <jsonArray>  Optional array of attachment tokens (screenshots, designs, etc.)
  --folder-id <folderId>           Folder to place the new app in (`folderId` from Active Tab Meta);
                                   omit for project root.
  -b, --base-id <baseId>           Target project ID (required, e.g. bseXXXX). Set default: `teable
                                   config base-id <id>`.
  --token <token>                  Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>            Teable API server base URL; falls back to TEABLE_ENDPOINT env
                                   var, then saved config
  --pretty                         Indent JSON for human readability (default: false)
  -h, --help                       display help for command

teable app delete

  • description changed "Delete an app (moves it to trash).\n\nParameters:\n - appId (required): The ID of the app to delete\n\n⚠️ Warning: This operation is destructive. Verify appId before deletion. The app can be restored from the base trash." → "Delete an app (moves it to trash).\n\nParameters:\n - appId (required): The ID of the app to delete\n\n⚠️ Warning: This operation is destructive. Verify appId before deletion. The app can be restored from the project trash."
  • option -b, --base-id <baseId>: description changed "Target base ID (required, e.g. bseXXXX). Set default: teable config base-id <id>." → "Target project ID (required, e.g. bseXXXX). Set default: teable config base-id <id>."
  • rendered help text changed:
help: teable app delete (old)
Usage: teable app delete [options]

Delete an app (moves it to trash).

Parameters:
  - appId (required): The ID of the app to delete

⚠️ Warning: This operation is destructive. Verify appId before deletion. The app can be restored
from the base trash.

Options:
  --app-id <appId>        The ID of the app to delete
  -b, --base-id <baseId>  Target base ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command
help: teable app delete (new)
Usage: teable app delete [options]

Delete an app (moves it to trash).

Parameters:
  - appId (required): The ID of the app to delete

⚠️ Warning: This operation is destructive. Verify appId before deletion. The app can be restored
from the project trash.

Options:
  --app-id <appId>        The ID of the app to delete
  -b, --base-id <baseId>  Target project ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command

teable app get-code

  • description changed "Download the source code of an app into the local workspace for reading.\n\nUse this when the user mentions an app (an @app[name](id:appXXX) marker) and you need its\nimplementation as context: understanding how it works, referencing or imitating it, or\ncoordinating changes across apps.\n\nParameters:\n - appId (required): The app ID (e.g. appXXXXXX)\n\nBehavior:\n - Extracts the latest saved version into ~/.teable/refs/<appId>/\n - The directory is a detached snapshot: edits do NOT change the app and may be\n overwritten by the next download. To modify the app, update it through the app builder.\n - Env files are excluded; app secrets are never included.\n\nRequires app editing permission (base Owner/Creator) on the app's base." → "Download the source code of an app into the local workspace for reading.\n\nUse this when the user mentions an app (an @app[name](id:appXXX) marker) and you need its\nimplementation as context: understanding how it works, referencing or imitating it, or\ncoordinating changes across apps.\n\nParameters:\n - appId (required): The app ID (e.g. appXXXXXX)\n\nBehavior:\n - Extracts the latest saved version into ~/.teable/refs/<appId>/\n - The directory is a detached snapshot: edits do NOT change the app and may be\n overwritten by the next download. To modify the app, update it through the app builder.\n - Env files are excluded; app secrets are never included.\n\nRequires app editing permission (project Owner/Creator) on the app's project."
  • option -b, --base-id <baseId>: description changed "Target base ID (required, e.g. bseXXXX). Set default: teable config base-id <id>." → "Target project ID (required, e.g. bseXXXX). Set default: teable config base-id <id>."
  • rendered help text changed:
help: teable app get-code (old)
Usage: teable app get-code [options]

Download the source code of an app into the local workspace for reading.

Use this when the user mentions an app (an `@app[name](id:appXXX)` marker) and you need its
implementation as context: understanding how it works, referencing or imitating it, or
coordinating changes across apps.

Parameters:
  - appId (required): The app ID (e.g. appXXXXXX)

Behavior:
  - Extracts the latest saved version into `~/.teable/refs/<appId>/`
  - The directory is a detached snapshot: edits do NOT change the app and may be
    overwritten by the next download. To modify the app, update it through the app builder.
  - Env files are excluded; app secrets are never included.

Requires app editing permission (base Owner/Creator) on the app's base.

Options:
  --app-id <appId>        App ID to download source code for (from an @app mention or get-apps)
  -b, --base-id <baseId>  Target base ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command
help: teable app get-code (new)
Usage: teable app get-code [options]

Download the source code of an app into the local workspace for reading.

Use this when the user mentions an app (an `@app[name](id:appXXX)` marker) and you need its
implementation as context: understanding how it works, referencing or imitating it, or
coordinating changes across apps.

Parameters:
  - appId (required): The app ID (e.g. appXXXXXX)

Behavior:
  - Extracts the latest saved version into `~/.teable/refs/<appId>/`
  - The directory is a detached snapshot: edits do NOT change the app and may be
    overwritten by the next download. To modify the app, update it through the app builder.
  - Env files are excluded; app secrets are never included.

Requires app editing permission (project Owner/Creator) on the app's project.

Options:
  --app-id <appId>        App ID to download source code for (from an @app mention or get-apps)
  -b, --base-id <baseId>  Target project ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command

teable app list

  • summary changed "Get all apps in the base" → "Get all apps in the project"
  • description changed "List apps in the base with their details.\n\nParameters:\n - search (optional): Filter apps by name (case-insensitive substring match)\n\nReturns app information:\n - id: Unique app identifier\n - name: Display name of the app\n - description: Purpose and functionality description\n - isPublished: Whether the app is published\n - previewUrl: URL to preview the app\n\nUse this before creating or updating apps to:\n - Check what apps already exist\n - Find an app to update by its ID\n\nReturns an empty list if no apps exist in the base." → "List apps in the project with their details.\n\nParameters:\n - search (optional): Filter apps by name (case-insensitive substring match)\n\nReturns app information:\n - id: Unique app identifier\n - name: Display name of the app\n - description: Purpose and functionality description\n - isPublished: Whether the app is published\n - previewUrl: URL to preview the app\n\nUse this before creating or updating apps to:\n - Check what apps already exist\n - Find an app to update by its ID\n\nReturns an empty list if no apps exist in the project."
  • option -b, --base-id <baseId>: description changed "Target base ID (required, e.g. bseXXXX). Set default: teable config base-id <id>." → "Target project ID (required, e.g. bseXXXX). Set default: teable config base-id <id>."
  • rendered help text changed:
help: teable app list (old)
Usage: teable app list [options]

List apps in the base with their details.

Parameters:
  - search (optional): Filter apps by name (case-insensitive substring match)

Returns app information:
  - id: Unique app identifier
  - name: Display name of the app
  - description: Purpose and functionality description
  - isPublished: Whether the app is published
  - previewUrl: URL to preview the app

Use this before creating or updating apps to:
  - Check what apps already exist
  - Find an app to update by its ID

Returns an empty list if no apps exist in the base.

Options:
  --search <keyword>      Filter apps by name (case-insensitive substring match)
  -b, --base-id <baseId>  Target base ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command
help: teable app list (new)
Usage: teable app list [options]

List apps in the project with their details.

Parameters:
  - search (optional): Filter apps by name (case-insensitive substring match)

Returns app information:
  - id: Unique app identifier
  - name: Display name of the app
  - description: Purpose and functionality description
  - isPublished: Whether the app is published
  - previewUrl: URL to preview the app

Use this before creating or updating apps to:
  - Check what apps already exist
  - Find an app to update by its ID

Returns an empty list if no apps exist in the project.

Options:
  --search <keyword>      Filter apps by name (case-insensitive substring match)
  -b, --base-id <baseId>  Target project ID (required, e.g. bseXXXX). Set default: `teable config
                          base-id <id>`.
  --token <token>         Personal access token; falls back to TEABLE_TOKEN env var
  --endpoint <endpoint>   Teable API server base URL; falls back to TEABLE_ENDPOINT env var, then
                          saved config
  --pretty                Indent JSON for human readability (default: false)
  -h, --help              display help for command

teable app login-config

  • option `-b, --
    (truncated — full diff in the workflow run summary)

Review checklist

  • Spot-check updated examples against teable <cmd> --help of v0.6.45
  • Removed commands no longer appear anywhere in the docs
  • metadata.json version/engines bump is sensible
  • validate-skill-docs CI is green (if no checks appear, the PR was opened with the
    default token — run the validate-skill-docs workflow manually or set SYNC_GITHUB_TOKEN)

🤖 Auto-generated by the sync-cli-docs workflow — review before merging.

@teable-agent teable-agent Bot changed the title docs: sync teable-assistant-ops skill to Teable CLI v0.6.43 docs: sync teable-assistant-ops skill to Teable CLI v0.6.45 Sep 25, 2026
@unofn
unofn merged commit f9a9eca into main Sep 25, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants