Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

ACP: let clients select the session agent

Open
#4,475 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
go
Domain
api, backend

Research direction

Start with the ACP handlers for session/new, session/load, session/resume, and session/set_config_option, then trace the existing agent-switch path and how model and safety selections are persisted. Done means clients can discover and select a team agent across those session operations, with the selection retained on load/resume; the optional docker agent serve acp flag is a separate consideration.

Written by the indexing model from the issue text.

Description

area/acp area/sessions
Overview

ACP sessions always start with the default agent (root, or the first agent). Please let clients pick the agent, e.g. via an agent config option next to mode, model, and thought_level from #4445.

Motivation

Today the only ways to reach another agent over ACP are agent-switch commands (#4391), one per target agent, or a separate config file per entry agent. Neither shows the agents in the client UI, and a command switch is lost on cold session/load/session/resume.

Proposed solution
  • Advertise an agent select option (team agents with their descriptions) in session/new/load/resume.
  • Handle it in session/set_config_option via the agent-switch code path, and persist it like the model and safety selections.
  • Optionally, add --agent <name> to docker agent serve acp.
Related issues

#4445, #4391, #2576

docker-agent v1.144.0.

Dominant language
Go
Stars
3.4k
Forks
466
Avg merge
7h 1m
Merged PRs (30d)
332

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from docker/docker-agent

All issues in docker/docker-agent

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.