KosmoKrator

productivity

Semaphore CI CLI for AI Agents

Use the Semaphore CI CLI from KosmoKrator to call Semaphore CI tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Semaphore CI CLI Setup

Semaphore CI can be configured headlessly with `kosmokrator integrations:configure semaphore-ci`.

Install, configure, and verify
# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure semaphore-ci --set url="$SEMAPHORE_CI_URL" --set api_token="$SEMAPHORE_CI_API_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor semaphore-ci --json
kosmokrator integrations:status --json

Credentials

Authentication type: API token api_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

KeyEnv varTypeRequiredLabel
url SEMAPHORE_CI_URL Text text yes Organization API URL
api_token SEMAPHORE_CI_API_TOKEN Secret secret yes API Token

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call
kosmo integrations:call semaphore-ci.semaphore_ci_run_workflow '{}' --json
Provider shortcut
kosmo integrations:semaphore-ci semaphore_ci_run_workflow '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands
kosmo integrations:docs semaphore-ci --json
kosmo integrations:docs semaphore-ci.semaphore_ci_run_workflow --json
kosmo integrations:schema semaphore-ci.semaphore_ci_run_workflow --json
kosmo integrations:search "Semaphore CI" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

semaphore-ci.semaphore_ci_run_workflow

Run a workflow for a project and reference.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_run_workflow '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_run_workflow '{}' --json

semaphore-ci.semaphore_ci_get_workflow

Get one workflow by id.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_workflow '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_workflow '{}' --json

semaphore-ci.semaphore_ci_list_workflows

List workflows for a project.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_workflows '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_workflows '{}' --json

semaphore-ci.semaphore_ci_rerun_workflow

Rerun a workflow with an idempotency token.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_rerun_workflow '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_rerun_workflow '{}' --json

semaphore-ci.semaphore_ci_stop_workflow

Stop a workflow.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_stop_workflow '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_stop_workflow '{}' --json

semaphore-ci.semaphore_ci_get_pipeline

Get one pipeline by id.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_pipeline '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_pipeline '{}' --json

semaphore-ci.semaphore_ci_list_pipelines

List pipelines by project or workflow id.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_pipelines '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_pipelines '{}' --json

semaphore-ci.semaphore_ci_stop_pipeline

Stop a pipeline.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_stop_pipeline '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_stop_pipeline '{}' --json

semaphore-ci.semaphore_ci_partial_rebuild_pipeline

Rebuild failed pipeline blocks.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_partial_rebuild_pipeline '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_partial_rebuild_pipeline '{}' --json

semaphore-ci.semaphore_ci_validate_yaml

Validate Semaphore pipeline YAML.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_validate_yaml '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_validate_yaml '{}' --json

semaphore-ci.semaphore_ci_list_promotions

List promotions for a pipeline.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_promotions '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_promotions '{}' --json

semaphore-ci.semaphore_ci_trigger_promotion

Trigger a pipeline promotion.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_trigger_promotion '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_trigger_promotion '{}' --json

semaphore-ci.semaphore_ci_trigger_task

Run a Semaphore task immediately.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_trigger_task '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_trigger_task '{}' --json

semaphore-ci.semaphore_ci_get_job

Get one job by id.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_job '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_job '{}' --json

semaphore-ci.semaphore_ci_stop_job

Stop one job by id.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_stop_job '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_stop_job '{}' --json

semaphore-ci.semaphore_ci_get_job_logs

Get job logs.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_job_logs '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_job_logs '{}' --json

semaphore-ci.semaphore_ci_list_agent_types

List self-hosted agent types.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_agent_types '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_agent_types '{}' --json

semaphore-ci.semaphore_ci_create_agent_type

Create a self-hosted agent type.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_create_agent_type '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_create_agent_type '{}' --json

semaphore-ci.semaphore_ci_update_agent_type

Update a self-hosted agent type.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_update_agent_type '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_update_agent_type '{}' --json

semaphore-ci.semaphore_ci_get_agent_type

Get a self-hosted agent type.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_agent_type '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_agent_type '{}' --json

semaphore-ci.semaphore_ci_delete_agent_type

Delete a self-hosted agent type.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_delete_agent_type '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_delete_agent_type '{}' --json

semaphore-ci.semaphore_ci_disable_agent_type_agents

Disable agents for an agent type.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_disable_agent_type_agents '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_disable_agent_type_agents '{}' --json

semaphore-ci.semaphore_ci_list_agents

List self-hosted agents.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_agents '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_agents '{}' --json

semaphore-ci.semaphore_ci_get_agent

Get one self-hosted agent.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_agent '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_agent '{}' --json

semaphore-ci.semaphore_ci_list_deployment_targets

List deployment targets for a project.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_deployment_targets '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_deployment_targets '{}' --json

semaphore-ci.semaphore_ci_get_deployment_target

Get one deployment target.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_deployment_target '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_deployment_target '{}' --json

semaphore-ci.semaphore_ci_create_deployment_target

Create a deployment target.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_create_deployment_target '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_create_deployment_target '{}' --json

semaphore-ci.semaphore_ci_update_deployment_target

Update a deployment target.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_update_deployment_target '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_update_deployment_target '{}' --json

semaphore-ci.semaphore_ci_delete_deployment_target

Delete a deployment target.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_delete_deployment_target '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_delete_deployment_target '{}' --json

semaphore-ci.semaphore_ci_deactivate_deployment_target

Deactivate a deployment target.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_deactivate_deployment_target '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_deactivate_deployment_target '{}' --json

semaphore-ci.semaphore_ci_activate_deployment_target

Activate a deployment target.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_activate_deployment_target '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_activate_deployment_target '{}' --json

semaphore-ci.semaphore_ci_get_deployment_history

Retrieve deployment history.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_deployment_history '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_deployment_history '{}' --json

semaphore-ci.semaphore_ci_list_artifacts

List artifacts by scope.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_list_artifacts '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_list_artifacts '{}' --json

semaphore-ci.semaphore_ci_get_artifact_signed_url

Get a signed artifact URL.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_artifact_signed_url '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_artifact_signed_url '{}' --json

semaphore-ci.semaphore_ci_configure_artifact_retention_policy

Configure artifact retention policies.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_configure_artifact_retention_policy '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_configure_artifact_retention_policy '{}' --json

semaphore-ci.semaphore_ci_get_artifact_retention_policy

Get artifact retention policy.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_get_artifact_retention_policy '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_get_artifact_retention_policy '{}' --json

semaphore-ci.semaphore_ci_api_get

Call a safe relative Semaphore GET path.

Read read
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_api_get '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_api_get '{}' --json

semaphore-ci.semaphore_ci_api_post

Call a safe relative Semaphore POST path.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_api_post '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_api_post '{}' --json

semaphore-ci.semaphore_ci_api_patch

Call a safe relative Semaphore PATCH path.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_api_patch '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_api_patch '{}' --json

semaphore-ci.semaphore_ci_api_delete

Call a safe relative Semaphore DELETE path.

Write write
Parameters
none
Generic call
kosmo integrations:call semaphore-ci.semaphore_ci_api_delete '{}' --json
Shortcut
kosmo integrations:semaphore-ci semaphore_ci_api_delete '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

semaphore-ci.semaphore_ci_run_workflow 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_run_workflow --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_workflow 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_workflow --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_workflows 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_workflows --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_rerun_workflow 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_rerun_workflow --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_stop_workflow 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_stop_workflow --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_pipeline 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_pipeline --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_pipelines 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_pipelines --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_stop_pipeline 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_stop_pipeline --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_partial_rebuild_pipeline 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_partial_rebuild_pipeline --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_validate_yaml 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_validate_yaml --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_promotions 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_promotions --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_trigger_promotion 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_trigger_promotion --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_trigger_task 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_trigger_task --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_job 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_job --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_stop_job 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_stop_job --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_job_logs 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_job_logs --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_agent_types 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_agent_types --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_create_agent_type 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_create_agent_type --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_update_agent_type 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_update_agent_type --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_agent_type 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_agent_type --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_delete_agent_type 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_delete_agent_type --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_disable_agent_type_agents 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_disable_agent_type_agents --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_agents 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_agents --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_agent 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_agent --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_deployment_targets 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_deployment_targets --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_deployment_target 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_deployment_target --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_create_deployment_target 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_create_deployment_target --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_update_deployment_target 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_update_deployment_target --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_delete_deployment_target 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_delete_deployment_target --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_deactivate_deployment_target 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_deactivate_deployment_target --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_activate_deployment_target 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_activate_deployment_target --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_deployment_history 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_deployment_history --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_list_artifacts 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_list_artifacts --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_artifact_signed_url 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_artifact_signed_url --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_configure_artifact_retention_policy 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_configure_artifact_retention_policy --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_get_artifact_retention_policy 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_get_artifact_retention_policy --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_api_get 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_api_get --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_api_post 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_api_post --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_api_patch 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_api_patch --json
ParameterTypeRequiredDescription
No parameters.
semaphore-ci.semaphore_ci_api_delete 0 parameters
Schema command
kosmo integrations:schema semaphore-ci.semaphore_ci_api_delete --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.