Process Adapter

The process adapter runs any shell command per Heartbeat and streams its stdout back to SLAW.

Type key: process

note

The process adapter is an infrastructure adapter intended for internal use and custom scripting. For AI coding agents, use claude_local, codex_local, gemini_local, cursor, or opencode_local instead.

Configuration

Config fields

Field	Type	Default	Description
command	string	required	Command to execute
args	string[] or string	—	Command arguments
cwd	string	—	Absolute working directory
env	object	—	Environment variables injected into the process
timeoutSec	number	0	Run timeout in seconds; 0 means no timeout
graceSec	number	15	SIGTERM grace period before SIGKILL

Example

{
  "adapterType": "process",
  "adapterConfig": {
    "command": "/usr/local/bin/my-agent",
    "args": ["--run"],
    "cwd": "/home/agent/workspace",
    "timeoutSec": 300,
    "graceSec": 15
  }
}

Notes

• SLAW injects standard SLAW_* environment variables (SLAW_AGENT_ID, SLAW_SQUAD_ID, etc.) into every process run regardless of the env config.
• The process adapter does not manage sessions — each Heartbeat starts a fresh invocation.

Next steps

• Adapters Overview
• HTTP Adapter
• Creating an Adapter