KosmoKrator

ai

Devin CLI for AI Agents

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

5 functions 3 read 2 write API key auth

Devin CLI Setup

Devin can be configured headlessly with `kosmokrator integrations:configure devin`.

# 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 devin --set api_key="$DEVIN_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor devin --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
api_key DEVIN_API_KEY Secret secret yes API Key
url DEVIN_URL URL url no Devin API URL

Call Devin Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call devin.devin_create_session '{
  "prompt": "example_prompt",
  "idempotency_key": "example_idempotency_key"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:devin devin_create_session '{
  "prompt": "example_prompt",
  "idempotency_key": "example_idempotency_key"
}' --json

Agent Discovery Commands

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

kosmo integrations:docs devin --json
kosmo integrations:docs devin.devin_create_session --json
kosmo integrations:schema devin.devin_create_session --json
kosmo integrations:search "Devin" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Devin.

devin.devin_create_session

Write write

Create a new Devin AI session. Provide a task prompt describing what you want Devin to do. Optionally provide an idempotency key to prevent duplicate sessions.

Parameters
prompt, idempotency_key

Generic CLI call

kosmo integrations:call devin.devin_create_session '{"prompt":"example_prompt","idempotency_key":"example_idempotency_key"}' --json

Provider shortcut

kosmo integrations:devin devin_create_session '{"prompt":"example_prompt","idempotency_key":"example_idempotency_key"}' --json

devin.devin_get_session

Read read

Retrieve details and current status of a Devin session. Use this to check progress on a task, view the session state, or get the output.

Parameters
session_id

Generic CLI call

kosmo integrations:call devin.devin_get_session '{"session_id":"example_session_id"}' --json

Provider shortcut

kosmo integrations:devin devin_get_session '{"session_id":"example_session_id"}' --json

devin.devin_list_sessions

Read read

List all Devin sessions. Returns an overview of all sessions including their IDs, statuses, and creation times.

Parameters
none

Generic CLI call

kosmo integrations:call devin.devin_list_sessions '{}' --json

Provider shortcut

kosmo integrations:devin devin_list_sessions '{}' --json

devin.devin_send_message

Write write

Send a message to an existing Devin session. Use this to provide additional instructions, ask questions, or guide the AI during an active session.

Parameters
session_id, message

Generic CLI call

kosmo integrations:call devin.devin_send_message '{"session_id":"example_session_id","message":"example_message"}' --json

Provider shortcut

kosmo integrations:devin devin_send_message '{"session_id":"example_session_id","message":"example_message"}' --json

devin.devin_get_current_user

Read read

Get information about the currently authenticated Devin user. Use this to verify the API connection and identify which account is being used.

Parameters
none

Generic CLI call

kosmo integrations:call devin.devin_get_current_user '{}' --json

Provider shortcut

kosmo integrations:devin devin_get_current_user '{}' --json

Function Schemas

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

devin.devin_create_session

Create a new Devin AI session. Provide a task prompt describing what you want Devin to do. Optionally provide an idempotency key to prevent duplicate sessions.

Operation
Write write
Schema command
kosmo integrations:schema devin.devin_create_session --json
ParameterTypeRequiredDescription
prompt string yes The task description for Devin to execute. Be specific about what you want accomplished.
idempotency_key string no An optional unique key to prevent duplicate session creation. If a session with this key already exists, the existing session is returned.

devin.devin_get_session

Retrieve details and current status of a Devin session. Use this to check progress on a task, view the session state, or get the output.

Operation
Read read
Schema command
kosmo integrations:schema devin.devin_get_session --json
ParameterTypeRequiredDescription
session_id string yes The ID of the Devin session to retrieve.

devin.devin_list_sessions

List all Devin sessions. Returns an overview of all sessions including their IDs, statuses, and creation times.

Operation
Read read
Schema command
kosmo integrations:schema devin.devin_list_sessions --json
ParameterTypeRequiredDescription
No parameters.

devin.devin_send_message

Send a message to an existing Devin session. Use this to provide additional instructions, ask questions, or guide the AI during an active session.

Operation
Write write
Schema command
kosmo integrations:schema devin.devin_send_message --json
ParameterTypeRequiredDescription
session_id string yes The ID of the Devin session to send the message to.
message string yes The message content to send to the session.

devin.devin_get_current_user

Get information about the currently authenticated Devin user. Use this to verify the API connection and identify which account is being used.

Operation
Read read
Schema command
kosmo integrations:schema devin.devin_get_current_user --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.