CLI Reference¶

Reference documentation for the packs CLI.

agent chat¶

Run your installed agent from the terminal and print its reply

Usage: packs agent chat <manifestPath> <prompt>

Options:

--agentInstanceId

Installed agent instance to run. Defaults to this pack's install for the caller.

Type: string

--tenantId

Brain tenant id for the agent install. Defaults to the trigger response.

Type: string

--chatId

Continue this chat instead of the last one. Its agent runs unless --agentInstanceId is set.

Type: string

--new

Start a new chat instead of continuing the last one.

Type: boolean

--timeout

Seconds to wait for a reply before giving up.

Type: number | Default: 120

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

agent install¶

Install an uploaded agent version to your account

Usage: packs agent install <manifestPath>

Options:

--version

Agent version to install. Defaults to the latest upload.

Type: string

--reinstall

Rebind even if already installed. Needed after changing tools or triggers.

Type: boolean | Default: false

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

agent logs¶

Show recent logs for an installed agent instance

Usage: packs agent logs <manifestPath>

Options:

--tenant

Tenant id owning the agent instance. Defaults to the caller's tenant for this pack.

Type: string

--instance

Agent instance id. Defaults to this pack's install for the caller.

Type: string

--session

Show only this agent session. Defaults to the latest session (tail follows new sessions).

Type: string

--limit

Maximum log records per fetch.

Type: number | Default: 20

--tail

Keep polling for new logs for up to 5 minutes, then stop (re-run to continue, Ctrl-C exits).

Type: boolean | Default: false

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

auth¶

Set up authentication for a Pack

Usage: packs auth <manifestPath>

Options:

--oauthServerPort, --oauth_server_port

Port to use for the local server that handles OAuth setup.

Type: number | Default: 3000

--extraOAuthScopes, --extra_oauth_scopes

Scopes to request beyond those listed in the manifest, for specific formulas that need extra permissions. Example: --extra_oauth_scopes='first second third'

Type: string

build¶

Build your Pack locally (not required; for debugging purposes only)

Usage: packs build <manifestFile>

Options:

--outputDir, -o

Type: string

--minify

Type: boolean | Default: true

--timerStrategy

Options: none, error, fake (default: none).

Type: string

--intermediateOutputDirectory

Type: string

clone¶

Clone an existing Pack that was created using Pack Studio

Usage: packs clone <packIdOrUrl>

Options:

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

create¶

Register a new Pack with the server

Usage: packs create <manifestFile>

Options:

--name, -n

The name of the Pack. Can be set later in the UI.

Type: string

--description, -d

A description of the Pack. Can be set later in the UI.

Type: string

--workspace, -w

The workspace ID, or workspace URL that you want your Pack to be created under.

Type: string

--allowedAgents

Agent Pack IDs that can use the connector. This replaces the whole list. With no IDs, no agents can use it.

Type: number

--allowAllAgents

Let every agent use the connector.

Type: boolean

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

execute¶

Execute a formula

Usage: packs execute <manifestPath> <formulaName> [params..]

Options:

--fetch

Actually fetch http requests instead of using mocks. Run "packs auth" first to set up credentials.

Type: boolean | Default: true

--vm

Execute the requested command in a virtual machine that mimics the environment the platform uses to execute Packs.This defaults to true if the isolated-vm package is installed, and to false if not.

Type: boolean

--dynamicUrl

For a dynamic sync table with a variable source location, specify the URL to test here.

Type: string

--timerStrategy

Options: none, error, fake (default: none).

Type: string

--maxRows

For a sync table, the maximum number of rows to sync.

Type: number | Default: 1000

--allowMultipleNetworkDomains

Allow executing Packs that use multiple network domains. You must get approval from Superhuman before you can upload these Packs.

Type: boolean | Default: false

extensions¶

Installs developer extensions for working with Packs.

Usage: packs extensions <tools..>

init¶

Scaffold a Pack in the current directory

Usage: packs init

Options:

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

--agent

Scaffold an agent pack (sdk.newAgent()) instead of a formula pack. No git or network template install needed.

Type: boolean | Default: false

--name

Agent name used in the scaffolded pack.ts (with --agent). Defaults to the directory name.

Type: string

link¶

Link to a pre-existing Pack ID on the server

Usage: packs link <manifestDir> <packIdOrUrl>

Options:

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

register¶

Register API token to publish a Pack

Usage: packs register [apiToken]

Options:

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

--open

Open the API token creation page in a browser.

Type: boolean | Default: false

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

release¶

Set the Pack version that is installable for users. You may specify a specific version, or omit a version to use the version currently in the manifest file. The version must always be higher than that of any previous release.

Usage: packs release <manifestFile> [packVersion]

Options:

--notes, -n

Notes about the contents of this Pack release

Type: string | Required

--gitTag, -g

Create a git tag for this release (default: false). Can also be enabled by default via packs setOption <manifestFile> gitTag true

Type: boolean

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

--useLatest

Release the latest uploaded version when the manifest has no version.

Type: boolean | Default: false

setOption¶

Set a persistent build option for the pack (.coda-pack.json)

Usage: packs setOption <manifestFile> <option> <value>

settings get¶

Read Pack settings

Usage: packs settings get [manifestFile]

Options:

--manifestFile

Pack definition file.

Type: string | Default: pack.ts

--packIdOrUrl

Pack ID or URL. Overrides the ID in .coda-pack.json.

Type: string

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

settings update¶

Update the Pack listing fields used in the Superhuman Store and Go. To change the Docs and Coda Gallery listing, use Pack Studio.

Usage: packs settings update [manifestFile]

Options:

--manifestFile

Pack definition file.

Type: string | Default: pack.ts

--packIdOrUrl

Pack ID or URL. Overrides the ID in .coda-pack.json.

Type: string

--allowedAgents

Agent Pack IDs that can use the connector. This replaces the whole list. With no IDs, no agents can use it.

Type: number

--allowAllAgents

Let every agent use the connector.

Type: boolean

--name

Pack name.

Type: string

--icon

Path to the icon image. The CLI uploads it.

Type: string

--images

Paths to images shown in Superhuman Go, which replace the current ones. With no paths, removes them all.

Type: string

--tagline

Tagline shown in Superhuman Go. When unset, Go uses --description, and connectors then fall back to the Docs tagline set in Pack Studio.

Type: string

--description

Description shown in Superhuman Go. When unset, connectors fall back to the Docs description set in Pack Studio. Use an empty string to clear it.

Type: string

--entrypoints

Where the Pack is available: go, docs, or both.

Type: string

--supportEmail

Support email address.

Type: string

--termsOfServiceUrl

Terms of Service URL.

Type: string

--privacyPolicyUrl

Privacy Policy URL.

Type: string

--yes, -y

Skip confirmation prompts. Required in non-interactive environments.

Type: boolean | Default: false

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

upload¶

Build and upload your Pack version to the server

Usage: packs upload <manifestFile>

Options:

--notes, -n

Notes about the contents of this Pack version

Type: string

--intermediateOutputDirectory, -o

Type: string | Default: ./_upload_build

--timerStrategy

Options: none, error, fake (default: none).

Type: string

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

--allowOlderSdkVersion

Not recommended. Allows uploading a Pack build that uses an older version of the SDK than the prior Pack build.

Type: boolean | Default: false

validate¶

Validate your Pack definition

Usage: packs validate <manifestFile>

Options:

--checkDeprecationWarnings

Also check for warnings about deprecated properties and features that will become errors in a future SDK version.

Type: boolean | Default: true

--checkConnectors

For agent packs, check granted connector pack IDs against the server (needs a token). Pass --no-checkConnectors to skip.

Type: boolean | Default: true

--apiToken, -t

API token to use for the operation. Use the register command to define a default token.

Type: string

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string

whoami¶

Looks up information about the API token that is registered in this environment

Usage: packs whoami [apiToken]

Options:

--apiEndpoint, --codaApiEndpoint

API endpoint to use for the operation (default: https://coda.io). Required for single-tenant instances. Can also be set persistently via packs setOption <manifestFile> apiEndpoint <url>.

Type: string