Agent configuration and usage

Configure agent runtimes and run agent tasks.

Prerequisites

A repository connected in Plural Console (agents can only select from configured repos).
SCM connection configured outside the agent UI (for example, via SCM integration settings).

Configure an AgentRuntime

Use AgentRuntime to define the provider, credentials, and runtime options. For field-level details, see the AgentRuntime API reference and AgentRuntimeSpec API reference.

yaml

apiVersion: deployments.plural.sh/v1alpha1
kind: AgentRuntime
metadata:
  name: claude-default
  namespace: plrl-agents
spec:
  targetNamespace: plrl-agents
  type: CLAUDE
  default: true
  aiProxy: true
  config:
    claude:
      apiKeySecretRef:
        name: ai-config
        key: anthropic
      model: claude-3-5-sonnet-latest

Supported runtime types are CLAUDE, OPENCODE, and GEMINI.

Optional: Enable codebase memory persistence

Agent runtimes include the codebase-memory-mcp server for graph-backed code search. By default, its indexes are stored only in the agent pod cache and generated .codebase-memory/ artifacts are excluded from commits.

Set spec.memory: true to enable team-shared memory persistence by default:

yaml

spec:
  memory: true