AgentAPI

Caution

We do not recommend using this module directly. Instead, please consider using one of our Tasks-compatible AI agent modules.

The AgentAPI module is a building block for modules that need to run an AgentAPI server. It is intended primarily for internal use by Coder to create modules compatible with Tasks.

module "agentapi" {
  source  = "registry.coder.com/coder/agentapi/coder"
  version = "2.1.0"

  agent_id             = var.agent_id
  web_app_slug         = local.app_slug
  web_app_order        = var.order
  web_app_group        = var.group
  web_app_icon         = var.icon
  web_app_display_name = "Goose"
  cli_app_slug         = "goose-cli"
  cli_app_display_name = "Goose CLI"
  module_dir_name      = local.module_dir_name
  agentapi_server_type = "claude"
  install_agentapi     = var.install_agentapi
  pre_install_script   = var.pre_install_script
  post_install_script  = var.post_install_script
  start_script         = local.start_script
  install_script       = <<-EOT
    #!/bin/bash
    set -o errexit
    set -o pipefail

    echo -n '${base64encode(local.install_script)}' | base64 -d > /tmp/install.sh
    chmod +x /tmp/install.sh

    ARG_PROVIDER='${var.goose_provider}' \
    ARG_MODEL='${var.goose_model}' \
    ARG_GOOSE_CONFIG="$(echo -n '${base64encode(local.combined_extensions)}' | base64 -d)" \
    ARG_INSTALL='${var.install_goose}' \
    ARG_GOOSE_VERSION='${var.goose_version}' \
    /tmp/install.sh
  EOT
}

Task log snapshot

Captures the last 10 messages from AgentAPI when a task workspace stops. This allows viewing conversation history while the task is paused.

To enable for task workspaces:

module "agentapi" {
  # ... other config
  task_log_snapshot = true # default: true
}

AgentAPI server configuration

You can configure the AgentAPI server type, terminal dimensions, and initial prompt:

module "agentapi" {
  # ... other config
  agentapi_server_type    = "claude"                        # required
  agentapi_term_width     = 67                              # default: 67
  agentapi_term_height    = 1190                            # default: 1190
  agentapi_initial_prompt = "You are a helpful assistant."  # optional
}

Note: The agentapi_initial_prompt is recommended only if the agent doesn't support initial prompt in interaction mode.

For module developers

For a complete example of how to use this module, see the Goose module.

Start script behavior

The start_script should write the agent command to $module_path/agent-command.sh instead of starting the AgentAPI server directly. The module will start the server using:

agentapi server --type <type> --term-width <width> --term-height <height> -- ./agent-command.sh

Example start script:

#!/bin/bash
module_path=${1:-"$HOME/.my-module"}

cat > "$module_path/agent-command.sh" << 'EOF'
#!/bin/bash
exec my-agent-command
EOF

chmod +x "$module_path/agent-command.sh"

3.2 KiB Raw Blame History

AgentAPI

Task log snapshot

AgentAPI server configuration

For module developers

Start script behavior

3.2 KiB

Raw Blame History