Repository navigation
feat(agents): one agent list, two kinds, one verb for every agent CLI (agents 1.0.0, claude-code 1.7.0, devcontainer-cli 1.13.0) - #84
Merged
Conversation
… (agents 1.0.0, claude-code 1.7.0, devcontainer-cli 1.13.0) agent-kind-standard, slices 2 and 3 of the decided proposal (docs/proposals/agents.md): - New Feature agents 1.0.0: reads the agent list (AGENTS_FILE, default .devcontainer/agents.yml); task agents -- <name> [--resume|--new], agents:up/list/stop/logs/check; residents attach, on-demand agents open a new session; adapters per CLI with exit 3 for "not supported" and fallbacks. - claude-code 1.7.0: agent-adapter-claude (find by name and folder, act by id, never -c); claude-host, claude-fleet and claude-host-pin print a deprecation line ahead of their removal in 2.0. - devcontainer-cli 1.13.0: devcontainer:agent and devcontainer:agent:list; devcontainer:claude and the fleet keep working, deprecated. - This repository: .devcontainer/agents.yml (host on-demand with --remote-control), the agents Feature in the devhost. - Lexicon and ontology: resident agent, on-demand agent, agent list. - docs/migrations/agents.md for consuming repositories. Co-Authored-By: Claude Opus 5.5 <claude-opus-5-5@noreply.invalid> Signed-off-by: devhost agent <devhost-agent@noreply.invalid>
Backlog and ledger since #83 (cloud-folder-feature, agent-kind-standard); cloud-folder-build reworded: slices 1 and 2 released, slice 3 remains. Co-Authored-By: Claude Opus 5.5 <claude-opus-5-5@noreply.invalid> Signed-off-by: devhost agent <devhost-agent@noreply.invalid>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The agent model (
agent-kind-standard,docs/proposals/agents.md, decided 2026-10-27): a newagentsFeature 1.0.0 that reads a per-repository agent list (AGENTS_FILE, default.devcontainer/agents.yml) and gives one verb,task agents -- <name>(--resume,--new;agents:up,agents:list,agents:stop,agents:logs,agents:check). Two kinds:resident(runs in the background, start attaches) andon-demand(start opens a new session). Each CLI ships an adapter; claude-code 1.7.0 shipsagent-adapter-claude(find by name and folder, act by id, never-c) and deprecatesclaude-host,claude-fleetandclaude-host-pinahead of 2.0. devcontainer-cli 1.13.0 addsdevcontainer:agentanddevcontainer:agent:list;devcontainer:claudeand the fleet keep working, deprecated. This repository gets.devcontainer/agents.yml(host on-demand with--remote-control) and the Feature in its devhost. Migration for consumers:docs/migrations/agents.md. Also the records since #83.Why
Session pins, the pin hook, claude-host's refusals and join wrappers (a consumer's
join.sh) were scripting around a missing concept: the agent. One list and two kinds make starting any agent the same whatever its CLI, and replace the requestedCLAUDE_HOST_JOIN.Checklist
New Feature? Follow "Adding a Feature" in CONTRIBUTING.md first (CI matrices,
test/_global, README row).Signed-off-by:, DCO) - automatic aftertask repo:setupversionbumped insrc/<id>/devcontainer-feature.json(semver): agents 1.0.0, claude-code 1.7.0, devcontainer-cli 1.13.0install.shis idempotent and does not assume aremoteUsertest/<id>/test.sh,scenarios.json) andtask test FEATURE=<id>passes: unit tests pass (agents 116, adapter 35, live-session 181, agent task 13, cloud-folder 83 + 136); the Docker scenarios have not run (no daemon in the devhost), CI is their first runtaskfile.ymlpresent and registered viainstallTaskfile(new Features)task lintpasses (in a clean worktree)NOTES.mdupdated if behaviour or options changed, andtask docsrun sosrc/<id>/README.mdis currentStill for the Operator on the workstation: whether Remote Control reaches a background session (the host becomes
residentthen) and what comes back after a rebuild.🤖 Generated with Claude Code