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 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.
| Key | Env var | Type | Required | Label |
|---|---|---|---|---|
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.
kosmo integrations:call semaphore-ci.semaphore_ci_run_workflow '{}' --json 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.
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 - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_run_workflow '{}' --json kosmo integrations:semaphore-ci semaphore_ci_run_workflow '{}' --json semaphore-ci.semaphore_ci_get_workflow
Get one workflow by id.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_workflow '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_workflow '{}' --json semaphore-ci.semaphore_ci_list_workflows
List workflows for a project.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_workflows '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_workflows '{}' --json semaphore-ci.semaphore_ci_rerun_workflow
Rerun a workflow with an idempotency token.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_rerun_workflow '{}' --json kosmo integrations:semaphore-ci semaphore_ci_rerun_workflow '{}' --json semaphore-ci.semaphore_ci_stop_workflow
Stop a workflow.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_stop_workflow '{}' --json kosmo integrations:semaphore-ci semaphore_ci_stop_workflow '{}' --json semaphore-ci.semaphore_ci_get_pipeline
Get one pipeline by id.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_pipeline '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_pipeline '{}' --json semaphore-ci.semaphore_ci_list_pipelines
List pipelines by project or workflow id.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_pipelines '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_pipelines '{}' --json semaphore-ci.semaphore_ci_stop_pipeline
Stop a pipeline.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_stop_pipeline '{}' --json kosmo integrations:semaphore-ci semaphore_ci_stop_pipeline '{}' --json semaphore-ci.semaphore_ci_partial_rebuild_pipeline
Rebuild failed pipeline blocks.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_partial_rebuild_pipeline '{}' --json kosmo integrations:semaphore-ci semaphore_ci_partial_rebuild_pipeline '{}' --json semaphore-ci.semaphore_ci_validate_yaml
Validate Semaphore pipeline YAML.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_validate_yaml '{}' --json kosmo integrations:semaphore-ci semaphore_ci_validate_yaml '{}' --json semaphore-ci.semaphore_ci_list_promotions
List promotions for a pipeline.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_promotions '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_promotions '{}' --json semaphore-ci.semaphore_ci_trigger_promotion
Trigger a pipeline promotion.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_trigger_promotion '{}' --json kosmo integrations:semaphore-ci semaphore_ci_trigger_promotion '{}' --json semaphore-ci.semaphore_ci_trigger_task
Run a Semaphore task immediately.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_trigger_task '{}' --json kosmo integrations:semaphore-ci semaphore_ci_trigger_task '{}' --json semaphore-ci.semaphore_ci_get_job
Get one job by id.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_job '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_job '{}' --json semaphore-ci.semaphore_ci_stop_job
Stop one job by id.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_stop_job '{}' --json kosmo integrations:semaphore-ci semaphore_ci_stop_job '{}' --json semaphore-ci.semaphore_ci_get_job_logs
Get job logs.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_job_logs '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_job_logs '{}' --json semaphore-ci.semaphore_ci_list_agent_types
List self-hosted agent types.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_agent_types '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_agent_types '{}' --json semaphore-ci.semaphore_ci_create_agent_type
Create a self-hosted agent type.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_create_agent_type '{}' --json kosmo integrations:semaphore-ci semaphore_ci_create_agent_type '{}' --json semaphore-ci.semaphore_ci_update_agent_type
Update a self-hosted agent type.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_update_agent_type '{}' --json kosmo integrations:semaphore-ci semaphore_ci_update_agent_type '{}' --json semaphore-ci.semaphore_ci_get_agent_type
Get a self-hosted agent type.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_agent_type '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_agent_type '{}' --json semaphore-ci.semaphore_ci_delete_agent_type
Delete a self-hosted agent type.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_delete_agent_type '{}' --json 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 - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_disable_agent_type_agents '{}' --json kosmo integrations:semaphore-ci semaphore_ci_disable_agent_type_agents '{}' --json semaphore-ci.semaphore_ci_list_agents
List self-hosted agents.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_agents '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_agents '{}' --json semaphore-ci.semaphore_ci_get_agent
Get one self-hosted agent.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_agent '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_agent '{}' --json semaphore-ci.semaphore_ci_list_deployment_targets
List deployment targets for a project.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_deployment_targets '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_deployment_targets '{}' --json semaphore-ci.semaphore_ci_get_deployment_target
Get one deployment target.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_deployment_target '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_deployment_target '{}' --json semaphore-ci.semaphore_ci_create_deployment_target
Create a deployment target.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_create_deployment_target '{}' --json kosmo integrations:semaphore-ci semaphore_ci_create_deployment_target '{}' --json semaphore-ci.semaphore_ci_update_deployment_target
Update a deployment target.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_update_deployment_target '{}' --json kosmo integrations:semaphore-ci semaphore_ci_update_deployment_target '{}' --json semaphore-ci.semaphore_ci_delete_deployment_target
Delete a deployment target.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_delete_deployment_target '{}' --json kosmo integrations:semaphore-ci semaphore_ci_delete_deployment_target '{}' --json semaphore-ci.semaphore_ci_deactivate_deployment_target
Deactivate a deployment target.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_deactivate_deployment_target '{}' --json kosmo integrations:semaphore-ci semaphore_ci_deactivate_deployment_target '{}' --json semaphore-ci.semaphore_ci_activate_deployment_target
Activate a deployment target.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_activate_deployment_target '{}' --json kosmo integrations:semaphore-ci semaphore_ci_activate_deployment_target '{}' --json semaphore-ci.semaphore_ci_get_deployment_history
Retrieve deployment history.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_deployment_history '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_deployment_history '{}' --json semaphore-ci.semaphore_ci_list_artifacts
List artifacts by scope.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_list_artifacts '{}' --json kosmo integrations:semaphore-ci semaphore_ci_list_artifacts '{}' --json semaphore-ci.semaphore_ci_get_artifact_signed_url
Get a signed artifact URL.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_artifact_signed_url '{}' --json kosmo integrations:semaphore-ci semaphore_ci_get_artifact_signed_url '{}' --json semaphore-ci.semaphore_ci_configure_artifact_retention_policy
Configure artifact retention policies.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_configure_artifact_retention_policy '{}' --json kosmo integrations:semaphore-ci semaphore_ci_configure_artifact_retention_policy '{}' --json semaphore-ci.semaphore_ci_get_artifact_retention_policy
Get artifact retention policy.
read - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_get_artifact_retention_policy '{}' --json 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 - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_api_get '{}' --json kosmo integrations:semaphore-ci semaphore_ci_api_get '{}' --json semaphore-ci.semaphore_ci_api_post
Call a safe relative Semaphore POST path.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_api_post '{}' --json kosmo integrations:semaphore-ci semaphore_ci_api_post '{}' --json semaphore-ci.semaphore_ci_api_patch
Call a safe relative Semaphore PATCH path.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_api_patch '{}' --json kosmo integrations:semaphore-ci semaphore_ci_api_patch '{}' --json semaphore-ci.semaphore_ci_api_delete
Call a safe relative Semaphore DELETE path.
write - Parameters
- none
kosmo integrations:call semaphore-ci.semaphore_ci_api_delete '{}' --json 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
kosmo integrations:schema semaphore-ci.semaphore_ci_run_workflow --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_workflow 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_workflow --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_workflows 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_workflows --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_rerun_workflow 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_rerun_workflow --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_stop_workflow 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_stop_workflow --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_pipeline 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_pipeline --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_pipelines 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_pipelines --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_stop_pipeline 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_stop_pipeline --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_partial_rebuild_pipeline 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_partial_rebuild_pipeline --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_validate_yaml 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_validate_yaml --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_promotions 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_promotions --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_trigger_promotion 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_trigger_promotion --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_trigger_task 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_trigger_task --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_job 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_job --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_stop_job 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_stop_job --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_job_logs 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_job_logs --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_agent_types 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_agent_types --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_create_agent_type 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_create_agent_type --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_update_agent_type 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_update_agent_type --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_agent_type 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_agent_type --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_delete_agent_type 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_delete_agent_type --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_disable_agent_type_agents 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_disable_agent_type_agents --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_agents 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_agents --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_agent 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_agent --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_deployment_targets 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_deployment_targets --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_deployment_target 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_deployment_target --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_create_deployment_target 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_create_deployment_target --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_update_deployment_target 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_update_deployment_target --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_delete_deployment_target 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_delete_deployment_target --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_deactivate_deployment_target 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_deactivate_deployment_target --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_activate_deployment_target 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_activate_deployment_target --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_deployment_history 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_deployment_history --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_list_artifacts 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_list_artifacts --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_artifact_signed_url 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_artifact_signed_url --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_configure_artifact_retention_policy 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_configure_artifact_retention_policy --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_get_artifact_retention_policy 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_get_artifact_retention_policy --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_api_get 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_api_get --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_api_post 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_api_post --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_api_patch 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_api_patch --json | Parameter | Type | Required | Description |
|---|---|---|---|
| No parameters. | |||
semaphore-ci.semaphore_ci_api_delete 0 parameters
kosmo integrations:schema semaphore-ci.semaphore_ci_api_delete --json | Parameter | Type | Required | Description |
|---|---|---|---|
| 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.