79 posts tagged with "Slack CLI"

Version 4.4.0 of the Slack CLI is here!

• The Slack CLI now supports the features.agent_view app manifest property to enable the new Agent experience.

Version 4.3.0 of the Slack CLI is here!

• The slack create command now accepts the --app flag to scaffold a project and automatically link it to an existing app.
• The slack external-auth add-secret command is now available to all apps, not just Slack-hosted apps.
• The Slack CLI now supports mcp_server manifest fields for connecting MCP servers to the Slackbot MCP Client.

Version 4.2.0 of the Slack CLI has arrived!

• The slack api command can now send unauthenticated requests when no token is available or when --no-auth is specified.
• The slack api command no longer triggers a background update check when invoked with arguments (e.g., slack api chat.postMessage).
• Any Y/N select prompts now display as vertical selection, similar to the slack create command.
• We've disabled upgrade notifications for the slack manifest and slack manifest info command. The command returns JSON that may be used for scripting, and the notifications interfere with parsing the response output.

Version 4.1.0 of the Slack CLI has landed!

• We've added a slack api <method> command, which allows you to call any API method directly from the Slack CLI. For example:
  • slack api chat.postMessage channel=C123 text="hi"
  • slack api chat.postMessage '{"channel":"C123","text":"hi"}'
• Interactive forms are now screen reader friendly when the ACCESSIBLE environment variable is set, or when using the --accessible flag.
• We've added a new env init command to copy a template placeholder .env.sample or .env.example file to the .env file of your project.
• We've added support for the settings.is_mcp_enabled: <bool> manifest property to enable or disable the Slack MCP Server. This causes cached values to expire and the next run attempt may surface a warning noting that app settings have changed since the last update.
• We've added support for optional OAuth scopes (bot_optional and user_optional) in the app manifest schema.
• We've added a SLACK_CLI_APP_ICON_PATH environment variable to override the icon file path used during app install and local run. When set, the specified path takes priority over the manifest icon field and the default icon file search. A warning is displayed if the configured path does not exist.
• Icon auto-detection now supports .png, .jpg, .jpeg, and .gif formats in assets/ and project root. The assets/ directory is checked before project root; .png is preferred when multiple formats exist.
• App manifest display names now preserve the original app name instead of using the kebab-case directory name during slack create.
• We've added verbose debug logging and retry support to icon upload API calls.
• We capitalized "App" in the slack create category selection menu titles for more consistent title casing.
• We've added more polish to outputs from the slack create command section headers.
• The slack create command preserves path separators when a nested path is provided as the project directory. The --name flag now only overrides the app's display name in the manifest without replacing the path argument. For example:

  $ slack create path/to/my-app --name "My App"
  # Creates directory at ./path/to/my-app/ with manifest name "My App"
  

• We fixed the S3 Content-MD5 header when deploying a Deno app to Slack. We now remove the MD5 hash computation and Content-MD5 header from S3 presigned POST uploads to avoid an error.
• The Slack CLI installer now outputs the pinned version provided if a particular version is provided, rather than a version and blank space.
• The Slack CLI now avoids uploading icons for non-hosted apps that do not have the set-icon experiment enabled.

Version 4.0.0 of the developer tools for the Slack platform has arrived with lots of goodies for you!

This version ties together iterative improvements, with special focus on agent development. The Slack CLI can now quickly scaffold an AI agent using the slack create agent command and our collection of agent sample apps. Features such as local manifest management, environment variable management, and file watching with live reloading come together to streamline the agent development experience.

New features​

Creating apps and agents​

• The AI Agent templates now include an IT support agent available with the slack create agent command.
  • Use slack create agent to choose one the new AI Agent templates:
    • Starter Agent:
      • Supports Bolt for JavaScript and Bolt for Python
      • Available in the Claude Agent SDK, OpenAI Agents SDK, and Pydantic AI framework
    • IT Support Agent:
      • Supports Bolt for JavaScript and Bolt for Python
      • Available in the Claude Agent SDK, OpenAI Agents SDK, and Pydantic AI framework
  • Slack MCP Server is built-in to all of the AI Agent templates.
• The Slack CLI installer now ends with a recommendation to run the slack create agent command.
• The slack create command now separates selections into categories of templates for frameworks to better align with the options displayed.

Managing environment variables​

• Environment variables saved to .env files are now loaded into the process before hook scripts run. This improves the slack run command, as additional dependencies are no longer required to load environment variables into the runtime context. Other commands such as the slack deploy command and the slack manifest command also benefit, as the underlying hooks can be more expressive in customizations, and can also be configured for custom environments.
• The slack env list command now lists the environment variables available from .env files for apps that aren't run on Slack infrastructure.
• The slack env set command can now add and update environment variables in .env files for apps that aren't built or run on Slack infrastructure, making configuring and iterating on a Bolt app from the command line faster.
• The slack env unset command now removes environment variables from .env files for apps that aren't built or run on Slack infrastructure.
• The slack env commands were aliased to env set and env unset to match more common shell conventions. (These commands were previously recommended as add and remove, which became confusing when existing variables were updated.) Refer to the slack env command docs for more details.

Finding docs programmatically​

• We've added a slack docs search subcommand, which can output search results using plain text, json, or your preferred browser. Refer to the slack docs command docs for more details.

Developing an app​

• We've added file watch and live reload support to slack run. This allows your Slack apps to immediately reflect changes to files by you or your agent-related development tools (Claude Code, Codex, etc.).
• It's easier to start an HTTP OAuth Server or app with a custom path, as the slack run command now accepts an optional argument for the app entry point. For example: $ slack run ./src/app_oauth.py.
• We updated the slack run command for Enterprise Organizations so that "All workspaces" is always shown as the first option when prompted to choose whether to grant to all workspaces or a specific workspace.
• When a command runs using the verbose flag (--verbose) and makes an HTTP request, the output now includes the HTTP Header's User-Agent. For example: HTTP Request User-Agent: slack-cli/v3.15.0 (os: darwin).

Python project improvements​

• The slack create and slack init commands now create a Python Virtual Environment (.venv) when it doesn't exist.
• The slack create and slack init commands now install your project dependencies from pyproject.toml and requirements.txt after activating your Python virtual environment.
• All slack commands now activate your Python virtual environment, when it exists. For example, this means slack run will activate your .venv before starting your app's server.

Bolt Framework agent improvements​

• Bolt for JavaScript 4.7.0 and Bolt for Python 1.28.0 support a collection of new agent-related UI features.
• Event listener handlers now provide utilities to display your agent's thinking status, streaming text, display suggested prompts, and more.
• The Slack MCP Server now works with Bolt Frameworks.
• Popular agent frameworks such as Claude Agent SDK, OpenAI Agents SDK, Pydantic, and Vercel now work with Bolt.

Prompt look and feel​

• We've refreshed our interactive prompt style with Charm's Huh package.
• Interactive prompts now support light-mode and dark-mode.

Bug fixes​

• We fixed a pyproject.toml error that was displayed by the slack create and slack init commands. The error occurred when creating a Bolt Python project that includes pyproject.toml, but doesn't define a [project] section or dependencies array. Now, a warning is displayed in --verbose mode, as this is a valid pyproject.toml format.
• We fixed a bug: environment variable values set for hook commands are no longer surrounded with double quotes.
• We fixed a bug with the Windows installer. The installer now suggests providing an optional alias as a separate step from downloading the installer if earlier overwrites were avoided but still caused the installation to fail.
• We fixed a bug: errors will appear sooner in CI and scripting setups if either interactive input or a confirmation is requested, rather than waiting for a timeout.
• We fixed a bug: The sections of slack env command outputs are now titled to match the command itself, and are grouped under one section for each command.

But wait, there's more!​

In version 4.0.1 of the developer tools, we've fixed the slack create agent command so that it shows prompts for the app template, Bolt Framework, and then Agent Framework. This adds more templates to the options, including Bolt for JavaScript and Bolt for Python implementations of the Starter Agent and Support Agent templates.

Version 3.15.0 of the developer tools for the Slack platform has arrived!

• The slack create command now normalizes project directory names to kebab-case (lowercase, dash-delimited, no whitespace or special characters). For example: slack create "My App" now creates a my-app directory instead of a My-App directory.
• We've updated the the slack create command's app name prompt to show the randomly generated app name as placeholder text. You can press Enter to accept the default name, or type in a new name.
• Bolt JavaScript and Bolt Python projects now default to using the local manifest.json as the app manifest (previously, it was a remote manifest from app settings). Changes to the app manifest via app settings will now be detected by the Slack CLI, and a prompt will be displayed before any manifest update action occurs (e.g., when using the slack run command). The manifest source is set after creating a new project with the slack create command or by initializing an existing project using the slack init command, and the setting is stored as "manifest.source": "local" in the .slack/config.json file.
• We've updated the slack app link command to support projects that use a manifest file as the manifest source (manifest.json). As part of this:
  • A warning message will not be displayed when the manifest source is local (project file).
  • The manifest source is not changed; it now uses the project's current manifest source.
  • The current manifest source is displayed for your reference.
  • A tip on where to change the manifest source (.slack/config.json) is displayed.
• We've also updated the app manifest overwrite warning prompt wording and appearance:
  • It now clarifies that the app settings manifest will be overwritten by the project's app manifest file.
  • It now displays a warning that changes were detected on the app settings manifest that are not in the project's app manifest file.
• We fixed a bug: we now output a warning instead of an error if activating the Python virtual environment (.venv/) fails.

Version 3.14.0 of the developer tools for the Slack platform has landed!

• The slack create command now prompts you for a custom app name if the randomly generated default isn't your thing. This prompt appears before scaffolding a new project from a template, and when making new project directories with your custom app name, we now replace spaces with a dash (instead of removing spaces altogether) to make navigation a bit better.
• The slack create command now updates the app name in the package.json and pyproject.toml project files.
• We've updated the slack create and slack init commands to support creating a Python virtual environment (.venv) when it doesn't exist, and installing the project's dependencies from the requirements.txt and pyproject.toml project files.
• When running Slack CLI commands in a Bolt Python project, the Slack CLI will attempt to automatically activate the Python virtual environment (.venv). This allows commands that use the slack-cli-hooks Python package to run safely and successfully, even when the terminal system doesn't have the virtual environment activated.
• We've added a --subdir flag to the slack create command for extracting a subdirectory from a template repository as the project root. This supports monorepo-style templates where multiple apps live in subdirectories (e.g., slack create my-app -t org/monorepo --subdir apps/my-app).
• The slack docs command opens the slack developer docs site, and you can now use the --search flag to open the docs search page with the provided query.
• We fixed a bug and now avoid infinite loops when searching for the root project .slack directory for projects existing on drives other than the C: drive on Windows.
• We fixed a bug and now check whether an installed git command exists on Windows.

Version 3.13.0 of the developer tools for the Slack platform has arrived!

• When running the slack create command with the agent argument, a list of agentic apps are now highlighted for selection. If you want to name your app "agent" and not create an agentic app, you can use the --name flag instead to explicitly set your app name. Refer to the slack create command for more details.
• When running the slack create command, the available templates are now shown without requiring an immediate selection when using the --list flag. Refer to the slack create command for more details.
• The slack deploy command now references the latest online documentation, with a suggestion to run a development app using the slack run command if a deploy hook script doesn't exist. Refer to our hooks documentation for more details.
• We now prompt you to log in if no prior authentications are detected when running any command that requires credentials, rather than exiting with an error.

Version 3.12.0 of the developer tools for the Slack platform has landed!

• We've updated the slack create command to display "AI Agent app" instead of "AI app" to align with Slack's new Agent app features.
• We've added pyproject.toml support to Bolt for Python projects. The slack create and slack init commands will now detect pyproject.toml files, add the slack-cli-hooks<1.0.0 to the dependency section (when missing), and display instructions on how to install the dependencies. Python projects now support either or both of the requirements.txt and pyproject.toml files.
• We've updated the slack run command to support file watching and live reloading for Bolt for JavaScript and Bolt for Python projects. When a file is changed, the Slack CLI will automatically restart the app development server. When the manifest.json file is changed, the manifest update API is called (.slack/config.json must have manifest.source: "local").
• We fixed a bug: we removed support for the .slackignore file in the project root, as this file was unused. For posterity, during the Slack CLI Beta, this allowed Deno SDK projects to ignore files during deployment, but the feature was removed before Slack CLI v1.0.0.
• We fixed a bug: the slack app settings command now opens the App Settings home page (https://api.slack.com/apps) when the command is run outside of a project. This allows you to see your complete list of apps.
• We fixed a bug: we now print a debug log if the manifest file was changed but not reinstalled if the manifest.source was set to "remote".

Version 3.11.0 of the developer tools for the Slack platform has arrived!

• We made a few updates behind the scenes to keep things running smoothly. Happy New Year!

Version 3.10.0 of the developer tools for the Slack platform is here!

• We've added the slack app unlink command, which removes an existing App ID from your project (it will not delete the app from Slack).
• We've added support for read-only app collaborators (applicable to deployed Deno apps only):
  • To add a new collaborator as read-only, use the slack collaborator add --permission-type=reader command.
  • To update an existing collaborator to be read-only, use the slack collaborator update --permission-type=reader command.
  • To assign a collaborator as an owner, use the --permission-type=owner flag.

Version 3.9.2 of the developer tools for the Slack platform has landed!

• We made a few updates behind the scenes to keep things running smoothly.
• The deno-slack-hooks version was updated to v1.5.0. This version adds support for bundling deno-slack-sdk projects with the new deno bundle command.

Version 3.9.1 of the developer tools for the Slack platform is here!

We made a few updates behind the scenes to keep things running smoothly.

Version 3.9.0 of the developer tools for the Slack platform has arrived!

• Slack CLI now supports Work Objects. The manifest values for entity_types are now gathered when reading an app manifest.
• When reinstalling the Slack CLI after some time, we now avoid blocking the installation script with an automatic prompt to update to the latest version.

Version 3.8.1 of the developer tools for the Slack platform has arrived!

• We fixed an issue to address a security vulnerability in a dependency.

Version 3.8.0 of the developer tools for the Slack platform has arrived!

• All available samples can now be listed with the slack samples --list command. The --language flag may also be useful in filtering the resulting outputs.
• We've deprecated the --branch and --template flags for the slack samples command. We recommend using the slack create command with these options going forward.
• The specification for hooks.json can now be found in our documentation for reference and details about how various commands can be customized with the Slack CLI to interact with your project.

Version 3.7.0 of the developer tools for the Slack platform has arrived!

• The macOS & Linux installation scripts now install to the $HOME/.local/bin path if installing to the /usr/local/bin path causes an error. Additional $PATH setup may be required and is output as needed. The $HOME/.local/bin path adheres to the emerging XDG specification.
• We now parse the app manifest fields of features.search when gathering an app manifest.

Version 3.6.1 of the developer tools for the Slack platform is here!

• The deno runtime is no longer installed with the Slack CLI installation script. We recommend installing deno separately and configuring CI systems as needed for app development (such as for ROSI apps).

Version 3.6.0 of the developer tools for the Slack platform is joining the summer fun!

• We added a new runtime_not_found error code that will appear when a hook script cannot be found because the runtime for a project wasn't found during execution.
• We updated the slack install command to create and install new Bolt Framework apps that are configured to use app settings as the source of truth (i.e., remote manifest).
• We updated the Slack CLI output to use the new tools URL at https://docs.slack.dev/tools instead of the previous one at https://tools.slack.dev.
• We added a download link to the latest version of the Slack CLI for Windows. Manual installations for the latest are now also supported at the following links:
  • https://downloads.slack-edge.com/slack-cli/slack_cli_latest_linux_64-bit.tar.gz
  • https://downloads.slack-edge.com/slack-cli/slack_cli_latest_macOS_arm64.tar.gz
  • https://downloads.slack-edge.com/slack-cli/slack_cli_latest_macOS_amd64.tar.gz
  • https://downloads.slack-edge.com/slack-cli/slack_cli_latest_macOS_64-bit.tar.gz
  • https://downloads.slack-edge.com/slack-cli/slack_cli_latest_windows_64-bit.zip
• We fixed a bug: we now allow new projects to be created more quickly by using a HTTP HEAD request to check whether the template URL exists.
• We fixed a bug: we now order the outputs of authentication details from the slack doctor command according to an alphabetized list of team domains.

Version 3.5.2 of the developer tools for the Slack platform has landed!

• Beginning September 1, 2025, the Slack CLI installation script will no longer include deno as part of the installation. We recommend installing deno separately and configuring CI systems as needed for app development (such as for ROSI apps).
• The sdk_hook_not_found error now provides a link to the Deno starter template hooks.json file as a working example.

Version 3.5.1 of the developer tools for the Slack platform is here!

• The install scripts now prompt you for feedback if an error occurs during the installation process.

Version 3.5.0 of the developer tools for the Slack platform is here!

• The Bolt for JavaScript and Bolt for Python sample apps referenced in the documentation are now included in prompts of the slack samples command, and can be filtered using the --language flag.
• Samples can now be created with a provided app name using the slack samples command with the provided app name.
• We fixed a bug where the slack run command exited with an error if activity logs failed to stream. Now, retries are attempted for those missed logs.

Version 3.4.0 of the developer tools for the Slack platform is here!

• The install script and the slack upgrade command will now automatically detect your macOS architecture and install an Intel or an Apple Silicon binary.
• Outputs from erroring hook scripts, such as those found when gathering an abnormal app manifest, are no longer hidden in verbose outputs but are instead shown with invocation errors.
• In preparation for apps using the Run on Slack infrastructure to work with Deno 2, the following Deno ecosystem releases have gone out:
  • v2.15.1 of the Deno Slack SDK
  • v1.4.0 of the Deno Slack Hooks
  • v1.1.3 of the Deno Slack Runtime

Version 3.3.0 of the developer tools for the Slack platform has arrived!

• We've added native support for Apple silicon; the install script will use the matching arm64 build for developers upgrading.
• We fixed a bug when creating a project using a git repo template. Previously, if the template included .git within the URL, the template would fail to be cloned (for example, when running the slack create --template https://github.com/slack-samples/example.git.project.git command).
• We fixed a bug: setting the source using the flag for the slack manifest info command now takes precedence to project configurations, which are used to determine the default source.

Version 3.2.0 of the developer tools for the Slack platform is here!

• We now display the manifest source as human-friendly output: project (local) and app settings (remote). You'll see these changes in the slack create, slack init, and slack app link <id> commands, for example.
• The link between your project code and the configurations within app settings can now be accessed by running the slack app settings command. Bolt developers with a remote manifest source managed within app settings may find this useful for discovering new features or making updates.
• We fixed a bug: The example slack app link and slack app list commands shown when running the slack app --help command now use the entire command in order to prevent potential aliasing errors.
• We fixed a bug to improve the console output to handle string values for versions.

Version 3.1.0 of the developer tools for the Slack platform has sprouted!

• We've updated the slack app link command to work with apps that have a local manifest source.
• We've updated the slack feedback command to display a prompt for Slack CLI feedback: now you can ask questions, submit issues, or suggest features for the Slack CLI through GitHub Issues.
• Related to the above update, the slack feedback --name platform-improvements command has been replaced with slack feedback --name slack-platform. You can continue to use the --name platform-improvements flag until the next major version release.
• We updated the slack feedback command error message to account for a missing --name <id> flag and to clarify that the name is specified as a flag. You should now see: Please provide a --name flag or remove the --no-prompt flag.
• We fixed a bug with a rare edge case that caused the Slack CLI to hang without exiting the process. Now, the Slack CLI will exit with the correct error code and allow sub-processes to clean up.

Version 3.0.5 of the developer tools for the Slack platform has bloomed!

• The Slack CLI and installation scripts now point to our new Slack platform documentation at docs.slack.dev and our developer tools documentation at tools.slack.dev.
• As part of the Slack CLI going open source, the Slack CLI documentation has gone open source as well!
• We fixed a bug: When running the slack upgrade command inside a project directory, the output now notes whether the latest SDK versions were checked.

Long a staple of apps built with the Deno Slack SDK—and now with recent support for the Bolt framework—we're proud to make the ever-growing Slack CLI part of our collection of open source tooling.

We love contributions from our community, so we encourage you to explore and interact with the GitHub repo. Contributions, bug reports, and any feedback are all helpful; let us nurture the Slack CLI together to help make building Slack apps more pleasant for everyone.

Not familiar with the Slack CLI? Visit the docs and follow the installation guide to begin your journey.

Version 3.0.4 of the developer tools for the Slack platform is here!

• We fixed a bug: we updated the URL in the hooks.json error message to use a working, valid URL.

Version 3.0.2 of the developer tools for the Slack platform is here!

• We've updated the slack version command to include additional descriptive information and examples when using the --help flag.
• We've updated the feedback URL when using the slack feedback command to point to the home of our new and improved documentation on docs.slack.dev!

Slack CLI v3.0.1 delivers a handful of small improvements thanks to our developer community feedback.

• We've fixed the --token flag and it'll work when combined with the --app and --team flags.
• We've fixed the --app flag to use the specified app and it'll work when combined with the --team flag.
• We've disabled app manifest caching and overwrite protection for Deno Slack SDK apps that run on Slack because it's not required.
• We've fixed a bug to support large manifest files by allowing the hooks to parse multi-line boundaries.
• We've fixed a bug to prevent creating a new app that would overwrite an existing app for a specified team.
• We've fixed a bug to show an app's team name and team ID, when the app's auth is missing.
• We've fixed a bug to reset terminal text formatting after prompts, which conflicts with tools such as Python virtual environments.
• We've improved the performance of resolving the authentication for local, dev apps by reducing the reading of your credentials file.

Version 3.0.0 of the developer tools for the Slack automations platform is here, with lots of goodies for you!

• We renamed the slack.json file to .slack/hooks.json, and continue to support slack.json for existing projects. There is now a warning shown in --verbose output to encourage projects to migrate their slack.json to .slack/hooks.json.
• We've removed the invalid_app_directory error from any commands run in nested project directories, and now search for the required slack.json file in the project's configuration. We also now also check for this file at .slack/hooks.json.
• We now cache the last known manifest export; the cache is used to avoid overwriting changes on app settings. If the manifest is changed on app settings since the last update, a confirmation prompt will appear before making another update via the Slack CLI.
• We've moved the top-level commands you know and love, slack create and slack samples, to be sub-commands of the slack project command (they remain aliased as top-level commands though, so there is no change to the user experience).
• We've updated the slack doctor command to display the manifest.source value, which will be either local or remote.
• We now officially support Bolt for JavaScript and Bolt for Python in the Slack CLI! 🎉
• As such, we've updated the slack create command with a new create journey that allows you to choose between different types of apps for Bolt for JavaScript, Bolt for Python, and Deno.
• We've also added the slack init command, which will initialize an existing Bolt for JavaScript, Bolt for Python, or Deno project with Slack CLI support.
• We fixed a bug to avoid confusion with regular outputs, and now prefix all separate debug logs with a timestamp.
• We fixed a bug to avoid spinning the spinner when outputting with debug logs, or if styles are removed with the --no-color flag.
• We fixed a bug to now display uninstalled apps in selections when using the slack collaborators and slack manifest commands.
• We fixed a bug with confirming trusted templates that are from a Slack GitHub organization.
• We fixed a bug regarding writing console outputs to activity logs during local runs.
• We fixed a bug where the Slack CLI would get stuck if one of the goroutines of the slack run command encountered an error; we now exit the slack run command if this happens.

We previously mentioned that we had deprecated the deno command and removed its listing from the help command. We have now removed the deno command completely. Developers who were depending on this command should now use the deno executable directly.

We've also removed support for the deprecated, pre-release Deno Slack SDK versions that used slack.yaml and project.ts files. The Run-on-Slack platform no longer supports the slack.yaml file format, and no production projects should be affected. The project.ts file was deprecated by the Deno Slack SDK in favor of manifest.ts and manifest.json files.

Version 2.33.0 of the developer tools for the Slack automations platform will be your valentine!

• We now support running CLI commands in project sub-directories.
• We've enhanced the script and outputs of hooks to improve debugging.
• We've fixed a bug to properly output error messages that may occur when the slack manifest command is run.
• We've fixed a bug to distinguish between Slack CLI names if your Slack CLI is named something other than slack.

Version 2.32.1 of the developer tools for the Slack automations platform has arrived!

• In the Deno Slack Hooks 1.3.2 release, we've improved the bundling used for the slack deploy command to address some issued encountered with npm imports.

• We fixed a bug to skip the hosted app pre-run check when the --force flag is used.

Version 2.32.0 of the developer tools for the Slack automations platform is here!

• We improved detection of Deno projects and added test coverage to the Deno runtime for a smoother experience.
• We improved the formatting of output when running slack env commands. We also added error messaging to these commands when the app being referenced is not an app created using the Deno Slack SDK.
• The slack env remove command now exits without erroring when there are no environment variables to remove.
• We enhanced text styling for easier reading.
• We improved some internal processes that allow us to keep our documentation fresh and up-to-date.
• We improved the error messaging of our slack datastore commands.
• We updated our documentation and errors displayed when using slack external-auth subcommands with Bolt apps.
• We now raise errors that may impact the validation of selected authentications.
• We now hide blank source errors that may have caused confusion; they have been replaced with more helpful messaging.

Version 2.31.0 of the developer tools for the Slack automations platform has landed!

We fixed a bug that would display errors when the slack run command was interrupted during app selection. The fix also includes an org_grant_exists error, which is raised if an attempt is made to grant installation permission to another workspace when your app has already been granted one.

Boo! Version 2.30.1 of the developer tools for the Slack automations platform has sneaked up behind you.

We fixed a bug such that expired tokens will now be removed from your local credentials, and the token_expired error will be logged when debugging if returned when using the slack logout command. No tricks, only treats!

Version 2.30.0 of the developer tools for the Slack automations platform has spookily appeared!

• We added some behind the scenes CLI support for Agents & AI Apps.
• We fixed a bug such that app manifest validation when running slack deploy now respects use of the --force flag. We also fixed a few other bugs related to app manifest validation to make things run more smoothly.
• We fixed a bug such that running the slack create command will use either the absolute or relative path provided when creating your app.

Version 2.29.2 of the developer tools for the Slack automations platform is hot off the press!

• When logging into a project directory using the slack login command, the Slack CLI will now suggest also running the slack app list command. When logging in outside of a project directory, the Slack CLI will continue to suggest running the slack create command to create a new project.
• We've fixed some bugs behind the curtain and added some CI/CD improvements.

Version 2.29.1 of the developer tools for the Slack automations platform has arrived!

• We updated the shell called in Windows commands from pwsh to powershell for better backwards compatibility.
• We added the ability to retrieve manifest information using the --source flag with the manifest info command. The flag can be set to either project or remote.
• We fixed an issue to raise any errors in the Slack CLI that may occur when running the npm install command.
• We fixed a bug to replace the --workspace flag recommendation with a --team flag recommendation.

Version 2.28.0 of the developer tools for the Slack automations platform has landed!

We made a few updates behind the scenes to keep things running smoothly.

Version 2.27.1 of the developer tools for the Slack automations platform has made a splash!

• We've fixed a bug to allow development hosts to start up faster.
• We now print a warning if either the SLACK_APP_TOKEN or the SLACK_BOT_TOKEN does not match its installed value.

Version 2.26.0 of the developer tools for the Slack automations platform is here!

• We now format warnings into text sections, and group similar warnings by source—this should help to reduce the number of warnings related to external teams that could appear when running your app.
• We've fixed an issue with the datastore count Slack CLI command by adding a default for an empty query expression if one isn't provided.

Version 2.25.0 of the developer tools for the Slack automations platform is kicking off the summer fun!

• You can now update your local project's apps.json file with app IDs for your existing apps using the slack app link command. Refer to app commands for more details.
• We've updated the formatting for section text and trace prints for the slack collaborator add, slack collaborator list, and slack collaborator remove commands.
• We've updated the debug log output when installing dependencies using the slack create command. We also now suggest installing project dependencies if an error occurs when running this command.
• We fixed a bug to avoid formatting printed strings if the string to be printed has no arguments.
• We now set authentication configurations such as custom API hosts for selected tokens with the slack manifest validate command.
• Starting June 11, 2024, we are enforcing admin restrictions on built-in steps and webhook triggers in coded workflows. This update aims to align the security settings of coded workflows with those of connector steps and triggers. Read on to learn more.

Version 2.24.0 of the developer tools for the Slack automations platform has landed!

• We've renamed the function distribute command to function access (however, the distribute subcommand has been added as an alias so you can still use function distribute). Refer to custom function access for more details.

• We've fixed several bugs that address some messaging, formatting, and emoji in the CLI for easier reading.

Version 2.23.0 of the developer tools for the Slack automations platform is here!

• We now prompt you to log in again if your auth is expired or invalid. This applies to all commands where you need to select an app.
• We now automatically set the SLACK_API_URL environment variable to the preferred API host used in the auth process.
• We fixed some bugs to reduce the chances of returning errors when checking the operating system, project configs, project tooling, and project dependencies when running the slack doctor command.
• We now display a more informative message when you attempt to delete or uninstall an app from a project that has no apps.

Version 2.22.0 of the developer tools for the Slack automations platform is here!

• We fixed a bug to prevent project paths including spaces from being separated into multiple arguments when deploying an app.
• We now cease defaulting to the deno runtime, and log unsupported runtimes.
• We fixed a bug that was causing a team_access_not_granted error when redeploying an app.
• We fixed a bug to handle an empty outgoing_domains attribute within an app's manifest.
• We fixed a bug to remove extra spaces from error messages when creating a new project using slack create.

Version 2.21.0 of the developer tools for the Slack automations platform has sprung!

• You can now display runtime versions for your application's execution environment using the doctor hook. To enjoy the improved slack doctor command experience, existing Deno Slack SDK-based apps must have their deno-slack-hooks dependency upgraded to the latest version (v1.3.0).
• By relying only on the get-manifest hook when attempting to get a manifest rather than checking for a slack.yaml file, we now surface any errors that are returned when getting the manifest.
• We removed the possibility of an error when generating the message boundary hook protocol, and now preserve spacing in logged outputs.
• We corrected a few typos behind the scenes.

Versions 2.20.0 and 2.20.1 of the developer tools for the Slack automations platform have landed!

• We've added a new feature for counting datastore items. Refer to Counting items in a datastore for more details.
• We added a new feature to query named datastores from a flag instead of an expression. For example, instead of:

$ slack datastore get '{"datastore": "todos", "id": "42"}'

use:

$ slack datastore get --datastore tasks '{"id": "42"}'

• We now include a remediation message for the not_authed error that explains how to log in and authorize the Slack CLI.
• Users can now request app approval at the workspace level in an Enterprise organization.
• We now include the error code in event payloads to logstash.
• We fixed a bug to output a link if opening the URL in a browser fails.
• We fixed a bug to catch missing hooks from a command; the initialization error is now included in the debug outputs. This allows any command to be run from a project directory without immediately posting an error.
• We fixed a bug to remove ANSI escape sequences from the debug log outputs for an improved grepping experience.
• We fixed a bug to verify that deprecated flags are properly substituted.
• We fixed an issue to make our releases run more smoothly. Nothing to see here!

Version 2.19.0 of the developer tools for the Slack automations platform has joined the stage!

• We've added a new Time To Live (TTL) feature to datastores! Refer to Delete items automatically for more details.
• We fixed an issue so that any GetHooks errors display properly.

Version 2.18.0 of the developer tools for the Slack automations platform has joined the party!

• The minimum supported PowerShell version as of this release is v6.0. If you attempt to use an older version of PowerShell, you may encounter errors reading the Slack Configuration file (slack.json) or running the get hooks hook.
• We've added the ability to put, get, and delete items in bulk in a datastore. Refer to Create or replace items with put and bulkPut, Retrieve items with get and bulkGet, and Delete items with delete and bulkDelete, respectively.
• We've added the ability to import to and export from datastores. Refer to Datastore commands for more details.
• We've added a warning when creating an app from a sample app when the sample app may not have come from a trusted source.
• You can disable this warning temporarily by running the slack create command with the --force flag.
• You can disable this warning permanently by either selecting don't ask again when prompted, or by setting the trust_unknown_sources property in your config.json file.
• We've fixed an issue so can now use CTRL-C to unhide your cursor when a spinner displays after running slack deploy.
• We've enhanced some error messages and we've improved highlighting matching for help commands.

Version 2.17.1 of the developer tools for the Slack automations platform is hot off the press!

• We added an enhancement to provide the SLACK_APP_TOKEN and SLACK_BOT_TOKEN environment variables when you run your app.
• We now install development dependencies for apps on the Node.js runtime when creating a new app to ensure @slack/cli-hooks is installed.
• We've fixed an issue by formatting paths with OS-specific dividers in the slack create command.

Version 2.17.0 of the developer tools for the Slack automations platform has landed!

We've improved how the CLI gathers environment variables.

New year, new version (2.16.0) of the developer tools for the Slack automations platform!

We now display the workflow name for errors returned in the CLI, and return an error if credentials aren't found for a selected app when using the slack app command.

Version 2.15.0 of the developer tools for the Slack automations platform is home for the holidays!

• We've updated the choose a workspace to grant access prompt to sort by team name rather than team ID.
• We've deprecated the deno command and removed its listing from the help command. The deno command is slated to be removed completely in an upcoming release.
• Endpoints at api.slack.com are no longer blocked by a permission error for local apps.
• We now have better error handling when appending a (local) tag to the display name of local apps.
• We've removed some extra blank lines and debug information from command outputs for a cleaner look and faster feel.
• We've provided prompts for possible trigger IDs for trigger commands that need them.

Version 2.14.0 of the developer tools for the Slack automations platform is here!

• We've updated the CLI to prompt you to request admin approval for an Admin-Approved App using a connector function that is not currently approved for use in your workspace. For more information, refer to Platform permissions control for admins.
• We've formatted the system and project configs with indents to make editing easier.
• We've added a SLACK_CONFIG_DIR environment variable to the --config-dir global flag.
• The uninstall command is now available from the list displayed when using the --help flag.

Version 2.13.0 of the developer tools for the Slack automations platform has landed!

• We've added an --all-org-workspace-grants flag to the app list command so you can display all grants instead of only the first three.
• We've combined workspace and org language into team; as such, we have added a --team flag and deprecated the --workspace flag. Note that this will not affect the usage of workspace or org when it is necessary to distinguish between them; for example, with the hermes auth list and trigger access commands.
• We removed the redirect to the delete command when running the uninstall command, so you may now only uninstall an app rather than deleting the app entirely along with all of its data.
• We've updated the CLI installer to align the Deno runtime version with the current version supported by the Slack platform.
• We've updated all deno-reverse-string sample app references to use deno-started-template instead.
• We fixed a bug to create a usr/local/bin directory if it is missing when installing the CLI.
• We updated some confusing language related to breaking changes.
• We fixed a bug that caused an error when any property setting flags were provided along with the --trigger-def flag.
• We fixed a bug where descriptions and selected template URLs might be mismatched from the displayed list of samples.

Hot on the heels of last week's release, version 2.12.0 of the developer tools for the Slack automations platform is here!

• We now support npm dependencies in a beta capacity, so you can use the npm: specifier when importing modules for both locally run and deployed apps. For more details about using npm: and node: specifiers, refer to Node.js APIs and npm packages.
• We updated the slack app list command to display Enterprise grants for multiple workspaces.
• We fixed a bug that displayed app manifest warnings when there were none.

Version 2.11.0 of the developer tools for the Slack automations platform has spookily appeared!

• We've updated commands requiring validation (e.g. manifest, deploy, install, triggers create, and triggers run) to catch errors if a connector is not installed, attempt to install any certified apps related to connectors mentioned in the manifest, and then re-validate the manifest.
• We added new error codes for connectors to aid you in troubleshooting.
• We added a --file flag to the function distribute command (renamed to function access) so that you can manage access and distributions with a configuration file instead of multiple commands.

Version 2.10.0 of the developer tools for the Slack automations platform has entered the chat! We've updated the deploy command to prompt you to select an organization workspace, similar to the run command. We also added a little more polish to the Admin-Approved Apps flow, added support for the apps.certified.install method (coming soon to an API near you!), and implemented a few bug fixes behind the scenes to keep things running smoothly.

Version 2.9.1 of the developer tools for the Slack automations platform is here! We now order functions by callback ID for easier sorting when you call the function distribute command (renamed to function access). We've also formatted and streamlined the install script and some of our error descriptions for a smoother, more pleasant experience.

Starting September 19, 2023 the Slack API's minimum required CLI version is changing from v1.18.0 to v2.9.0 for Enterprise orgs (for non-Enterprise orgs, the minimum required version is v1.18.0). If you attempt to log in with an older version, you'll receive a cli_update_required error from the Slack API. Run slack upgrade to get the latest version. Refer to the quickstart guide for more details.

Version 2.9.0 of the developer tools for the Slack automations platform has landed!

• We now support Slack's new look & feel.
• You can now specify which workspace within an Enterprise organization to grant your app access to when you deploy and install your app by using the --org-workspace-grant flag.
• Sometimes additional admin approval is needed before your app can be installed. We now notify you that pending app approval/denial notifications will come from Slackbot.
• We added more workflow events to the CLI for improved troubleshooting.
• We updated the output of our --info flag for a more streamlined experience.
• You can now skip the workspace selection dialog when you supply an app ID via --app and an active token via --token flags.

Version 2.8.0 of the developer tools for the Slack automations platform has arrived!

• We've improved Deno dependency caching.
• The app list command no longer requires authentication, and will instead display an unknown app status in cases where no authentication is found.
• The run, deploy, and delete commands will now resolve organization-level authentication in cases where workspace-level authentication is missing.

Version 2.7.0 of the developer tools for the Slack automations platform has arrived!

• We've added a slack trigger list --type=<string> flag to only list triggers of a specific type: For example, slack trigger list --type=shortcut. We've also supported flag values for --type=<string> are all, shortcut, event, webhook, scheduled, and external.
• We've added flags to provide values for many interactive prompts. Learn more about the flags available by adding --help to any command. For example, slack external-auth add-secret --provider github --secret my-secret-value.
• We've updated the slack app list command to improve displaying apps you are not authenticated to access. For example, local apps now display a (local) label and install status is now shown as Status: Unknown.
• We removed an incorrect timestamp found in the Slack debug log file.
• The Deno Slack SDK v2.2.0 now displays an error in your editor when you accidentally register duplicate primary keys for workflow, function, datastore, customType, event or provider. This helps prevent unexpected behavior at runtime.

Version 2.6.0 of the developer tools for the Slack automations platform has arrived!

• The .github directory will no longer be included in new projects created from one of our sample apps.
• The slack app list command now returns Status: Installed instead of Status: Unknown for an installed app.
• When using the CLI in a non-interactive environment, such as in a CI pipeline, selection prompts will error and suggest a flag alternative to use instead of hanging indefinitely.
• Trigger generation prompts will be automatically skipped when using slack run or slack deploy in a non-interactive environment, regardless of how many triggers might exist.
• We've clarified admin approval requirements when installing to a workspace that has Admin-Approved Apps enabled.
• Socket connections are now gracefully closed when ending a slack run session.
• Improved typeahead suggestions for the type field of functions and datastores were made in the Deno Slack SDK.

Version 2.5.1 fixes a bug to now properly delete the selected app when uninstalling it from a workspace.

Version 2.5.0 of the developer tools for the Slack automations platform is hot off the press!

• We've added a confirmation message if you decide not to delete an app when using the slack app delete command.
• We added a --hide-triggers flag to the slack run and slack deploy commands to prevent retrieving and displaying application triggers.
• We added a warning to listed trigger info that Slack Connect channels do not support event triggers.
• We added app collaborators to listed trigger info.
• We added support to limit paginated results with the trigger list --limit <n> command.
• We added a prompt for whether you would like to include/exclude app collaborators into the named entities list if you set your trigger's ACL to named_entities. The include-app-collaborators flag will allow you to skip this prompt.
• We updated the slack activity command to support datastore event and error logs. For more information, refer to logging.
• When the --token flag is set, background checks for updates will now be automatically disabled.
• We added support to fall back to a curl install of deno if deno upgrade should fail.
• The slack logout command now accepts the --workspace flag.
• We removed the --show-triggers flag from the slack run command, as the command now displays all of your app's triggers and their types.

Beginning June 28, 2023, version v1.17.0 and below of the CLI is deprecated. We recommend reinstalling the CLI to get the latest version. Learn more.

Version 2.4.0 of the developer tools for the Slack automations platform is now available!

• We updated the Linux/macOS installation script to support a CLI version param, -v.
• We added a -d flag to bypass Deno installation in the Linux/macOS installation script.
• We updated the Windows installation script to include Alias, Version, SkipDeno, and SkipGit flags.
• We now suggest Windows users open a new terminal after installation to add the Slack CLI to the user's environment PATH.
• We bumped minimum required Deno version to 1.31.1.
• We replaced the workspace command with a new app command.
• We made the config-dir global flag visible.
• We deprecated auth login's auth flag in favor of token.
• We updated app list command to display installation status.

Version 2.3.0 of the developer tools for the Slack automations platform has arrived!

• The external-auth remove command now allows you to select a token for deletion.
• The new external-auth select-auth command allows you to select a unique auth for each of the workflows in an app. This command is mandatory when using new coded workflows that have a step containing credentialSource DEVELOPER; that is, every time a coded workflow is created, this command must be called after the external-auth add command.
• The slack auth token and slack auth revoke commands allow you to manage service tokens.
• The slack auth token command allows you to get the slackauthticket and copy and paste it into your workspace to exchange for the service token. The service token will not be saved to your credentials.json file; instead, it is presented in the prompt for you to copy and paste to your CI/CD pipelines. Once you obtained a service token, you can use the slack login --auth <your-service-token> command to authorize your Slack CLI. The service token will not conflict with your regular authentication token; you can continue using your regular authentication token within the Slack CLI while using the service token for your CI/CD pipelines.
• The new global --token <token> flag allows you to pass the service token used by requests requiring authentication. For example, to install an app, use: slack install --token <your-service-token>. To create a trigger, use: slack trigger create --token <your-service-token> --app deployed --trigger-def triggers/trigger_def_file.ts. To deploy an app, use: slack deploy --token <your-service-token>
• We added support for a global --experiment [name,name,...] flag.

Version 2.2.0 of the developer tools for our beta Slack platform has landed!

• The trigger info command now also shows who has permissions to run the trigger.
• We added the --no-color flag, which removes all ANSI sequences for color as well as emojis, giving you plain text output from the CLI that's perfect for piping to a text file.
• The datastore query command now supports a cursor argument to help you paginate your results the way you want.
• Trigger operations will now let you know when an invalid trigger file is being ignored.
• We improved error reporting and some help text.

Today we're announcing that the Slack automations platform—which provides a faster, more flexible way to build automations on top of Slack–is generally available to developers. The platform's overhauled architecture gives developers more ways to build, code, and ship custom apps and workflows more quickly and easily in an environment that's both secure and compliant. Read the announcement or follow the Quickstart to get started today.

We released version v2.1.0 of the developer tools for our Slack platform beta. Changes include better error messages, including the local Git version with the slack doctor command, paring down which commands are visible with slack help to only what is applicable for developers, and more.

We released version v1.21.0 of the developer tools for our Slack platform beta. Changes include improved ergonomics around trigger access management and added a new command to export form responses to CSV, both within the CLI, updates to the default manifest, and more.

We released v1.20.0 of the developer tools for our Slack platform beta. Changes include a number of user-requested improvements to the CLI and details about an upcoming maintenance window next month, and breaking changes landing the month after that, which may require you to update your apps.

We released version v1.19.0 of the developer tools for our Slack platform beta.

We released version v1.18.0 of the developer tools for our Slack platform beta. View our new curated collection of sample apps for inspiration and illustration.