Coding Agents Connector

The Coding Agents connector integrates Agentcy with sandboxed coding agents. It provides 4 live tools to spawn, manage, and interact with isolated coding environments powered by Claude Code, Codex, Gemini, or Cursor.

Authentication

The Coding Agents connector connects to a Coding Agents server instance using a server URL and API key.

{
  "name": "Coding Agents",
  "source_type": "ciab",
  "config": {
    "server_url": "https://coding-agents.example.com",
    "api_key": "ciab-key-...",
    "default_agent": "claude-code",
    "timeout_secs": 30
  }
}

Variable	Required	Description
server_url	Yes	Coding Agents server URL
api_key	Yes	Coding Agents API key
default_agent	No	Default coding agent: claude-code, codex, gemini, cursor
default_model	No	Default model for the selected agent
timeout_secs	No	Request timeout in seconds (default: 30)

Live Tools (4)

Tool	Description	Arguments
ciab_spawn_agent	Spawn a new sandboxed coding agent	agent?, model?, repo_url?, branch?
ciab_assign_task	Assign a coding task to a running agent	session_id, task, files?
ciab_exec_command	Execute a shell command in the agent's sandbox	session_id, command
ciab_terminate	Terminate a running agent session	session_id

Example: Agent Using Coding Agents Tools

User: "Spin up a coding agent to fix the login bug in our repo"

Agent: I'll spawn a sandboxed coding agent.
→ Calls ciab_spawn_agent(agent: "claude-code", repo_url: "https://github.com/org/app.git", branch: "main")
→ Returns session_id: "sess-abc123"
→ Calls ciab_assign_task(session_id: "sess-abc123", task: "Fix the login bug where users get a 401 after password reset. Check auth/login.ts and auth/middleware.ts")
→ Returns: "Task assigned. Agent is analyzing the codebase..."

User: "Check if the tests pass now"

Agent: I'll run the tests in the sandbox.
→ Calls ciab_exec_command(session_id: "sess-abc123", command: "npm test -- --filter auth")
→ Returns test output with pass/fail results

ETL Ingestion

This connector does not support ETL ingestion. All tools operate as live interactions with sandboxed coding environments.

Configuration Reference

{
  "name": "Coding Agents",
  "source_type": "ciab",
  "config": {
    "server_url": "https://coding-agents.example.com",
    "api_key": "ciab-key-...",
    "default_agent": "claude-code",
    "default_model": "claude-sonnet-4-20250514",
    "timeout_secs": 30
  }
}

Field	Type	Default	Description
server_url	string	required	Coding Agents server URL
api_key	string	required	Coding Agents API key
default_agent	string	claude-code	Default coding agent to spawn
default_model	string	--	Default model for the agent
timeout_secs	number	30	Request timeout in seconds

Proxy CLI

Inside CIAB sandboxes, the Proxy CLI provides the agent with direct access to the Agentcy knowledge graph and file storage. It is the primary communication channel between sandboxed coding agents and the Agentcy platform — see the pipeline agent use case for a full walkthrough.

Troubleshooting

Error	Cause	Fix
Connection refused	Coding Agents server is unreachable	Verify server_url and network connectivity
401 Unauthorized	Invalid API key	Check the API key in Coding Agents server settings
Session not found	Agent session expired or was terminated	Spawn a new agent with ciab_spawn_agent
Agent spawn timeout	Server took too long to provision the sandbox	Increase timeout_secs or check server load
Unsupported agent	Requested agent type is not available on the server	Check available agents on your Coding Agents instance