Skip to main content

​
How does it look like?

Example of octomind cli tool, 08/2025

Example of octomind cli tool, 08/2025

​
Installation

  1. To install the package globally do NOT just a npm i -g @octomind/octomind but instead
mkdir -p ~/.local/packages
cd ~/.local/packages
npm install @octomind/octomind@latest
# either create an alias
alias octomind="node ~/.local/packages/node_modules/@octomind/octomind/dist/index.js"
# or create a symlink
sudo ln -s ~/.local/packages/node_modules/@octomind/octomind/dist/index.js /usr/local/bin/octomind
this will install the package to ~/.local/packages and create symlinks in /usr/local/bin or creates an alias. This is necessary for the cli to work and avoid dependency conflicts, when installing the package globally.
  1. Use the cli through npx e.g. npx @octomind/octomind -h

​
Initializing the CLI

After installing the CLI, you need to initialize it by setting up your API key and optionally a test target ID. This configuration allows you to avoid passing these parameters for subsequent commands. 
octomind init \
  [--api-key <key>] \
  [--test-target-id <id>] \
  [--force]

​
Options

  • -k, --api-key: Your Octomind API key (will prompt if not provided)
  • -t, --test-target-id: Test target ID (optional)
  • -f, --force: Force overwrite existing configuration

​
Getting Your API Key

The option to create your API key can be found within the settings menu.
Account settings menu icon

Account settings menu icon, 5/2025

Click on Create an API key.
Link to create an API key in the Octomind app

Create an API key button, 05/2025

You then will be navigated to our auth provider where you can create a new organization-level API key.
Create a new Octomind API key in the settings

Create a new Octomind API key in the settings, 05/2025

Copy the Octomind API key

Copy the Octomind API key

You can only copy the API key once, so make sure to do that now. You should not share it with anyone.
Add the API key to your CI provider as a secret to run test reports from the CI.

​
Example

# Initialize with API key
octomind init --api-key your-api-key-here

# Initialize with API key and test target ID
octomind init --api-key your-api-key-here --test-target-id your-test-target-id

# Force overwrite existing configuration
octomind init --force
Once initialized, you can use other CLI commands without having to specify your API key or test target ID with each command.

​
Autocompletion

On macOS and linux you can enable autocompletion by running the following command (works for bash, zsh & fish): 
npx @octomind/octomind install-completion
You can disable autocompletion by running the following command: 
npx @octomind/octomind uninstall-completion
Autocompletion will only work if you have installed the package globally and created a config file with npx @octomind/octomind init. This way even entityIds like environmentIds or testCaseIds will be autocompleted.

​
Source

The source code for the CLI is available on GitHub .